Skip to main content

Macros in Alerts & Policies

You can customize your alert messages by including pre-defined Macros. These Macros serve as placeholders that are automatically replaced with actual values when the alert is triggered. By leveraging Macros, you can tailor your alert messages to provide precise information about the event that triggered the alert, facilitating quicker and more informed decision-making.

While configuring a policy, click on the to modify the default alert messages. Here, you can use the pre-defined macros to customize the alert message and the subject.

How to Use Macros​

To use Macros in your alert messages, simply include the Macros within your customised alert message. When the alert is triggered, these Macros will be replaced with the actual values associated with the event.

Below is an example of how you can incorporate Macros in your alert message:

An alert $$$policy.name$$$ was triggered with $$$severity$$$ severity for the monitor $$$object.name$$$ (IP: $$$object.ip$$$) because the $$$counter$$$ breached the threshold with the value $$$value$$$.

Supported Macros​

Here's a list of supported Macros along with the descriptions of what these macros display in the actual alert message:

MacroDescription
$$$policy.trigger.time$$$The exact time when the alert was triggered.
$$$object.name$$$The name of the monitor that triggered the policy.
$$$object.ip$$$The IP address of the monitor that triggered the policy.
$$$object.host$$$The host name of the monitor that triggered the policy.
$$$object.type$$$The type of monitor.
$$$counter$$$The counter for which the alert is triggered.
$$$value$$$The value of the counter at which the alert is triggered.
$$$severity$$$The severity level of the triggered alert.
$$$policy.name$$$The name of the policy that triggered the alert.
$$$policy.type$$$The type of policy that triggered the alert.
$$$object.groups$$$The monitor group for which the alert is triggered .
$$$instance$$$The specific instance for which the alert is triggered.
$$$active.since$$$The duration of the alert in its current severity state.
$$$trigger.condition$$$The policy evaluation criteria for the received alert.

With these Macros, you can create customized alert messages tailored to your specific requirements, ensuring that you receive the most relevant information when alerts are triggered.