Percent Variables

Active Monitor Variables

Description

%ActiveMonitor.Argument

SNMP instance number. This is only used when an action is associated directly with an active monitor, and not the device as a whole.

%ActiveMonitor.Comment

The human readable name that coincides with the network switch. This is only used when an action is associated directly with an active monitor, and not the device as a whole.

%ActiveMonitor.Name

 

The name of the active monitor that fired an action. This is only used when an action is associated directly with an active monitor, and not the device as a whole.

%ActiveMonitor.NetworkInterfaceAddress

IP address for the network interface. This is only used when an action is associated directly with an active monitor, and not the device as a whole.

%ActiveMonitor.Payload

The payload returned by a WMI, Exchange, SQL, or SNMP active monitor. This is only used when an action is associated directly with an active monitor and not the devices as a whole.

%ActiveMonitor.State

 

The Current status of the monitor, such as "Down at least 5 min." This is only used when an action is associated directly with an active monitor, and not the device as a whole.

Device Variables

Description

%Device.ActiveMonitorDownNames

List of down services using the abbreviated name if available.

%Device.ActiveMonitorUpNames

Full service names of all UP monitored services on a device.

%Device.Address

IP address (from device properties).

%Device.Attribute.[Attribute Name]

Returns an attribute from the SNMP information available for the device, such as the Contact name. To specify the attribute, append the category name (listed below) to the end of the variable. For example: %Device.Attribute.Contact, returns the contact name.

Default categories:

� *. Returns all attributes

� Info1. Upgrade path from v8

� Info2. Upgrade path from v8

Contact. Contact information from SNMP

� Location. Location information from SNMP

Description. Description information from SNMP

� Custom. If you have created a custom attribute you can use the name of that custom attribute in the percent variable.

Example:

%Device.Attribute.Phone
%Device.Attribute.RackPosition

To avoid an error, when placing %Device.Attribute in quotation marks, place a space between the last letter and the closing quotation mark.  

Example:

"%Device.Attribute.Contact ";   correct

"%Device.Attribute.Contact";    incorrect

%Device.DatabaseID

Returns the database ID of a device.

%Device.DisplayName

Display Name (from General of device properties)

%Device.HostName

Host Name (from General of device properties)

%Device.Notes

Notes. (Notes are from the device properties Notes)

%Device.SNMPOid

SNMP Object identifier.

%Device.State

The state's description (such as "Down at least 2 min" or "Up at least 5 min")

%Device.Status

This shows the name of the active monitor, preceded by the device state id : 10|DNS

%Device.Type

Device Type (from General of device properties)

Passive Monitor Variables

Description

%PassiveMonitor.DisplayName

The name of the monitor as it appears in the Passive Monitor Library.

%PassiveMonitor.LoggedText

Detailed Event description. (SNMP traps - Returns the full SNMP trap text). (Windows Log Entries - Returns information contained in the Windows Event Log entries). (Syslog Entries - Returns the text contained in the Syslog message).

%PassiveMonitor.Payload.*

Payload generated by a passive monitor.

%PassiveMonitor.Payload.EventType

The type of passive monitor (Syslog, Windows Event, or SNMP Trap)

 

System Variables

Description

%System.Date

The current system date. Configure the date format in Regional Options (from Program Options)

%System.DisplayNamesDownDevices

Display names of devices with down monitors

%System.DisplayNamesDownMonitors

 

Shows the name of a device and each monitor that is down on that device. The format of the response is 'device name':'monitor 1','monitor 2','...'

Example: ARNOR: FTP, HTTPS, Ping

%System.DisplayNamesUpDevices

Display names of up devices

%System.DisplayNamesUpMonitors

Shows the name of a device and each monitor that is up on that device. The format of the response is 'device name':'monitor 1','monitor 2','...'

Example: ARNOR: FTP, HTTPS, Ping

%System.InstallDir

Displays the directory on which WhatsUp Gold is installed

%System.NumberofDownDevices

Number of down devices on your network

%System.NumberOfDownMonitors

Shows the number of down monitors on your network

%System.NumberofUpDevices

Number of up devices on your network

%System.NumberOfUpMonitors

Shows the number of up monitors on your network

%System.Time

The current system  time. The format is hh:mm:ss