Template data

Sat, 04 Apr 2026 12:26:57 +0000

Template data

Template data is passed on to message templates as well as sent as payload to webhook pushes.

Name	Type	Notes
Receiver	string	Name of the contact point that the notification is being sent to.
Status	string	`firing` if at least one alert is firing, otherwise `resolved`.
Alerts	Alert	List of alert objects that are included in this notification (see below).
GroupLabels	KeyValue	Labels these alerts were grouped by.
CommonLabels	KeyValue	Labels common to all the alerts included in this notification.
CommonAnnotations	KeyValue	Annotations common to all the alerts included in this notification.
ExternalURL	string	Back link to the Grafana that sent the notification. If using external Alertmanager, back link to this Alertmanager.

The Alerts type exposes functions for filtering alerts:

Alerts.Firing returns a list of firing alerts.
Alerts.Resolved returns a list of resolved alerts.

Alert

Name	Type	Notes
Status	string	`firing` or `resolved`.
Labels	KeyValue	A set of labels attached to the alert.
Annotations	KeyValue	A set of annotations attached to the alert.
StartsAt	time.Time	Time the alert started firing.
EndsAt	time.Time	Only set if the end time of an alert is known. Otherwise set to a configurable timeout period from the time since the last alert was received.
GeneratorURL	string	A back link to Grafana or external Alertmanager.
SilenceURL	string	Link to grafana silence for with labels for this alert pre-filled. Only for Grafana managed alerts.
DashboardURL	string	Link to grafana dashboard, if alert rule belongs to one. Only for Grafana managed alerts.
PanelURL	string	Link to grafana dashboard panel, if alert rule belongs to one. Only for Grafana managed alerts.
Fingerprint	string	Fingerprint that can be used to identify the alert.
ValueString	string	A string that contains the labels and value of each reduced expression in the alert.

KeyValue

KeyValue is a set of key/value string pairs that represent labels and annotations.

Here is an example containing two annotations:

{
  "summary": "alert summary",
  "description": "alert description"
}

In addition to direct access of data (labels and annotations) stored as KeyValue, there are also methods for sorting, removing and transforming.

Name	Arguments	Returns	Notes
SortedPairs		Sorted list of key & value string pairs
Remove	[]string	KeyValue	Returns a copy of the Key/Value map without the given keys.
Names		[]string	List of label names
Values		[]string	List of label values

Template functions

Sat, 04 Apr 2026 12:26:57 +0000

Template Functions

Template functions allow you to process labels and annotations to generate dynamic notifications.

Name	Argument type	Return type	Description
humanize	number or string	string	Converts a number to a more readable format, using metric prefixes.
humanize1024	number or string	string	Like humanize, but uses 1024 as the base rather than 1000.
humanizeDuration	number or string	string	Converts a duration in seconds to a more readable format.
humanizePercentage	number or string	string	Converts a ratio value to a fraction of 100.
humanizeTimestamp	number or string	string	Converts a Unix timestamp in seconds to a more readable format.
title	string	string	strings.Title, capitalises first character of each word.
toUpper	string	string	strings.ToUpper, converts all characters to upper case.
toLower	string	string	strings.ToLower, converts all characters to lower case.
match	pattern, text	boolean	regexp.MatchString Tests for a unanchored regexp match.
reReplaceAll	pattern, replacement, text	string	Regexp.ReplaceAllString Regexp substitution, unanchored.
graphLink	string - JSON Object with `"expr"` and `"datasource"` fields	string	Returns the path to graphical view in Explore for the given expression and data source.
tableLink	string- JSON Object with `"expr"` and `"datasource"` fields	string	Returns the path to tabular view in Explore for the given expression and data source.
args	[]interface{}	map[string]interface{}	Converts a list of objects to a map with keys, for example, arg0, arg1. Use this function to pass multiple arguments to templates.
externalURL	nothing	string	Returns a string representing the external URL.
pathPrefix	nothing	string	Returns the path of the external URL.

Examples

humanize

Template string { humanize $value }

Input 1234567.0

Expected 1.235M

humanize1024

TemplateString { humanize1024 $value }

Input 1048576.0

Expected 1Mi

humanizeDuration

TemplateString { humanizeDuration $value }

Input 899.99

Expected 14m 59s

humanizePercentage

TemplateString { humanizePercentage $value }

Input 0.1234567

Expected 12.35%

humanizeTimestamp

TemplateString { $value | humanizeTimestamp }

Input 1435065584.128

Expected 2015-06-23 13:19:44.128 +0000 UTC

title

TemplateString { $value | title }

Input aa bb CC

Expected Aa Bb Cc

toUpper

TemplateString { $value | toUpper }

Input aa bb CC

Expected AA BB CC

toLower

TemplateString { $value | toLower }

Input aA bB CC

Expected aa bb cc

match

TemplateString { match "a+" $labels.instance }

Input aa

Expected true

reReplaceAll

TemplateString {{ reReplaceAll "localhost:(.*)" "my.domain:$1" $labels.instance }}

Input localhost:3000

Expected my.domain:3000

graphLink

TemplateString {{ graphLink "{\"expr\": \"up\", \"datasource\": \"gdev-prometheus\"}" }}

Expected /explore?left=["now-1h","now","gdev-prometheus",{"datasource":"gdev-prometheus","expr":"up","instant":false,"range":true}]

tableLink

TemplateString {{ tableLink "{\"expr\": \"up\", \"datasource\": \"gdev-prometheus\"}" }}

Expected /explore?left=["now-1h","now","gdev-prometheus",{"datasource":"gdev-prometheus","expr":"up","instant":true,"range":false}]

args

TemplateString {{define "x"}}{{.arg0}} {{.arg1}}{{end}}{{template "x" (args 1 "2")}}

Expected 1 2

externalURL

TemplateString { externalURL }

Expected http://localhost/path/prefix

pathPrefix

TemplateString { pathPrefix }

Expected /path/prefix

Message templating on Grafana Labs

Template data

Template data

Alert

KeyValue

Template functions

Template Functions

Examples

humanize

humanize1024

humanizeDuration

humanizePercentage

humanizeTimestamp

title

toUpper

toLower

match

reReplaceAll

graphLink

tableLink

args

externalURL

pathPrefix