Files
grafana/docs/sources/alerting/add-notification-template.md
Will Browne c9da053e5d Alerting: Evaluate data templating in alert rule name and message (#29908)
* evaluate Go style template

* inlince func

* add test case

* PR feedback and add tests for templte data map func

* Add test case

Signed-off-by: Arve Knudsen <arve.knudsen@gmail.com>

* do regex check

* ensure ecape

* small cleanup

* dont exit on template execution errors

* add info tooltip

* add docs

* switch from go tmpl to regex

* update docs/comments

* update tooltip wording

* update docs wording

* add simple test

* avoid .MustCompile

* point to labels in docs

* update docs

* fix docs links

* remove line

* fix lint

* add note about multiple labels

* propagate labels for CM

* update docs

* remove whitespace

* update task title

* update docs

* pr feedback

Co-authored-by: Arve Knudsen <arve.knudsen@gmail.com>
2021-01-19 22:02:44 +01:00

1.4 KiB

+++ title = "Alert notification templating" keywords = ["grafana", "documentation", "alerting", "alerts", "notification", "templating"] weight = 110 +++

Alert notification templating

You can provide detailed information to alert notification recipients by injecting alert query data into an alert notification. This topic explains how you can use alert query labels in alert notifications.

Labels that exist from the evaluation of the alert query can be used in the alert rule name and in the alert notification message fields. The alert label data is injected into the notification fields when the alert is in the alerting state. When there are multiple unique values for the same label, the values are comma-separated.

This topic explains how you can use alert query labels in alert notifications.

Adding alert label data into your alert notification

  1. Navigate to the panel you want to add or edit an alert rule for.
  2. Click on the panel title, and then click Edit.
  3. On the Alert tab, click Create Alert. If an alert already exists for this panel, then you can edit the alert directly.
  4. Refer to the alert query labels in the alert rule name and/or alert notification message field by using the ${Label} syntax.
  5. Click Save in the upper right corner to save the alert rule and the dashboard.

Alerting notification template