PingPlotter Cloud Manual

Variables


PingPlotter Cloud has many different objects you can use inside of the Message Templatefor the Send an Email alert action. 

Each object is dynamic and can embed or attach data to an email when an alert condition is met. See below for the default example: 

Customize the email template using variables.

Additional Options

Methods with a # mean you can edit the parameters within the quotations. You can also customize how line items show up by wrapping them in HTML header tags.

Variable List

Time Formatting Information

The {{Now}} variable, along with time labels on attached graphs and images, is formatted according to the specified time zone and format. Note: this applies exclusively to the "Send Email" action.

{{AgentName}} - Name of Cloud Agent

{{AgentUniqueID}} - UniqueID of Cloud Agent

{{SessionId}} - Unique ID of the Target Session

{{CustomFields.CustomFieldName}} - Returns the value of the Custom Field for the Agent (replace CustomFieldName with the name of your Custom Field), e.g. {{CustomFields.Manager}}

{{QualityDefinitionId}} - Unique ID of the Quality Definition

{{QualityDefinition}} - Name of Quality Definition used to determine the quality of the Target

{{LatestQuality}} - Last calculated Quality Score for the Target (good, fair, or poor)

{{QualityScore}} - Numerical value of the Quality Score for the Target (0 -100)

{{Host.IPAddress}} - Host IP Address

{{Host.HostName}} - hostname in DNS

{{Host.AliasName}} - Custom hostname alias

{{Host.PreferredName}} - First non empty value for: alias, DNS hostname, IP Address

{{Host.FullDisplayName}} - Preferred name followed by IP Address in parenthesis

{{AlertName}} - Name of Alert that fired

{{ConditionFailedCount}} - The number of times an alert condition has failed

{{DestinationHost.HostID}} - Destination's Host Identification Number

{{DestinationHost.IPAddress}} - Destination's Host IP Address

{{DestinationHost.HostName}} - Destination's hostname in DNS

{{DestinationHost.AliasName}} - Destination's custom hostname alias

{{DestinationHost.PreferredName}} - Desinstation's first non-empty value for: alias, DNS hostname, IP Address

{{DestinationHost.FullDisplayName}} - Destination's preferred name followed by IP Address in parenthesis

{{ConfigName}} - Name of configuration (display + engine paramaters)

{{TimeFormat}} - Displays the value set in the Time Format field, e.g. 2024.12.05

{{TimeZone}} - Displays the value set in the Time Zone field, e.g. America/Boise (GMT-07:00)

{{Now}} - Displays a complete date-time using the configured time zone and time format variables, e.g. MM/DD/YYYY hh:mm:ss AM/PM

{{Now.Second}} - Display current time second

{{Now.Minute}} - Display current time minute

{{Now.Hour}} - Display current time hour

{{Now.Day}} - Number date for current day

{{Now.Month}} - Number date for current month

{{Now.DayOfWeek}} - Display current day of the week

{{UtcNow}} - Coordinated Universal Time, 00/00/0000 hr:min:sec AM/PM

{{UtcNow.Second}} - Coordinated Universal Time, display current second

{{UtcNow.Minute}} - Coordinated Universal Time, display current minute

{{UtcNow.Day}} - Coordinated Universal Time, number date for current day

{{UtcNow.Hour}} - Coordinated Universal Time, display current hour

{{UtcNow.DayOfWeek}} - Coordinated Universal Time, current day of the week

{{UtcNow.Month}} - Coordinated Universal Time, number date for current month

{{HistoryData}} - Display historical data in a chart; Hop, IP Address, and Hostname. Below, rows of sample values are displayed

{{#attach_data '{of_last: "60 seconds"}' }} - Export in PP2 format of data of for specified time period limited to the specified number of samples

{{#attach_timegraph '{of_last: "60 seconds", width: 1400, height: 400}' }} - Timeline image for specified time period drawn to specified width and height

{{#attach_tracegraph '{of_last: "60 seconds", width: 1400, height: 400}' }} - Trace Grid and Latency Graph image for specified time period drawn to specified width and height

{{#attach_image '{of_last: "60 seconds", width: 1400, height: 400}' }} - Screenshot image of for specified time period drawn to specified width and height (includes Timeline, Trace Grid, Latency Graph)