6.14 CLRExceptions

Use this Knowledge Script to monitor exceptions that managed .NET applications raise. Exceptions are errors in a program that cause it to branch to a new routine.

This script raises an event if one of the following conditions occurs:

  • The total number of .NET exceptions (or converted exceptions) that occur since the application started exceeds a specified threshold.

  • The number of .NET exceptions (or converted exceptions) that occur per second exceeds a specified threshold.

NOTE:The monitored .NET applications must be running at the time of discovery so their resource objects can discovered. The applications must also be running for this script to collect data.

6.14.1 Default Schedule

The default schedule for this script is Every 5 minutes.

6.14.2 Resource Objects

Managed Applications folder

Managed Applications object

6.14.3 Setting Parameter Values

Set the following parameters as needed:

Parameter

How to Set It

General Settings

Raise event if application not running?

Set to Yes to raise an event if the managed application is not running. The default is Yes.

Event severity when application not running

Set the event severity level, from 1 to 40, to indicate the importance of an event in which the managed application is not running. The default is 20 (yellow event indicator).

Monitor Exception Count

Event Notification

Raise event if exceptions exceed threshold?

Set to Yes to raise an event if the number of exceptions exceeds the threshold you set. The default is Yes.

Threshold - Maximum number of exceptions

Specify the maximum number of exceptions that can occur before an event is raised. The default is 5 exceptions.

Event severity when exceptions exceed threshold

Set the event severity level, from 1 to 40, to indicate the importance of an event in which the number of exceptions exceeds the threshold. The default is 15 (yellow event indicator).

Data Collection

Collect data for number of exceptions?

Set to Yes to collect data for charts and reports. When enabled, data collection returns the number of exceptions that occurred during the monitoring period. The default is unselected.

Monitor Exception Rate

Event Notification

Raise event if exception rate exceeds threshold?

Set to Yes to raise an event if the exception rate exceeds the threshold you set. The default is Yes.

Threshold - Maximum exception rate

Specify the maximum number exceptions allowed per second before an event is raised. The default is 10 exceptions per second.

Event severity when exception rate exceeds threshold

Set the event severity level, from 1 to 40, to indicate the importance of an event in which the exception rate exceeds the threshold. The default is 15 (yellow event indicator).

Data Collection

Collect data for exception rate?

Set to Yes to collect data for charts and reports. When enabled, data collection returns the exception rate during the monitoring interval. The default is unselected.