Alert Actions Capabilities

The Alert Actions feature offers a large choice of actions in order to notify you of a problem with the technology or to recover from a particular problem. Monitoring Studio can be configured to run one or several types of actions when an alert is triggered by PATROL. You can use Alert Action macros to construct Alert Actions.

Please note that macros are case sensitive and should then always be written in uppercase.

The following types of Alert Actions can be performed by Monitoring Studio:

Trigger an event

If you select the Trigger an Event action, you need to enter the string that will be displayed with the event.

WIZ_SpecificAlertAction_5TrigEvent

Alert Actions: Trigger a PATROL Event

A PATROL Event can be viewed from:

▪	Standard PATROL Consoles (Classic Console, PATROL Central)

▪	PATROL Enterprise Manager

▪	BMC Impact Manager

▪	BMC ProactiveNet Performance Management/BMC TrueSight Operations Management

▪	Other third-party products that interface with PATROL.

Annotate the graph

If you select the Annotate the graph action, you need to enter the string that will be displayed within the annotation point.

To view an annotation, when a threshold is breached, open the graph associated to the parameter in alert and double-click on the black annotation mark on top of the first data point.

WIZ_SpecificAlertAction_6Annotate

Alert Actions: Annotate the graph

Execute a command

At the Group Level

If you select the Execute a command action, you need to complete the following panel:

WIZ_SpecificAlertAction_7OSCommand

Alert Actions: Execute a Command (Group Level)

▪	Enter a command line to be executed on the PATROL Agent node.

▪	(Optional) Enter valid credentials to run the command on the PATROL Agent node. Leave blank to use the PATROL Agent's default account.

The command line can be a program utility or a script call with arguments.

The command must be non-interactive (no window, no user input)

At the Host or Monitor Level

If you select the Execute a command action, you need to complete the following panel:

WIZ_SpecificAlertAction_7OSCommand_Host_Monitor

Alert Actions: Execute a Command (Host or Monitor Level)

▪	Credentials: Select from the drop-down list the type of credentials that you want to use to execute a command:

▪	Agent's Default Account: Uses the PATROL Agent credentials for localhost monitoring.

▪	System Credentials (default): Uses the credentials previously specified when creating the Host.

▪	Add new credentials...: Let's you set new credentials for this specific monitoring.

▪	Enter a command line to be executed on the target host.

Execute a PSL statement

If you select the Execute a PSL statement (advanced) action, you need to enter the PSL statement to be executed by the PATROL Agent on the localhost. Although only a single line is permitted, it can have several PSL instructions.

WIZ_SpecificAlertAction_8PSLCommand

Alert Actions: Execute a PSL statement

The PSL command is recommended for advanced users of PATROL.

Display a pop-up on the consoles

If you select the Display a pop-up on the consoles action, you need to enter the message that will be displayed in the pop-up as well as in the title of the pop-up window.

WIZ_SpecificAlertAction_9Popup

Alert Actions: Display a pop-up on the Consoles

Log to a file

If you select the Log to a file action, you need to enter the log file path on the localhost and the content of the line.

WIZ_SpecificAlertAction_10Log

Alert Actions: Log to a file

Send a basic SNMP trap

If you select the Send a basic SNMP trap action, you need to complete the following panel:

WIZ_SpecificAlertAction_11SNMPTrap

Alert Actions: Send a basic SNMP trap

▪	IP address or hostname of the SNMP trap destination (Host field)

▪	SNMP port and community string

▪	Text that will be sent with the SNMP trap

Send a custom SNMP trap

If you select the Send a custom SNMP trap (advanced) action, you need to complete the following panel:

WIZ_SpecificAlertAction_12CustomSNMPTrap

Alert Actions: Send a custom SNMP trap

▪	IP address or hostname of the SNMP trap destination (Host field)

▪	SNMP port and community string

▪	All the characteristics of the trap: Enterprise OID, trap number and up to 4 varbinds.

Send an e-mail

An SMTP server is required to receive alerts by email and should be configured first by right-clicking the Monitoring Studio icon > KM commands > KM Settings > SMTP Settings.

If you select the Send an e-mail action, you need to complete the following panel:

WIZ_SpecificAlertAction_13Email

Alert Actions: Send an E-mail

▪

Enter the sender and the recipient email address in the From and To fields. To send the email to multiple recipients, use the comma (,) or the semi-column (;) to separate the recipients' email addresses (ex: RecipientAddress1;RecipientAddress2;RecipientAddress2 OR ReciptientAddress1,RecipientAddress2,RecipientAddress2)

▪	With the help of Alert Action macros, type the email subject and the message you wish to send.