This page covers monitoring for CLR crash events.

The .NET Machine Agent monitors Windows for non-graceful CLR shutdowns on IIS, Windows services, and standalone applications. The agent raises CLR crash events in the Controller when such crashes occur. Use a policy to alert responsible parties when the agent reports a CLR crash.

Monitor for CLR Crash Events

Create a policy that sends notifications when a CLR crash event occurs.

  1. Verify your Email / SMS Configuration. See Enable an Email Server.
  2. Create a notification action configured to alert the parties who respond to CLR crashes. See Notification Actions.
  3. Create a policy to trigger on CLR Crash under Other Events on the Create Policy window.  For the action, choose the notification action you created in step 2. See Configure Policies.

After you create the policy, the Controller sends a notification when the .NET Machine Agent raises CLR crash events.

Analyze and Respond to CLR Crashes

When a CLR crashes, the .NET Machine Agent raises an event in the Controller. The events page on the application dashboard displays the number of server crash events, including CLR crashes, during the selected time range.

  1. Click the Server Crashes link in the application dashboard to display a list of all server crash events during the selected time range.
  2. Optionally filter on the CLR Crash event type.

    Entries for individual CLR crashes display information about the crash event, including the process id and the Windows event log id.

    After a CLR crash, IIS automatically tries to restart the CLR, so one issue frequently causes multiple CLR crash events.

  3. Double-click a CLR Crash type event to display more information in the CLR Crash window:

Disable CLR Crash Event Reporting

The .NET Machine Agent enables CLR crash event reporting by default. Disable it as follows:

  1. Edit the agent config.xml as an administrator. See Where to Configure App Agent Properties.
  2. Set enabled="false" for the CLR Crash Reporting element. See CLR Crash Reporting Element.
  3. Restart the AppDynamics.Agent.Coordinator service.

Crash Events Monitored by the .NET Machine Agent

The .NET Machine Agent listens on the following Windows event logs for crash events:

The agent listens for events logged at event-level Warning and higher on the following sources:

The agent listens for events logged at event-level Information and higher on the following source:

The agent reports CLR crashes as events to the Controller as follows:

The Controller treats all events as Warning severity, which is not directly related to the Windows event level.