To print all labels, comma separated, print the $labels variable:

For example, given an alert with the labels alertname=High CPU usage, grafana_folder=CPU alerts and instance=server1, this would print:

To print all labels, one per line, use a range to iterate over each key/value pair and print them individually. Here $k refers to the name and $v refers to the value of the current label:

For example, given an alert with the labels alertname=High CPU usage, grafana_folder=CPU alerts and instance=server1, this would print:

To print an individual label use the index function with the $labels variable:

For example, given an alert with the labels instance=server1, this would print:

To print the value of an instant query you can print its Ref ID using the index function and the $values variable:

For example, given an instant query that returns the value 81.2345, this will print:

To print the value of a range query you must first reduce it from a time series to an instant vector with a reduce expression. You can then print the result of the reduce expression by using its Ref ID instead. For example, if the reduce expression takes the average of A and has the Ref ID B you would write:

To print the humanized value of an instant query use the humanize function:

For example, given an instant query that returns the value 81.2345, this will print:

To print the humanized value of a range query you must first reduce it from a time series to an instant vector with a reduce expression. You can then print the result of the reduce expression by using its Ref ID instead. For example, if the reduce expression takes the average of A and has the Ref ID B you would write:

To print the value of an instant query as a percentage use the humanizePercentage function:

This function expects the value to be a decimal number between 0 and 1. If the value is instead a decimal number between 0 and 100 you can either divide it by 100 in your query or using a math expression. If the query is a range query you must first reduce it from a time series to an instant vector with a reduce expression.

To set a severity label from the value of a query use an if statement and the greater than comparison function. Make sure to use decimals (80.0, 50.0, 0.0, etc) when doing comparisons against $values as text/template does not support type coercion. You can find a list of all the supported comparison functions here.

You cannot use $labels to print labels from the query if you are using classic conditions, and must use $values instead. The reason for this is classic conditions discard these labels to enforce uni-dimensional behavior (at most one alert per alert rule). If classic conditions didn’t discard these labels, then queries that returned many time series would cause alerts to flap between firing and resolved constantly as the labels would change every time the alert rule was evaluated.

Instead, the $values variable contains the reduced values of all time series for all conditions that are firing. For example, if you have an alert rule with a query A that returns two time series, and a classic condition B with two conditions, then $values would contain B0, B1, B2 and B3. If the classic condition B had just one condition, then $values would contain just B0 and B1.

To print all labels of all firing time series use the following template (make sure to replace B in the regular expression with the Ref ID of the classic condition if it’s different):

For example, a classic condition for two time series exceeding a single condition would print:

If the classic condition has two or more conditions, and a time series exceeds multiple conditions at the same time, then its labels will be duplicated for each condition that is exceeded:

If you need to print unique labels you should consider changing your alert rules from uni-dimensional to multi-dimensional instead. You can do this by replacing your classic condition with reduce and math expressions.

To print all values from a classic condition take the previous example and replace $v.Labels with $v.Value:

For example, a classic condition for two time series exceeding a single condition would print:

If the classic condition has two or more conditions, and a time series exceeds multiple conditions at the same time, then $values will contain the values of all conditions:

The $labels variable contains all labels from the query. For example, suppose you have a query that returns CPU usage for all of your servers, and you have an alert rule that fires when any of your servers have exceeded 80% CPU usage for the last 5 minutes. You want to add a summary annotation to the alert that tells you which server is experiencing high CPU usage. With the $labels variable you can write a template that prints a human-readable sentence such as:

The $value variable is a string containing the labels and values of all instant queries; threshold, reduce and math expressions, and classic conditions in the alert rule. It does not contain the results of range queries, as these can return anywhere from 10s to 10,000s of rows or metrics. If it did, for especially large queries a single alert could use 10s of MBs of memory and Grafana would run out of memory very quickly.

To print the $value variable in the summary you would write something like this:

And would look something like this:

Here var='A' refers to the instant query with Ref ID A, labels={instance=instance1} refers to the labels, and value=81.234 refers to the average CPU usage over the last 5 minutes.

If you want to print just some of the string instead of the full string then use the $values variable. It contains the same information as $value, but in a structured table, and is much easier to use then writing a regular expression to match just the text you want.

The $values variable is a table containing the labels and floating point values of all instant queries and expressions, indexed by their Ref IDs.

To print the value of the instant query with Ref ID A:

For example, given an alert with the labels instance=server1 and an instant query with the value 81.2345, this would print:

If the query in Ref ID A is a range query rather than an instant query then add a reduce expression with Ref ID B and replace (index $values "A") with (index $values "B"):

The args function translates a list of objects to a map with keys arg0, arg1 etc. This is intended to allow multiple arguments to be passed to templates:

The externalURL function returns the external URL of the Grafana server as configured in the ini file(s):

The graphLink function returns the path to the graphical view in Explore for the given expression and data source:

The humanize function humanizes decimal numbers:

The humanize1024 works similar to humanize but but uses 1024 as the base rather than 1000:

The humanizeDuration function humanizes a duration in seconds:

The humanizePercentage function humanizes a ratio value to a percentage:

The humanizeTimestamp function humanizes a Unix timestamp:

The match function matches the text against a regular expression pattern:

The pathPrefix function returns the path of the Grafana server as configured in the ini file(s):

The tableLink function returns the path to the tabular view in Explore for the given expression and data source:

The title function capitalizes the first character of each word:

The toLower function returns all text in lowercase:

The toUpper function returns all text in uppercase:

The reReplaceAll function replaces text matching the regular expression: