Alert message variables reference đź”—
The following tables describe the variables and helper functions you can use when creating a custom message. Use triple braces where indicated so that the variable value is not escaped.
Note
Different additional variables may be available depending on the alert condition you specify. If you change the alert condition after customizing the message, an icon on the Message preview tab appears.

This is to remind you to review the message, since some variables you used might no longer apply to the new condition you selected. The icon is removed when you navigate away from the Message preview tab.
Detector and rule details
Variable |
Description |
---|---|
{{{detectorName}}} |
The name of this detector |
{{{ruleName}}} |
The name of the rule that triggered the alert |
{{ruleSeverity}} |
The severity of this rule: |
{{{readableRule}}} |
The readable description of this rule. For example: “The value of metric.name.here is above 100”. |
{{{runbookUrl}}} |
URL of page to see when this alert is triggered |
{{{tip}}} |
Plain text suggested first course of action, such as a command line to run. |
{{detectorId}} |
The ID of this detector. You can use this to programmatically reference this detector. |
{{detectorUrl}} |
The URL of this detector |
Alert details
Variable |
Description |
---|---|
There are two variations of this variable:
|
Note: When an alert fires or clears, it always generates a timestamp in UTC. However, in the preview message for the alert, you will see this timestamp in your UI time zone, which might be different from GMT.
|
{{anomalyState}} |
The state of this alert (OK or ANOMALOUS) |
{{anomalous}} |
Boolean; true indicates that the alert triggered |
{{normal}} |
Boolean; true indicates that the alert cleared |
{{imageUrl}} |
The URL for the preview image shown in the notification message |
{{incidentId}} |
The ID of this incident. The incidentID is the same for both the trigger and the clear alerts. |
Signal details
Variable |
Description |
---|---|
{{inputs.A.value}} |
The value of the signal on plot line A |
{{inputs.B.value…}} |
(The value of other signals in the detector) |
{{{dimensions}}} |
|
{{dimensions.dimensionName}} |
The value of the dimension “dimensionName” for the signal being monitored |
{{dimensions.dimensionName2…}} |
The value of other dimensions for the signal being monitored |
{{dimensions.[dimension.name.3…]}} |
The value of other dimensions for the signal being monitored. When dimension names contain dots (.), you must enclose them in square brackets ([]) for the variable to work. |
ORGANIZATION DETAILS
Variable |
Description |
---|---|
{{organizationId}} |
The organization ID. You can use this to programmatically reference this organization. |
Helper functions
Option |
Description |
---|---|
{{#if}} {{else}} {{/if}} |
|
{{#notEmpty dimensions}} {{/notEmpty}} |
|
Here is an example of a default message that you can customize:
{{#if anomalous}}
Rule "{{ruleName}}" in detector "{{detectorName}}" triggered at {{timestamp}}.
{{else}}
Rule "{{ruleName}}" in detector "{{detectorName}}" cleared at {{timestamp}}.
{{/if}}
{{#if anomalous}}
Triggering condition: {{{readableRule}}}
{{/if}}
{{#if anomalous}}Signal value: {{inputs.A.value}}
{{else}}Current signal value: {{inputs.A.value}}
{{/if}}
{{#notEmpty dimensions}}
Signal details:
{{{dimensions}}}
{{/notEmpty}}
{{#if anomalous}}
{{#if runbookUrl}}Runbook: {{{runbookUrl}}}{{/if}}
{{#if tip}}Tip: {{{tip}}}{{/if}}
{{/if}}
The following tables describe the additional variables you can use when creating a custom message for specific alert conditions.
Resource running out
Variable |
Description |
---|---|
{{inputs.hours_left.value}} |
Number of hours remaining before reaching empty or capacity |
{{event_annotations.fire_forecast_ahead}} |
Threshold for triggering alert, in hours |
{{event_annotations.clear_forecast_ahead}} |
Threshold for clearing alert, in hours |
Outlier detection
Variable |
Description |
---|---|
{{inputs.promoted_population_stream.value}} |
Signal being monitored |
{{inputs.fire_bot.value}} |
Threshold for triggering alert when value is lower than the threshold |
{{inputs.clear_bot.value}} |
Threshold for clearing alert |
{{inputs.fire_top.value}} |
Threshold for triggering alert when value is higher than the threshold |
{{inputs.clear_top.value}} |
Threshold for clearing alert |
Sudden change
Variable |
Description |
---|---|
{{event_annotations.current_window}} |
Window being tested for anomalous values |
{{inputs.recent_min.value}} |
Minimum value during current window |
{{inputs.recent_max.value}} |
Maximum value during current window |
{{inputs.f_bot.value}} |
Threshold for triggering alert when value is lower than the threshold |
{{inputs.c_bot.value}} |
Threshold for clearing alert |
{{inputs.f_top.value}} |
Threshold for triggering alert when value is higher than the threshold |
{{inputs.c_top.value}} |
Threshold for clearing alert |
Historical anomaly
Variable |
Corresponds to |
---|---|
{{event_annotations.current_window}} |
Window being tested for anomalous values |
{{inputs.summary.value}} |
Mean value during current window |
{{inputs.fire_bot.value}} |
Threshold for triggering alert when value is lower than the threshold |
{{inputs.clear_bot.value}} |
Threshold for clearing alert |
{{inputs.fire_top.value}} |
Threshold for triggering alert when value is higher than the threshold |
{{inputs.clear_top.value}} |
Threshold for clearing alert |