mirror of
https://github.com/grafana/grafana.git
synced 2025-07-28 02:52:13 +08:00
b8c4126fbc
* Update `Configure notifications` * wip notification policies * Finish Create Notification Policy * Minor update to Contact point intro * Fix `How label matching works` links and remove links from contact point intro * Silences and Mute timings * Reorder + MuteTimings + Silences * Complete Create silence * fix mispell * Update docs/sources/alerting/configure-notifications/_index.md Co-authored-by: brendamuir <100768211+brendamuir@users.noreply.github.com> * Update docs/sources/alerting/configure-notifications/_index.md Co-authored-by: brendamuir <100768211+brendamuir@users.noreply.github.com> * Update docs/sources/alerting/configure-notifications/_index.md Co-authored-by: brendamuir <100768211+brendamuir@users.noreply.github.com> * Update docs/sources/alerting/configure-notifications/_index.md Co-authored-by: brendamuir <100768211+brendamuir@users.noreply.github.com> * fix prettier error --------- Co-authored-by: brendamuir <100768211+brendamuir@users.noreply.github.com>
89 lines
4.8 KiB
Markdown
89 lines
4.8 KiB
Markdown
---
|
|
canonical: https://grafana.com/docs/grafana/latest/alerting/configure-notifications
|
|
description: Configure how, when, and where to send your alert notifications
|
|
keywords:
|
|
- grafana
|
|
- alert
|
|
- notifications
|
|
labels:
|
|
products:
|
|
- cloud
|
|
- enterprise
|
|
- oss
|
|
menuTitle: Configure notifications
|
|
title: Configure notifications
|
|
weight: 125
|
|
refs:
|
|
intro-notifications:
|
|
- pattern: /docs/grafana/
|
|
destination: /docs/grafana/<GRAFANA_VERSION>/alerting/fundamentals/notifications/
|
|
- pattern: /docs/grafana-cloud/
|
|
destination: /docs/grafana-cloud/alerting-and-irm/alerting/fundamentals/notifications/
|
|
configure-contact-points:
|
|
- pattern: /docs/grafana/
|
|
destination: /docs/grafana/<GRAFANA_VERSION>/alerting/configure-notifications/manage-contact-points/
|
|
- pattern: /docs/grafana-cloud/
|
|
destination: /docs/grafana-cloud/alerting-and-irm/alerting/configure-notifications/manage-contact-points/
|
|
configure-notification-policies:
|
|
- pattern: /docs/grafana/
|
|
destination: /docs/grafana/<GRAFANA_VERSION>/alerting/configure-notifications/create-notification-policy/
|
|
- pattern: /docs/grafana-cloud/
|
|
destination: /docs/grafana-cloud/alerting-and-irm/alerting/configure-notifications/create-notification-policy/
|
|
configure-templates:
|
|
- pattern: /docs/grafana/
|
|
destination: /docs/grafana/<GRAFANA_VERSION>/alerting/configure-notifications/template-notifications/
|
|
- pattern: /docs/grafana-cloud/
|
|
destination: /docs/grafana-cloud/alerting-and-irm/alerting/configure-notifications/template-notifications/
|
|
configure-silences:
|
|
- pattern: /docs/grafana/
|
|
destination: /docs/grafana/<GRAFANA_VERSION>/alerting/configure-notifications/create-silence/
|
|
- pattern: /docs/grafana-cloud/
|
|
destination: /docs/grafana-cloud/alerting-and-irm/alerting/configure-notifications/create-silence/
|
|
configure-mute-timings:
|
|
- pattern: /docs/grafana/
|
|
destination: /docs/grafana/<GRAFANA_VERSION>/alerting/configure-notifications/mute-timings/
|
|
- pattern: /docs/grafana-cloud/
|
|
destination: /docs/grafana-cloud/alerting-and-irm/alerting/configure-notifications/mute-timings/
|
|
---
|
|
|
|
# Configure notifications
|
|
|
|
Configuring how, when, and where to send alert notifications is an essential part of your alerting system.
|
|
|
|
By default, Grafana Alerting provides default notification messages with relevant alert information, so you don't need to configure messages initially. In the alert rule, you need to configure how to forward alerts:
|
|
|
|
1. Directly to a contact point.
|
|
2. To a contact point via notification policies (more flexible).
|
|
|
|
{{< figure src="/media/docs/alerting/alerting-configure-notifications-v2.png" max-width="750px" alt="In the alert rule, you can configure alert forwarding directly to a contact point or through notification policies" >}}
|
|
|
|
Notification setup is essential for an effective alerting system to scale across multiple teams and services. For a quick overview about the various components involved in handling notifications, refer to the [introduction about notifications](ref:intro-notifications).
|
|
|
|
The topics in this section include step-by-step instructions for:
|
|
|
|
- [Configuring contact points](ref:configure-contact-points) to specify where to receive alert notifications.
|
|
- [Configuring notification policies](ref:configure-notification-policies) to determine how alerts are routed to contact points.
|
|
- [Templating notifications](ref:configure-templates) to customize notification messages.
|
|
- [Configuring silences](ref:configure-silences) or [mute timings](ref:configure-mute-timings) to stop notifications.
|
|
|
|
## Alertmanager architecture
|
|
|
|
Grafana Alerting is based on the Prometheus Alerting model, whose architecture decouples rule evaluation from notification handling.
|
|
|
|
- The alert rule evaluator, either Grafana or the data source, evaluates alert rules and triggers alerts.
|
|
- The alert notification manager, known as the **Alertmanager**, receives alerts and manages their notifications.
|
|
|
|
{{< figure src="/media/docs/alerting/alerting-alertmanager-architecture.png" max-width="750px" alt="A diagram with the alert generator and alert manager architecture" >}}
|
|
|
|
In Grafana, you can use different types of alert rules and configure multiple Alertmanagers.
|
|
|
|
By default, Grafana uses its built-in Alertmanager, and Grafana Cloud instances include an additional Alertmanager.
|
|
|
|
{{< figure src="/media/docs/alerting/alerting-choose-alertmanager.png" max-width="750px" alt="A screenshot choosing an Alertmanager in the notification policies UI" >}}
|
|
|
|
When having multiple Alertmanagers, note that each Alertmanager manages its own independent notification resources, such as contact points, templates, policies, silences, mute timings, and active notifications.
|
|
|
|
These notification resources cannot be shared across different Alertmanagers.
|
|
|
|
Use the **Choose Alertmanager** dropdown to select the Alertmanager you want to configure.
|