Configure incident rule actions

You can add one or several automatic actions to the incident rules. This page describes properties of the various actions. Find the descriptions of incident rules themselves at the Create and Configure incident rules page.

To add a new rule action, click Add, while the Actions tab is in Advanced mode.

To edit a rule action, simply double-click it, and alternate properties as needed.

The following pre-defined actions are provided by default:

You can define your own Action plugins to use as rule actions with the Plugin interface and a plugin development SDK. See Developing a User Plugin) for quick and easy development of user-defined action plugins.

Activate Configuration

Changes the active configuration of the System Profile, for example turns on Sensors in response to the incident.

Parameters

Parameter Description
config name The name of the configuration to activate.

CPU Sampling

Creates a CPU sampling snapshot for the Agent that triggered the incident. You can access it in the CPU Sampling dashlet. See Sampling Based Diagnostics for details.

Parameters

Parameter Description
rate Sampling rate for the snapshot. Takes a sample of all stacks every:
  • lowest: 1,000 milliseconds.
  • low: 500 milliseconds.
  • medium: 100 milliseconds.
  • high: 50 milliseconds.
  • highest: 10 milliseconds.
Duration of sampling Duration of the snapshot in seconds.
lock session Lock the newly created snapshot to prevent its deletion by automatic cleanup tasks. You can still delete the snapshot manually.

Email Notification

Sends notifications using AppMon email services.

Parameters

Parameter Description
From Email sender. If not specified, the Default From user of the Email settings is the sender.
To Email recipients. You can use the actual email address, or AppMon user names and user groups. In that case, AppMon sends the notification to the email address from the user account.

To specify a user, type user[username].
To specify a user group, type group[groupname].
CC Copy email recipients.
BCC Hidden copy email recipients.
Subject prefix Prefix for auto-generated subject line.

Memory Dump

Creates a memory snapshot for the Agent that triggered the incident. You can access it in the Selective Memory dashlet or Total Memory dashlet, depending on the snapshot type. See Incident based Memory Diagnostics to learn more about memory diagnostic.

Parameters

Parameter Description
dump type The type of the snapshot created:
  • simple: Trending memory snapshot.
  • selective: Selective memory snapshot.
  • extended: Leak analysis memory snapshot.
dump count How many snapshots should be created.
dump interval Wait time between two snapshots, if more than one should be created.
lock session Locks the newly created snapshot to prevent its deletion by automatic cleanup tasks. You can still delete the snapshot manually.
Force Garbage Collection Enables/disables trigger of GC before snapshot creation to reduce its size and get rid of unnecessary data.
Capture String Values Enables/disables capture of string values. It is required for Duplicate String analysis, but the sanpshot takes more time to create and requires more disk space.
Capture Primitive Values Enables/disables capture of primitive values. It provides more information, but the sanpshot takes more time to create and requires more disk space
Automatically Post-process Enables/disables automatic post-processing of newly created trending or leak analysis snapshots. To keep the overhead low, you can disable it, and start prost-processing manually in the Total Memory or Selective Memory dashlet.

SNMP

Sends notifications using SNMP to a target hosts. See Using the SNMP action plugin for more information.

Parameters

Parameter Description
Target Host The name or IP address of the target host.
Target Port The port of the target host.
Maximum Number of Message Octets Maximum allowed size of message.
SNMP Version The SNMP version to be used for messaging.
Community Community string to be used for messaging.

Store Session

Stores a PurePath session of the System Profile affected by the incident. See Usage of Sessions for details.

Parameters

Parameter Description
Minutes Past How many minutes of data before the incident to be saved.
Minutes Future How many minutes of data after the incident to be saved.
Recording Option Data to be saved:
  • all: All session data from the defined timespan, including PurePaths, and chart data.
  • violations: Only failed PurePaths and related chart data form the defined timespan.
  • timeseries: All chart data from the defined timespan.
Lock Session Locks the newly created stored session to prevent its deletion by automatic cleanup tasks. You can still delete the stored session manually.
Append timestamp Adds timestamp of the creation time to the stored session as a label.

Thread Dump

Creates a thread dump for the Agent that triggered the incident. See Thread Diagnostics for details.

Parameters

Parameter Description
dump count How many dumps should be created.
dump interval Wait time between two dumps, if more than one should be created.
lock session Locks the newly created dump to prevent its deletion by automatic cleanup tasks. You can still delete the dump manually.