This page applies to an earlier version of the AppDynamics App IQ Platform.
For documentation on the latest version, see the 4.4 Documentation.
The AppDynamics .NET Agent includes the .NET Machine Agent that runs as part of the AppDynamics.Agent.Coordinator service. Among other things, the .NET Machine Agent regularly gathers CLR performance data and reports it back to the Controller as metrics.
CLR Events
The .NET Machine Agent monitors for CLR shutdown and restart events:
- The agent reports an App Server Restart event and indicates if the restart was graceful or not.
- For non-graceful shutdown, if the agent detects a crash, it reports a CLR Crash event.
The default exit code for a graceful shutdown is "0", if your Windows service or standalone application uses a different exit code, see "Profiler - Successful Exit Code Element" on .NET Agent Configuration Properties.
CLR Metrics
CLR metrics give insight into how the .NET runtime is performing. The AppDynamics preconfigured CLR metrics include:
- .NET CLR memory usage
- Total classes loaded and how many are currently loaded
- Garbage collection time spent, and detailed metrics about GC memory pools and caching
- Locks and thread usage
- Memory heap and non-heap usage, including the large object heap
- Percent CPU process usage
Alerting for CLR Health
You can set up health rules based on the infrastructure metrics. Once you have a health rule, you can create specific policies based on health rule violations. One type of response to a health rule violation is an alert.
In addition to the default metrics, you may be interested in additional metrics. You can specify additional performance counters to be reported by the .NET Machine Agent. See Enable Monitoring for Windows Performance Counters for details.
Once you add a custom metric you can create a health rule for it and receive alerts when conditions indicate problems.
See Alert and Respond for details on health rules and policies.