OpManager variables
Variables in OpManager are used to insert real-time data into workflows, notification messages, and webhook payloads. They act as dynamic fields that automatically pull in values like device name, IP address, alarm severity, and timestamp when an event is triggered.
For example, in a notification profile, you can use variables to include the device name and alarm details in an email or SMS. In workflows, variables let you perform actions based on the specific device or alarm that triggered the workflow. When sending data to external systems via webhook, variables ensure the payload contains accurate, relevant details from OpManager events.
The following variables help you automate responses, get useful alerts, and integrate with other tools without manually specifying any values.
| Variable Category | Variable Name | Description |
|---|---|---|
| Device Properties | $DeviceField(type) | Type of the device |
| $DeviceField(ipAddress) | IP address of the device | |
| $DeviceField(snmp) | Whether SNMP is enabled (True/False) | |
| $DeviceField(dependent) | Name of the parent device | |
| $DeviceField(hardDiskSize) | Disk size in gigabytes | |
| $DeviceField(ramSize) | RAM size in megabytes | |
| $DeviceField(vendor) | Device vendor name | |
| Alarm Variables | $alarmid | Numerical ID assigned to the alarm |
| $message | Message of the alarm | |
| $rcaLinkOfTheAlarm | Root Cause Analysis profile name | |
| $displayName | Source that triggered the alarm | |
| $category | Category of the source | |
| $stringseverity | Severity level (Attention, Trouble, Service Down, Critical & Clear) | |
| $strModTime | Timestamp indicating when the alarm was last modified | |
| $eventType | Type of the alarm | |
| $entity | Unique identifier of the alarm | |
| $lastPolledValue | Last collected value of the monitor | |
| Interface Properties | $IntfField(ifDescr) | Interface description |
| $IntfField(displayName) | Display name of the interface | |
| $IntfField(IFAlias) | Interface alias | |
| $IntfField(ifName) | Interface name | |
| $IntfField(ipAddress) | IP address of the interface | |
| $IntfField(ifPhysAddress) | Physical address (MAC) of the interface | |
| $IntfField(index) | Interface index | |
| $IntfField(ifCircuitID) | Circuit identification number | |
| $IntfField(ifSpeedIn) | Incoming speed | |
| $IntfField(ifSpeedOut) | Outgoing speed | |
| Monitor Properties | $MonitorField(monitorName) | Display name of the monitor |
| $MonitorField(instance) | Instance name of the monitor | |
| $MonitorField(protocol) | Protocol used by the monitor | |
| Custom Fields for Devices | $CustomField(Building) | Building name or location |
| $CustomField(Cabinet) | Cabinet or rack number | |
| $CustomField(Comments) | Additional comments | |
| $CustomField(Contact Name) | Contact person name | |
| $CustomField(Department) | Department name | |
| $CustomField(Floor) | Floor number | |
| $CustomField(SerialNumber) | Device serial number | |
| $CustomField(Telephone Number) | Contact telephone number | |
| Custom Fields for Interfaces | $IntCustomField(Circuit ID) | Custom circuit ID |
| $IntCustomField(Comments) | Custom comments | |
| $IntCustomField(Contact Name) | Contact person name | |
| $IntCustomField(SLA) | Service Level Agreement | |
| $IntCustomField(Telephone Number) | Contact telephone number | |
| Notification Profile Properties | $ProfileField(name) | Name of the notification profile |
Additionally, the following variables can be used while executing workflows,
| Variable | Description |
| ${DeviceName} | Displays the device DNS name. |
| ${WorkflowName} | Displays the name of the workflow. |
| ${Device.DisplayName} | Shows the display name of the device |
| ${IPAddress} | Displays the IP address of the device. |
| ${Date} | Displays the current time. |