Reactions are applied to Events and are manifested either as Email, Restart, SNMP Trap or Custom Response (a script). Reactions are triggered when Event thresholds are exceeded. Up to two Reactions can be applied to each Event.
Go to configuration section and select “Reactions” from the Top Menu
The “Reactions” tab opens;
Customize Reaction window columns by mousing over and clicking the arrow beside any of the column headings at the top of the Reactions screen, then choosing which columns to display. By default, all columns are shown, but you can uncheck any columns you don't want to see or check columns you do want to see. You may also sort any column in ascending or descending order.
Add New Reaction
To add a new Reaction click the “Add New Reaction” button at the top of the Reactions tab;
The “Add New Reaction” form opens in a pop up window;
Reaction Type: Select the type of Reaction to be triggered when the Event's threshold is exceeded:
- SNMP Trap
- Custom Reaction (a script)
Execute on: Select the circumstances under which the Reaction is executed:
Event Start and Event End: When the Event is triggered and when the problem is fixed. For example, if the web server goes down you will receive the reaction and when the web server comes back up you will receive the reaction.
Event Start Only: When the Event is triggered. For example, if the web server goes down.
Event End Only: When the problem is fixed. For example, if the web server comes back up.
Reaction Name: This is a unique name given to the Reaction
Email Addresses: Enter addresses for desired email recipients. Separate multiple email addresses with commas.
Users: Select from the AppsWatch Users list to add their email address to this Reaction.
Subject: Type text into the subject field. This is the subject line of the Email to be sent. To insert one or more variables, select the variable from the drop down list on the right side of the Subject field. Do this for each variable you wish to add.
Variable: The following variables are available for use in Email, Restart and Custom Reactions:
ObjectAlias: Object monitored or Service alias. For example, SQLServer_master
GroupName: Object group alias. It is only populated for Nodes and Tasks type monitors. Value defined in the Node or Task form.
SystemAlias: The name of the System (Systems and SNMP monitors only).
Threshold: Value defined in Event form.
ValueWatched: The value result of the test.
Duration: Value defined in Event form.
AlertState: Value defined in the “Execute On” field of the Reactions form.
AlertType: Value defined in the Event “Type” field of the watch object.
StartDate: Event's start date and time.
LogMessage: Used for Logs, it displays the Log Message.
AlertMessage: Value defined in Events form.
AcknowledgedMessage: URL for acknowledging the Log message (Log monitors only)
AcknowledgeAll: URL for acknowledging all un-acknowledged messages for that particular Log monitor (Log monitors only).
AcknowledgeAlert: URL for acknowledging the Alert via a regular PC.
AcknowledgeAlertPDA: URL for acknowledging the Alert via a PDA or other similar device.
Tip: Please refer to PDA product documentation for details on this feature.
Body: Type the message that will appear in the body of this Email. Insert variables as desired by selecting the variable from the drop down list. Do this for each variable you wish to add.
Description: Enter a meaningful description of this reaction.
Path and Arguments: Type the commands to execute the script you would like to run. Select variables from the drop list. The selected program or script must be on the same machine where AppsWatch is installed.
Restart What?: Select from the drop down list - Service, Process, or Computer.
Host: Select the Service, Process or Computer host to restart.
Name: Leave blank if you would like this restart reaction to start, the same service/process/computer that triggered the event. Otherwise, enter the name of the Service/Process/Computer that you would like to restart. When restarting a process, provide full path to the process binary, if it is not in the environment path.
Note: The same option is only applicable, when this reaction is applied on a host/process/service being monitored by Systems.
SNMP Host: Type the Host IP of the machine that receives the trap. You need to have a trap receiver program on the receiver machine.
Port: Type the Port number. This is the port number the trap receiver uses (default is 126 when left blank).
Message: Type text in the message field. This is the text that the trap receiver will get when the threshold is exceeded. Insert one or more alert variables by selecting the variable from the drop down list on the right side of the message field.
Complete the “New Reaction Form” parameters and “Submit”.
Edit a Reaction
Click the “Edit” icon next to the Reaction. Reaction form opens;
When you are done with editing, click "Submit".
Delete a Reaction
Click the “Delete”icon next to the Reaction;
Click "Yes" to delete the reaction.
Apply a Reaction to an Event
When adding or editing an Event, assign a Reaction to either Reaction#1 or Reaction#2. All Reactions that have been defined will appear in the Reaction#1 and Reaction#2 drop lists on the Event form;