Replaceable Tags

Introduction: 

This section is common to all the editions of IT360 - Professional Edition, Enterprise Edition [Probes only] and MSP Edition [Probes only].

Alarm Configuration can be further enhanced by 'Replaceable Tags'. An email action is configured, if, for e.g., Tomcat Server goes down. While creating the E-Mail action, you can specify the "Message" as "This resource is running $HOSTNAME at port $PORT". If the Tomcat Server goes down, then the email action is triggered with a message that contains the actual name of the Host and Port Number. Hereby, the Dollar Tags are replaced with the host, in which the tomcat server is running, and the exact port of the tomcat server.

Further, if you want IT360 to pass arguments to Custom Scripts, which would be invoked as part of 'Execute Program Action', you can make use of the Replaceable Tags.

Example:

For e.g., in 'Execute Program Action' , you can give the value for 'Program To Execute' to be;
'<run.bat $HOSTIP $MONITORNAME $PORT>'

If the action is invoked, then the '$tags' would be replaced with the actual values say;
'<run.bat 191.167.111.27 MyServer 9090>'

Parameter Information:

The below table shows the dollar tag parameters that can be associated with their probable values;

Tags

Values

$MONITORNAME

Name of the Monitor.

$ATTRIBUTE

Various Attributes like Health, Availability, etc.

$SEVERITYASNUMBER

1 (Critical/Down)
4 (Warning)
5 (Clear/Up)

$SEVERITY

Critical, Warning, Clear, Up and Down.

$HOSTIP

The IP Address of the Host.

$MONITORTYPE

Various Monitor Types, like Tomcat-server, MYSQL-DB-server, Script Monitor, etc.

$OBJECTNAME

MBean Object name, when associated to Custom Monitor attributes.

$HOSTNAME

Name of the Host.

$PORT

Port Number

$DATE

Date

$OID

SNMP OID

$RCAMESSAGE

Root Cause Message:
e.g.
Average Response Time of SQS_Tomcat-server_9095 is critical, because its value is 652 > 10 ms.
[Threshold Details: Critical, if value > 10, Warning, if value = 10, Clear, if value < 10]


Limitation of Dollar tags:

$ATTRIBUTE
$DATE
$MONITORNAME
$MONITORTYPE
$RCAMESSAGE
$SEVERITY
$SEVERITYASNUMBER
These attributes will work for all the monitors / Business Service.
$HOSTIP
$HOSTNAME
$PORT
These attributes will not work for Business Service / URL / URL sequence monitor / QEngine Script Monitor / Script Monitor / WMI counters / Web Services.
$OBJECTNAME This will work only for JMX custom attributes.
$OID This will work only for SNMP custom attributes.
$HOSTIP, $HOSTNAME These will not work for Ping Monitor and File Monitor.

Note: The $ tags will not be replaced. when you execute the actions manually.



Copyright © 2013, ZOHO Corp. All Rights Reserved.