Menu

This is documentation for the next version of Grafana. For the latest stable release, go to the latest version.

Grafana Cloud Enterprise Open source RSS

Notifications

Choosing how, when, and where to send your alert notifications is an important part of setting up your alerting system. These decisions have a direct impact on your team’s ability to receive the necessary information to resolve issues quickly and minimize alert noise.

Start defining your contact points to specify how to receive your alert notifications. Then, configure your alert rules to send their alerts to either a contact point or use the Notification Policy Tree to flexibly route alerts to contact points.


Configure alert rules to forward firing alerts directly to a contact point or through notification policies
Configure alert rules to forward firing alerts directly to a contact point or through notification policies

How it works at a glance

  • Grafana alerting periodically evaluates your alert rules and triggers notifications for firing and resolved alert instances.
  • You can configure the alert rule to send notifications to a contact point or route them via Notification Policies for greater flexibility.
  • To minimize alert noise, group similar alerts into a single notification by grouping alert labels and notification timings.

Fundamentals

Contact points

Contact points contain the configuration for sending alert notifications, specifying destinations like email, Slack, OnCall, webhooks, and their notification messages.

A contact point is a list of integrations, each sending a message to a specific destination.

By default, notification messages include common alert details, such as the number of alerts, alert names, labels, annotations, and other alert information. You can also customize notification messages and use notification templates.

First, create the contact point and test the notifications. Then, configure the alert rule to send its notifications to either a contact point or through Notification Policies.

Notification policies

Notification policies are the backbone of a comprehensive alerting system. They provide a flexible and effective method to route alerts to distinct contact points, helping reduce alert noise while ensuring no alerts are missed.

The notification policy tree is responsible for:

  • Defining nested policies that can inherit or overwrite parent notification settings.
  • Routing alerts by matching alert labels to the appropriate notification policy.
A diagram displaying how the notification policy tree routes alerts

Each notification policy handles specific tasks:

  • Deciding which contact point receives the alert notification.
  • Controlling when to send notifications based on its notification timing options.
  • Grouping multiple alerts into a single notification to reduce alert noise.
A diagram of the notification policy component

Group alert notifications

When something fails in our system, our alerting setup can easily trigger hundreds or even thousands of alert instances (notifications). Several alert rules often fail simultaneously. Additionally, each alert rule may generate multiple alert instances.

Grouping alert notifications is commonly necessary to avoid bombarding our alert inbox. Grouping combines similar alert instances in a given period into one single notification.

Notification grouping uses:

  • Labels: Group alert instances of the same type by using labels.
  • Timing options: Wait for a specified period before sending the notification, allowing for the grouping of incoming alert instances.

Templates, silences and mute timings

Grafana Alerting provides advanced notification capabilities that you’ll find useful as you and your team refine your initial alerting system.

For instance, you can customize notifications with shared templates that provide actionable alert information and can be reused for multiple notifications.

Additionally, you can use silences and mute timings to pause notifications for a given time window or at regular intervals, respectively.

Architecture

Grafana Alerting is based on the Prometheus model for designing alerting systems. Its architecture decouples the alert generator from the alert notification manager (known as the Alertmanager) to enhance scalability and performance.

A diagram with the alert generator and alert manager architecture

Grafana uses a custom Alertmanager to manage and deliver alert notifications, as detailed in this guide. This custom Alertmanager extends the capabilities of the Prometheus Alertmanager.

If you already run a Prometheus Alertmanager instance, you can configure Grafana Alerting to forward alerts to your external Alertmanager for handling notifications.