mirror of
https://github.com/grafana/grafana.git
synced 2025-07-29 15:02:28 +08:00

* 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>
80 lines
4.1 KiB
Markdown
80 lines
4.1 KiB
Markdown
---
|
|
aliases:
|
|
- ../silences/create-silence/ # /docs/grafana/<GRAFANA_VERSION>/alerting/silences/create-silence/
|
|
- ../silences/edit-silence/ # /docs/grafana/<GRAFANA_VERSION>/alerting/silences/edit-silence/
|
|
- ../silences/linking-to-silence-form/ # /docs/grafana/<GRAFANA_VERSION>/alerting/silences/linking-to-silence-form/
|
|
- ../silences/remove-silence/ # /docs/grafana/<GRAFANA_VERSION>/alerting/silences/remove-silence/
|
|
- ../unified-alerting/silences/ # /docs/grafana/<GRAFANA_VERSION>/alerting/unified-alerting/silences/
|
|
- ../silences/ # /docs/grafana/<GRAFANA_VERSION>/alerting/silences/
|
|
- ../manage-notifications/create-silence/ # /docs/grafana/<GRAFANA_VERSION>/alerting/manage-notifications/create-silence/
|
|
canonical: https://grafana.com/docs/grafana/latest/alerting/configure-notifications/create-silence/
|
|
description: Create silences to stop notifications from getting created for a specified window of time
|
|
keywords:
|
|
- grafana
|
|
- alerting
|
|
- silence
|
|
- mute
|
|
labels:
|
|
products:
|
|
- cloud
|
|
- enterprise
|
|
- oss
|
|
title: Configure silences
|
|
weight: 440
|
|
---
|
|
|
|
# Configure silences
|
|
|
|
Silences stop notifications from getting created and last for only a specified window of time.
|
|
|
|
{{< admonition type="note" >}}
|
|
|
|
- Inhibition rules are not supported in the Grafana Alertmanager.
|
|
- The preview of silenced alerts only applies to alerts in firing state.
|
|
{{< /admonition >}}
|
|
|
|
## Add silences
|
|
|
|
To add a silence, complete the following steps.
|
|
|
|
1. In the left-side menu, click **Alerts & IRM** and then **Alerting**.
|
|
1. Click **Silences**.
|
|
1. From the **Alertmanager** dropdown, select an external Alertmanager to create and manage silences for the external data source. Otherwise, keep the default option of Grafana.
|
|
1. Click **Create silence** to open the Create silence page.
|
|
1. In **Silence start and end**, select the start and end date to indicate when the silence should go into effect and expire.
|
|
1. Optionally, in **Duration**, specify how long the silence is enforced. This automatically updates the end time in the **Silence start and end** field.
|
|
1. In the **Label** and **Value** fields, enter one or more _Matching Labels_. Matchers determine which rules the silence will apply to. Any matching alerts (in firing state) will show in the **Affected alert instances** field
|
|
1. In **Comment**, add details about the silence.
|
|
1. Click **Submit**.
|
|
|
|
## Edit silences
|
|
|
|
To edit a silence, complete the following steps.
|
|
|
|
1. In the left-side menu, click **Alerts & IRM** and then **Alerting**.
|
|
1. Click **Silences** to view the list of existing silences.
|
|
1. Find the silence you want to edit, then click **Edit** (pen icon).
|
|
1. Make the desired changes, then click **Submit** to save your changes.
|
|
|
|
## Create a URL to link to a silence form
|
|
|
|
When linking to a silence form, provide the default matching labels and comment via `matcher` and `comment` query parameters. The `matcher` parameter should be in the following format `[label][operator][value]` where the `operator` parameter can be one of the following: `=` (equals, not regex), `!=` (not equals, not regex), `=~` (equals, regex), `!~` (not equals, regex).
|
|
The URL can contain many query parameters with the key `matcher`.
|
|
For example, to link to silence form with matching labels `severity=critical` & `cluster!~europe-.*` and comment `Silence critical EU alerts`, create a URL `https://mygrafana/alerting/silence/new?matcher=severity%3Dcritical&matcher=cluster!~europe-*&comment=Silence%20critical%20EU%20alert`.
|
|
|
|
To link to a new silence page for an external Alertmanager, add a `alertmanager` query parameter with the Alertmanager data source name.
|
|
|
|
## Remove silences
|
|
|
|
To remove a silence, complete the following steps.
|
|
|
|
1. In the left-side menu, click **Alerts & IRM** and then **Alerting**.
|
|
1. Click **Silences** to view the list of existing silences.
|
|
1. Select the silence you want to end, then click **Unsilence**.
|
|
|
|
> **Note:** You cannot remove a silence manually. Silences that have ended are retained and listed for five days.
|
|
|
|
## Useful links
|
|
|
|
[Aggregation operators](https://prometheus.io/docs/prometheus/latest/querying/operators/#aggregation-operators)
|