Skip to content

Message templates

The Message field of a rule, and the Subject and Message body fields of email destinations, can include both text and templates. Before Zenoss Cloud sends a message, it replaces templates with values from the context of an action:

  • The trigger that identified the conditions for the action.
  • The conditions the trigger identified.
  • The destination or destinations specified in the rule.
  • The rule itself.

Template syntax is either {{{object.property}}} or {{{destination.type.property}}}. After you enter the leading curly brackets, object names autocomplete. After the full stop character, type or property names autocomplete.

General templates

{{{clear}}}
Whether the conditions that triggered a notification have changed significantly (true) or have not changed significantly (false).
{{{id}}}
The unique identifier of this action.
{{{link}}}
An HTML-formatted link to the history page showing this action.
{{{tenant}}}
The name of your organization.
{{{tenant_domain}}}
The FQDN of your organization's Zenoss Cloud environment.
{{{tenant_link}}}
An HTML-formatted link to your organization's Zenoss Cloud environment.
{{{tenant_url}}}
An unformatted link to your organization's Zenoss Cloud environment.
{{{timestamp}}}
The date and time (UTC) at which the action was initiated.
{{{timestamp_ms}}}
The time at which the action was initiated, in milliseconds since the epoch (January 1, 1970 at 00:00:00 UTC).
{{{url}}}
An unformatted link to the history page showing this action.

Event templates

{{{event.acknowledged}}}
Whether an event has been acknowledged (true) or has not been acknowledged (false).
{{{event.body}}}
The text of an event.
{{{event.id}}}
The event identifier.
{{{event.name}}}
The event name.
{{{event.severity}}}

The event severity, one of the following values:

SEVERITY_DEFAULT Unknown at this time
SEVERITY_DEBUG By default, not severe enough to display in an events console
SEVERITY_INFO Most likely, no action is required
SEVERITY_WARNING Action may be required in the future
SEVERITY_ERROR Entity is degraded but not down
SEVERITY_WARNING Entity is down

{{{event.status}}}

The event status, one of the following values:

STATUS_DEFAULT Unknown at this time
STATUS_OPEN Known to be in progress at this time
STATUS_SUPPRESSED Should be ended
STATUS_CLOSED Known to be ended

{{{event.summary}}}
A brief description of an event.
{{{event.tenant}}}
The name of your Zenoss Cloud organization.
{{{event.timestamp}}}
The date and time (UTC) of an event.
{{{event.type}}}
A label that classifies an event.

Destination templates

All destinations

{{{destination.description}}}
Text describing a destination.
{{{destination.link}}}
An HTML-formatted link that opens a search for the destination on the ADMIN > Actions page in Zenoss Cloud.
{{{destination.name}}}
The destination name.
{{{destination.type}}}
The destination type.
{{{destination.tags}}}
The tags associated with a destination.
{{{destination.url}}}
An unformatted link that opens a search for the destination on the ADMIN > Actions page in Zenoss Cloud.

Email destinations

{{{destination.email.to}}}
The email address specified for a destination.
{{{destination.email.subject}}}
The subject line of an email message.
{{{destination.email.body}}}
The body of an email message.

ServiceNow destinations

{{{destination.servicenow.baseUrl}}}
The URL of the target ServiceNow IT Operations Management instance.
{{{destination.servicenow.shortDescription}}}
The text included in all notifications sent to this destination.

Slack destinations

{{{destination.slack.channel}}}
The name of the public channel in your Slack workspace.
{{{destination.slack.color}}}

The color to use in notifications sent to the target channel.

The color is applied to a vertical bar accompanying the message block. Standard HTML color codes are supported.

Webhook destinations

{{{destination.webhook.url}}}
The URL of a webhook receiver.

Metric templates

{{{metric.id}}}
The ID of a metric. For example, AAAAAzdkb9nEvMALcRiVb8Yrt-c=.
{{{metric.link}}}
An HTML-formatted link that opens a Smart View page with the metric pinned in the primary metric tile.
{{{metric.name}}}
The name of a metric. For example, uptime_laLoadInt5.
{{{metric.timestamp}}}
The date and time (UTC) at which a metric data point was collected.
{{{metric.url}}}
An unformatted link that opens a Smart View page with the metric pinned in the primary metric tile.
{{{metric.value}}}
The data point value.

Trigger templates

{{{trigger.description}}}
Text describing a trigger.
{{{trigger.link}}}
An HTML-formatted link that opens a search for the trigger on the ADMIN > Actions page in Zenoss Cloud.
{{{trigger.name}}}
The trigger name.
{{{trigger.query}}}
The query specified in a trigger.
{{{trigger.tags}}}
The tags associated with a trigger.
{{{trigger.type}}}
The trigger type. The value is event (event triggers) or metricThreshold (metric triggers).
{{{trigger.url}}}
An unformatted link that opens a search for the trigger on the ADMIN > Actions page in Zenoss Cloud.

Rule templates

{{{rule.description}}}
Text describing a rule.
{{{rule.destination_names}}}
The list of destinations associated with a rule.
{{{rule.enabled}}}
Whether a rule is enabled (true) or disabled (false).
{{{rule.link}}}
An HTML-formatted link that opens a search for the rule on the ADMIN > Actions page in Zenoss Cloud.
{{{rule.message}}}
The text of a rule's message.
{{{rule.name}}}
The rule name.
{{{rule.repeat}}}
Whether the repeat option is enabled (true) or not enabled (false).
{{{rule.repeat_interval}}}
The value of the repeat interval setting, in seconds.
{{{rule.send_updates}}}
Whether the send updates option is enabled (true) or not enabled (false).
{{{rule.tags}}}
The list of tags associated with a rule.
{{{rule.trigger_names}}}
The list of triggers associated with a rule.
{{{rule.url}}}
An unformatted link that opens a search for the rule on the ADMIN > Actions page in Zenoss Cloud.