mirror of
https://github.com/grafana/grafana.git
synced 2025-07-28 20:22:30 +08:00
ec42b2a361
* Rename `Data sources` title * Relocate and rename `Introduction/Notification templates` * Rename `alert-rules/alert-instances` to `alert-rules/multi-dimensional-alerts` * Move `fundamentals/high-availability` to `setup/enable-ha` * Fix 404 high-availability alerting link on Setup HA Grafana docs * Move alert manager/contact poitns/notification templates within Notifications * Remove `Alerting on numeric data` * Restructure Introduction v2 * Continue Intro restructuring * Update docs/sources/alerting/fundamentals/alert-rules/_index.md Co-authored-by: brendamuir <100768211+brendamuir@users.noreply.github.com> * Complete contact point TODO * Alias: alertManager * Aliases `annotation-label` + content changes * Aliases to `templating-labels-annotations` * Aliases to `queries-conditions` * Rename `rule-evaluation.md` file * Aliases: `contact points` * Aliases to `message-templating` * Aliases to `alert-rules` * Update links to new URL slugs * Remove duplicated alias * Remove trailing slash for external heading links * Remove trailing slash in heading links to other grafana pages * Change URL directory slug `fundamentals/notifications` * rename title `Configure High Availability` * Content changes * Update docs/sources/alerting/fundamentals/alert-rules/_index.md Co-authored-by: brendamuir <100768211+brendamuir@users.noreply.github.com> * Update docs/sources/alerting/set-up/configure-alert-state-history/index.md Co-authored-by: brendamuir <100768211+brendamuir@users.noreply.github.com> * Update docs/sources/alerting/set-up/configure-high-availability/_index.md Co-authored-by: brendamuir <100768211+brendamuir@users.noreply.github.com> * Update docs/sources/alerting/set-up/configure-alert-state-history/index.md Co-authored-by: brendamuir <100768211+brendamuir@users.noreply.github.com> * Update docs/sources/alerting/set-up/configure-high-availability/_index.md Co-authored-by: brendamuir <100768211+brendamuir@users.noreply.github.com> * Update docs/sources/alerting/set-up/configure-high-availability/_index.md Co-authored-by: brendamuir <100768211+brendamuir@users.noreply.github.com> * Update docs/sources/alerting/set-up/configure-high-availability/_index.md Co-authored-by: brendamuir <100768211+brendamuir@users.noreply.github.com> * Update docs/sources/alerting/fundamentals/alert-rules/_index.md Co-authored-by: Jack Baldry <jack.baldry@grafana.com> * Fix broken link reference * Fix `queries-and-conditions` * Fix `alert-rule-evaluation` ref link * Fix aliases + inline doc comments * Fix broken link --------- Co-authored-by: brendamuir <100768211+brendamuir@users.noreply.github.com> Co-authored-by: Jack Baldry <jack.baldry@grafana.com>
84 lines
6.2 KiB
Markdown
84 lines
6.2 KiB
Markdown
---
|
|
aliases:
|
|
- ../../manage-notifications/template-notifications/reference/ # /docs/grafana/<GRAFANA_VERSION>/alerting/manage-notifications/template-notifications/reference/
|
|
canonical: https://grafana.com/docs/grafana/latest/alerting/configure-notifications/template-notifications/reference/
|
|
description: Learn about templating notifications options
|
|
keywords:
|
|
- grafana
|
|
- alerting
|
|
- notifications
|
|
- templates
|
|
labels:
|
|
products:
|
|
- cloud
|
|
- enterprise
|
|
- oss
|
|
title: Reference
|
|
weight: 400
|
|
---
|
|
|
|
# Reference
|
|
|
|
## Data
|
|
|
|
### Alert
|
|
|
|
| Name | Kind | Description | Example |
|
|
| ------------ | -------- | ------------------------------------------------------------------------------------ | --------------------- |
|
|
| Status | `string` | Firing or resolved | `{{ .Status }}` |
|
|
| Labels | `KV` | The labels for this alert | `{{ .Labels }}` |
|
|
| Annotations | `KV` | The annotations for this alert | `{{ .Annotations }}` |
|
|
| Values | `KV` | The values of all expressions, including Classic Conditions | `{{ .Values }}` |
|
|
| StartsAt | `Time` | The time the alert fired | `{{ .StartsAt }}` |
|
|
| EndsAt | `Time` | | `{{ .EndsAt }}` |
|
|
| GeneratorURL | `string` | A link to Grafana, or the Alertmanager if using an external Alertmanager | `{{ .GeneratorURL }}` |
|
|
| SilenceURL | `string` | A link to silence the alert | `{{ .SilenceURL }}` |
|
|
| DashboardURL | `string` | A link to the Grafana Dashboard if the alert has a Dashboard UID annotation | `{{ .DashboardURL }}` |
|
|
| PanelURL | `string` | A link to the panel if the alert has a Panel ID annotation | `{{ .PanelURL }}` |
|
|
| Fingerprint | `string` | A unique string that identifies the alert | `{{ .Fingerprint }}` |
|
|
| ValueString | `string` | A string that contains the labels and value of each reduced expression in the alert. | `{{ .ValueString }}` |
|
|
|
|
### ExtendedData
|
|
|
|
| Name | Kind | Description | Example |
|
|
| ----------------- | --------- | ---------------------------------------------------------------------------------------------------- | ------------------------------------------------------ |
|
|
| Receiver | `string` | The name of the contact point sending the notification | `{{ .Receiver }}` |
|
|
| Status | `string` | The status is `firing` if at least one alert is firing, otherwise `resolved` | `{{ .Status }}` |
|
|
| Alerts | `[]Alert` | List of all firing and resolved alerts in this notification | `There are {{ len .Alerts }} alerts` |
|
|
| Firing alerts | `[]Alert` | List of all firing alerts in this notification | `There are {{ len .Alerts.Firing }} firing alerts` |
|
|
| Resolved alerts | `[]Alert` | List of all resolved alerts in this notification | `There are {{ len .Alerts.Resolved }} resolved alerts` |
|
|
| GroupLabels | `KV` | The labels that group these alerts in this | `{{ .GroupLabels }}` |
|
|
| CommonLabels | `KV` | The labels common to all alerts in this notification | `{{ .CommonLabels }}` |
|
|
| CommonAnnotations | `KV` | The annotations common to all alerts in this notification | `{{ .CommonAnnotations }}` |
|
|
| ExternalURL | `string` | A link to Grafana, or the Alertmanager that sent this notification if using an external Alertmanager | `{{ .ExternalURL }}` |
|
|
|
|
### KV
|
|
|
|
`KV` is a set of key value pairs, where each key and value is a string. If a KV happens to contain numbers or bools then these are string representations of the numeric or boolean value.
|
|
|
|
Here is an example of a KV, the annotations of an alert:
|
|
|
|
```yaml
|
|
summary: 'A summary of the alert'
|
|
description: 'A description of the alert'
|
|
```
|
|
|
|
In addition to iterating over each key value pair, you can sort the pairs, remove keys, and iterate over just the keys or the values.
|
|
|
|
| Name | Description | Arguments | Returns | Example |
|
|
| ----------- | ---------------------------------------------- | --------- | ------- | ------------------------------------- |
|
|
| SortedPairs | Sorts | | | `{{ .Annotations.SortedPairs }}` |
|
|
| Remove | Returns a copy of the KV with the keys removed | []string | | `{{ .Annotations.Remove "summary" }}` |
|
|
| Names | A list of the names | | | `{{ .Names }}` |
|
|
| Values | A list of the values | | | `{{ .Values }}` |
|
|
|
|
### Time
|
|
|
|
Time is from the Go [`time`](https://pkg.go.dev/time#Time) package. You can print a time in a number of different formats. For example, to print the time that an alert fired in the format `Monday, 1st January 2022 at 10:00AM` you would write the following template:
|
|
|
|
```
|
|
{{ .StartsAt.Format "Monday, 2 January 2006 at 3:04PM" }}
|
|
```
|
|
|
|
You can find a reference for Go's time format [here](https://pkg.go.dev/time#pkg-constants).
|