Configuring Trigger Actions

To configure a Trigger Action

To configure the sequence of actions that is to be taken in the event of the trigger condition:

1. For a nominated Auto-Response - with a defined Check Condition - click on Add Trigger Action (e.g. Send Email or Run Custom Script) to select the action type to be taken. Then configure the selected action (as detailed below)
2. Each action is configured with a nominated Action Delay Time which specifies how long (in seconds) after the Auto-Response trigger event to wait before performing the action. So you can add follow-on actions to create a sequence of actions that will be taken in the event of the one trigger condition
3. To edit (or delete) an existing action, click the Modify (or Delete) icon in the Scheduled Trigger Action table 
   
   

Note: A message text can be sent with Email, SMS and Nagios actions. This configurable message can include selected values: 

$AR_TRIGGER_VAL = the trigger value for the check e.g. for UPS Status, it could be onbatt or battlow

$AR_VAL = the value returned by the check e.g. for ups status, it could be online/onbatt/battlow

$AR_CHECK_DEV = the device name of the device being checked e.g. for Alarm, the alarm name 

$TIMESTAMP = the current timestamp

$HOSTNAME = the hostname of the console server

The default message text is: $TIMESTAMP: This action was run - Check details: value $AR_VAL vs trigger value $AR_TRIGGER_VAL

Specific Trigger Actions

1. Send Email 
   
   • Click on Send Email as the Add Trigger Action. Enter a unique Action Name and set the Action Delay Time
   • Specify the Recipient Email Address to send this email to and the Subject of the email. For multiple recipients you can enter comma separated addresses
   • Edit the Email Text message to send and click Save New Action
   Note: An SMS alert can also be sent via an SMTP (email) gateway. You will need to specify the Recipient Email Address in the format specified by the gateway provider (e.g. for T-Mobile it is phonenumber @tmomail.net)
   
   
2. Send SMS 
   
   • Click on Send SMS as the Add Trigger Action. Enter a unique Action Name and set the Action Delay Time
   • Specify the Phone number that the SMS will be sent to in international format (without the +)
   • Edit the Message Text to send and click Save New Action
   Note: The SMS alert can only be sent if there is an internal or external USB cellular modem attached. However an SMS alert can also be sent via a SMTP SMS gateway as described above. Also sending or receiving an SMS using a CDMA cellular modem (e.g. with Verizon in USA) requires V3.6 firmware or later.  
   
   
3. Perform RPC Action 
   
   • Click on Perform RPC Action as the Add Trigger Action. Enter a unique Action Name and set the Action Delay Time
   • Select a power Outlet and specify the Action to be performed (power On, OFF or Cycle)
   • Click Save New Action
4. Run Custom Script 
   
   • Click on Run Custom Script as the Add Trigger Action. Enter a unique Action Name and set the Action Delay Time
   • Create a script file to execute when this action is triggered and enter the Script Executable file name e.g. /etc/config/action.sh
   • Set the Script Timeout (i.e. the maximum run-time for the script). Leave as 0 for unlimited.
   • Enter any Arguments that are to be passed to the script and click Save New Action
5. Send SNMP Trap 
   
   • Click on Send SNMP Trap as the Add Trigger Action. Enter a unique Action Name and set the Action Delay Time
   Note: The SNMP Trap actions are valid for Serial, Environmental, UPS and Cellular data triggers only 
   
   
6. Send Nagios Event 
   
   • Click on Send Nagios Event as the Add Trigger Action. Enter a unique Action Name and set the Action Delay Time
   • Edit the Nagios Event Message text to display on the Nagios status screen for the service
   • Specify the Nagios Event State (OK, Warning, Critical or Unknown) to return to Nagios for this service
   • Click Save New Action
   Note: To notify the central Nagios server of Alerts, NSCA must be enabled under System: Nagios and Nagios must be enabled for each applicable host or port