This page applies to an earlier version of the AppDynamics App IQ Platform.
For documentation on the latest version, see the 4.4 Documentation.

Skip to end of metadata
Go to start of metadata

On this page:

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 Configure the SMTP 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 pane 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.
    (info) 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:
    • The Summary tab shows the Windows process id of the w3wp process that crashed and the Windows event log id for the crash. The summary also includes the affected tier and node names.
      (info) If multiple tiers have nodes on the same machine, you may see more than one tier in the CLR Crash window.
    • The Details tab displays essential information about the crash.
    • The Actions Executed tab shows any actions the event triggers. See Monitor for CLR crash events.
    • Read and add new comments on the Comments tab. For example, add a comment to the CLR crash event  to notify colleagues that you're triaging the issue. 

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 the .NET Machine Agent Monitors

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

  • Application Log
  • System Log

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

  • Application Error
  • .NET Runtime
  • WAS (Windows Process Activation Service)

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

  • Windows Error Reporting

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

  • all w3wp process crashes
  • instrumented Windows service crashes
  • instrumented standalone applicationcrashes

(info) To monitor CLR crashes only for instrumented w3wp processes, see "Process Monitor Element" on .NET Agent Configuration Properties.

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