Percent variables for APM actions

The following percent variables are available for use with Application Performance Monitoring (APM) actions:

Name

Description

%System.Time

Returns the system time.

%System.Date

Returns the system date.

%System.InstallDir

Returns the install directory of the WhatsUp Gold instance.

%Application.ApplicationInstance.ApplicationID

Returns the ID of the application instance.

%Application.ApplicationInstance.ApplicationName

Returns the application name associated with the application instance.

%Application.ApplicationInstance.Description

Returns the description given to the application instance.

%Application.ApplicationInstance.CurrentState

Returns the current state of the application instance.

%Application.ApplicationInstance.PreviousState

Returns the previous state of the application instance.

%Application.ApplicationInstance.MasterDeviceID

Returns the ID of the master device associated with the application instance.

%Application.ApplicationInstance.MasterDeviceDisplayName

Returns the display name of the master device associated with the application instance.

%Application.TriggeringComponent.Name

Returns the name of the component that triggered the associated action.

%Application.TriggeringComponent.PollTime

Returns the time of the last poll of the component that triggered the action.

%Application.TriggeringComponent.Type

Returns the type of the component that triggered the action.

%Application.TriggeringComponent.CurrentState

Returns the current state of the component that triggered the action.

%Application.TriggeringComponent.PreviousState

Returns the previous state of the component that triggered the action.

%Application.TriggeringComponent.DeviceID

Returns the ID of the device associated with the component that triggered the action.

%Application.TriggeringComponent.DeviceDisplayName

Returns the display name of the device associated with the component that triggered the action.

%Device.DatabaseID

Returns the database of the device associated with the component that triggered the action.

%Device.DisplayName

Returns the display name of the device associated with the component that triggered the action.

%Device.HostName

Returns the host name of the device associated with the component that triggered the action.

%Device.Address

Returns the IP address of the device associated with the component that triggered the action.

Note: If the source is an application instance or a group instance then the value of the Device.DatabaseID percent variable is the ID of the master device assigned to the application/group instance. If the source is a component instance, then the value of the Device.DatabaseID percent variable is the ID of the device assigned (overridden) to the component instance. If no device is assigned to the component instance, then the value of the Device.DatabaseID percent variable is the ID of the master device assigned to the application instance. Value of all other device specific percent variables will reflect the properties of the device referenced by Device.DatabaseID.

Important: If the %Application.TriggeringComponent.DeviceDisplayName variable is used in an action it will return a "0" if it evaluates against the master device. If it evaluates against an overriden device component, it returns the proper device display name.

See Also

Working with actions in APM

Creating an action in APM