

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# Gérez vos alertes
<a name="v10-alerting-manage"></a>

****  
**Cette rubrique de documentation est conçue pour les espaces de travail Grafana qui prennent en charge la version 10.x de Grafana.**  
Pour les espaces de travail Grafana compatibles avec la version 9.x de Grafana, voir. [Travailler dans la version 9 de Grafana](using-grafana-v9.md)  
Pour les espaces de travail Grafana compatibles avec la version 8.x de Grafana, voir. [Travailler dans la version 8 de Grafana](using-grafana-v8.md)

Une fois que vous avez défini vos règles d'alerte, vos points de contact et vos politiques de notification, vous pouvez utiliser les alertes Grafana pour gérer vos alertes dans la pratique.

**Topics**
+ [Personnaliser les notifications](v10-alerting-manage-notifications.md)
+ [Gérer les points de contact](v10-alerting-manage-contactpoints.md)
+ [Désactiver les notifications d'alerte](v10-alerting-silences.md)
+ [Afficher et filtrer les règles d'alerte](v10-alerting-manage-rules-viewfilter.md)
+ [Horaire du mode muet](v10-alerting-manage-muting.md)
+ [Afficher l'état et l'état des règles d'alerte](v10-alerting-manage-rulestate.md)
+ [Afficher et filtrer par groupes d'alertes](v10-alerting-manage-viewfiltergroups.md)
+ [Afficher les erreurs de notification](v10-alerting-manage-viewnotificationerrors.md)

# Personnaliser les notifications
<a name="v10-alerting-manage-notifications"></a>

****  
**Cette rubrique de documentation est conçue pour les espaces de travail Grafana qui prennent en charge la version 10.x de Grafana.**  
Pour les espaces de travail Grafana compatibles avec la version 9.x de Grafana, voir. [Travailler dans la version 9 de Grafana](using-grafana-v9.md)  
Pour les espaces de travail Grafana compatibles avec la version 8.x de Grafana, voir. [Travailler dans la version 8 de Grafana](using-grafana-v8.md)

Personnalisez vos notifications à l'aide de modèles de notifications.

Vous pouvez utiliser des modèles de notification pour modifier le titre, le message et le format du message dans vos notifications.

Les modèles de notification ne sont pas liés à des intégrations de points de contact spécifiques, telles qu'Amazon SNS ou Slack. Vous pouvez toutefois choisir de créer des modèles de notification distincts pour les différentes intégrations de points de contact.

Vous pouvez utiliser des modèles de notification pour :
+ Ajoutez, supprimez ou réorganisez les informations dans la notification, notamment le résumé, la description, les étiquettes et les annotations, les valeurs et les liens
+ Mettre en forme le texte en gras et en italique, et ajouter ou supprimer des sauts de ligne

Vous ne pouvez pas utiliser de modèles de notification pour :
+ Modifier le design des notifications dans les services de messagerie instantanée tels que Slack et Microsoft Teams

**Topics**
+ [Utilisation du langage de création de modèles de Go](v10-alerting-notifications-go-templating.md)
+ [Création de modèles de notification](v10-alerting-create-templates.md)
+ [Utilisation de modèles de notification](#v10-alerting-use-notification-templates)
+ [Référence de modèles](v10-alerting-template-reference.md)

# Utilisation du langage de création de modèles de Go
<a name="v10-alerting-notifications-go-templating"></a>

****  
**Cette rubrique de documentation est conçue pour les espaces de travail Grafana qui prennent en charge la version 10.x de Grafana.**  
Pour les espaces de travail Grafana compatibles avec la version 9.x de Grafana, voir. [Travailler dans la version 9 de Grafana](using-grafana-v9.md)  
Pour les espaces de travail Grafana compatibles avec la version 8.x de Grafana, voir. [Travailler dans la version 8 de Grafana](using-grafana-v8.md)

Vous rédigez des modèles de notification dans le langage de modélisation de Go, [texte/modèle](https://pkg.go.dev/text/template).

Cette section fournit un aperçu du langage de création de modèles de Go et des modèles d'écriture sous forme de texte/modèle.

## Point
<a name="v10-go-dot"></a>

 text/template Il y a un curseur spécial appelé point, écrit sous la forme`.`. Vous pouvez considérer ce curseur comme une variable dont la valeur change en fonction de l'endroit où il est utilisé dans le modèle. Par exemple, au début d'un modèle de notification, il `.` fait référence à l'`ExtendedData`objet, qui contient un certain nombre de champs`Alerts`, notamment`Status`,`GroupLabels`,`CommonLabels`, `CommonAnnotations` et`ExternalURL`. Cependant, le point peut faire référence à autre chose lorsqu'il est utilisé dans `range` une liste, lorsqu'il est utilisé dans un `with` ou lors de la rédaction de modèles de fonctionnalités à utiliser dans d'autres modèles. Vous pouvez en voir des exemples dans[Création de modèles de notification](v10-alerting-create-templates.md), ainsi que toutes les données et fonctions du[Référence de modèles](v10-alerting-template-reference.md).

## Étiquettes d'ouverture et de fermeture
<a name="v10-go-openclosetags"></a>

Dans le texte/le modèle, les modèles commencent par `{{` et se terminent par`}}`, qu'ils impriment une variable ou exécutent des structures de contrôle telles que des instructions if. Ceci est différent des autres langages de modélisation tels que Jinja où l'impression d'une variable utilise `{{` et et où les structures de contrôle utilisent `}}` `{%` et. `%}`

## Print
<a name="v10-go-print"></a>

Pour imprimer la valeur d'un élément, utilisez `{{` et`}}`. Vous pouvez imprimer la valeur d'un point, un champ de points, le résultat d'une fonction et la valeur d'une [variable](#v10-go-variables). Par exemple, pour imprimer le `Alerts` champ où le point fait référence, `ExtendedData` vous devez écrire ce qui suit :

```
{{ .Alerts }}
```

## Répéter les alertes
<a name="v10-go-iterate-alerts"></a>

Pour imprimer uniquement les étiquettes de chaque alerte, plutôt que toutes les informations relatives à l'alerte, vous pouvez utiliser a `range` pour itérer les alertes dans `ExtendedData` :

```
{{ range .Alerts }}
{{ .Labels }}
{{ end }}
```

À l'intérieur de la plage, le point ne fait plus référence à`ExtendedData`, mais à un`Alert`. Vous pouvez l'utiliser `{{ .Labels }}` pour imprimer les étiquettes de chaque alerte. Cela fonctionne car le point `{{ range .Alerts }}` change pour faire référence à l'alerte en cours dans la liste des alertes. Lorsque la plage est terminée, le point est remis à la valeur qu'il avait avant le début de la plage, qui dans cet exemple est `ExtendedData` :

```
{{ range .Alerts }}
{{ .Labels }}
{{ end }}
{{/* does not work, .Labels does not exist here */}}
{{ .Labels }}
{{/* works, cursor was reset */}}
{{ .Status }}
```

## Répéter sur les annotations et les étiquettes
<a name="v10-go-iterate-labels"></a>

Rédigons un modèle pour imprimer les étiquettes de chaque alerte au format`The name of the label is $name, and the value is $value`, où `$name` et `$value` contenant le nom et la valeur de chaque étiquette.

Comme dans l'exemple précédent, utilisez une plage pour parcourir les alertes de `.Alerts` manière à ce que le point fasse référence à l'alerte en cours dans la liste des alertes, puis utilisez une deuxième plage sur les étiquettes triées afin que le point soit mis à jour une deuxième fois pour faire référence à l'étiquette actuelle. Dans la deuxième plage, utilisez `.Name` et `.Value` pour imprimer le nom et la valeur de chaque étiquette :

```
{{ range .Alerts }}
{{ range .Labels.SortedPairs }}
The name of the label is {{ .Name }}, and the value is {{ .Value }}
{{ end }}
{{ range .Annotations.SortedPairs }}
The name of the annotation is {{ .Name }}, and the value is {{ .Value }}
{{ end }}
{{ end }}
```

## Les fonctions d'index
<a name="v10-go-index"></a>

Pour imprimer une annotation ou une étiquette spécifique, utilisez la `index` fonction.

```
{{ range .Alerts }}
The name of the alert is {{ index .Labels "alertname" }}
{{ end }}
```

## Si des déclarations
<a name="v10-go-if"></a>

Vous pouvez utiliser des instructions if dans les modèles. Par exemple, pour imprimer `There are no alerts` s'il n'y a aucune alerte, `.Alerts` vous devez écrire ce qui suit :

```
{{ if .Alerts }}
There are alerts
{{ else }}
There are no alerts
{{ end }}
```

## Avec
<a name="v10-go-with"></a>

with est similaire aux instructions if, mais contrairement aux instructions if, `with` met à jour le point pour faire référence à la valeur du with :

```
{{ with .Alerts }}
There are {{ len . }} alert(s)
{{ else }}
There are no alerts
{{ end }}
```

## Variables
<a name="v10-go-variables"></a>

Les variables text/template doivent être créées dans le modèle. Par exemple, pour créer une variable appelée `$variable` avec la valeur actuelle de point, vous devez écrire ce qui suit :

```
{{ $variable := . }}
```

Vous pouvez `$variable` l'utiliser à l'intérieur d'une plage ou `with` cela fera référence à la valeur du point au moment où la variable a été définie, et non à la valeur actuelle du point.

Par exemple, vous ne pouvez pas écrire un modèle `{{ .Labels }}` à utiliser dans la deuxième plage car ici, le point fait référence à l'étiquette actuelle, et non à l'alerte en cours :

```
{{ range .Alerts }}
{{ range .Labels.SortedPairs }}
{{ .Name }} = {{ .Value }}
{{/* does not work because in the second range . is a label not an alert */}}
There are {{ len .Labels }}
{{ end }}
{{ end }}
```

Vous pouvez résoudre ce problème en définissant une variable appelée `$alert` dans la première plage et avant la deuxième plage :

```
{{ range .Alerts }}
{{ $alert := . }}
{{ range .Labels.SortedPairs }}
{{ .Name }} = {{ .Value }}
{{/* works because $alert refers to the value of dot inside the first range */}}
There are {{ len $alert.Labels }}
{{ end }}
{{ end }}
```

## Gamme avec index
<a name="v10-go-rangeindex"></a>

Vous pouvez obtenir l'indice de chaque alerte au sein d'une plage en définissant des variables d'indice et de valeur au début de la plage :

```
{{ $num_alerts := len .Alerts }}
{{ range $index, $alert := .Alerts }}
This is alert {{ $index }} out of {{ $num_alerts }}
{{ end }}
```

## Définir des modèles
<a name="v10-go-define"></a>

Vous pouvez définir des modèles qui peuvent être utilisés dans d'autres modèles, `define` en utilisant le nom du modèle entre guillemets. Vous ne devez pas définir de modèles portant le même nom que les autres modèles, y compris les modèles par défaut tels que `__subject``__text_values_list`,`__text_alert_list`, `default.title` et`default.message`. Lorsqu'un modèle a été créé avec le même nom qu'un modèle par défaut, ou un modèle dans un autre modèle de notification, Grafana peut utiliser l'un ou l'autre modèle. Grafana n'empêche pas ou n'affiche pas de message d'erreur lorsqu'il existe deux modèles ou plus portant le même nom.

```
{{ define "print_labels" }}
{{ end }}
```

## Exécuter des modèles
<a name="v10-go-execute"></a>

Vous pouvez exécuter un modèle défini dans votre modèle en utilisant `template` le nom du modèle entre guillemets et le curseur qui doit être passé au modèle :

```
{{ template "print_labels" . }}
```

## Transmettre les données aux modèles
<a name="v10-go-passdata"></a>

Dans un modèle, le point fait référence à la valeur transmise au modèle.

Par exemple, si une liste d'alertes de déclenchement est transmise à un modèle, le point fait référence à cette liste d'alertes de déclenchement :

```
{{ template "print_alerts" .Alerts }}
```

Si le modèle reçoit les libellés triés d'une alerte, le point fait référence à la liste des libellés triés :

```
{{ template "print_labels" .SortedLabels }}
```

Cela est utile lors de la rédaction de modèles réutilisables. Par exemple, pour imprimer toutes les alertes, vous pouvez écrire ce qui suit :

```
{{ template "print_alerts" .Alerts }}
```

Ensuite, pour imprimer uniquement les alertes de déclenchement, vous pouvez écrire ceci :

```
{{ template "print_alerts" .Alerts.Firing }}
```

Cela fonctionne car `.Alerts` les deux `.Alerts.Firing` sont des listes d'alertes.

```
{{ define "print_alerts" }}
{{ range . }}
{{ template "print_labels" .SortedLabels }}
{{ end }}
{{ end }}
```

## Commentaires
<a name="v10-go-comments"></a>

Vous pouvez ajouter des commentaires avec `{{/*` et `*/}}` :

```
{{/* This is a comment */}}
```

Pour empêcher les commentaires d'ajouter des sauts de ligne, utilisez :

```
{{- /* This is a comment with no leading or trailing line breaks */ -}}
```

## Indentation
<a name="v10-go-indentation"></a>

Vous pouvez utiliser l'indentation, à la fois des tabulations et des espaces, ainsi que des sauts de ligne, pour rendre les modèles plus lisibles :

```
{{ range .Alerts }}
  {{ range .Labels.SortedPairs }}
    {{ .Name }} = {{ .Value }}
  {{ end }}
{{ end }}
```

Cependant, l'indentation du modèle sera également présente dans le texte. Ensuite, nous verrons comment le supprimer.

## Supprimer les espaces et les sauts de ligne
<a name="v10-go-removespace"></a>

En cours text/template d'utilisation `{{-` et `-}}` pour supprimer les espaces de début et de fin et les sauts de ligne.

Par exemple, lorsque vous utilisez l'indentation et les sauts de ligne pour rendre un modèle plus lisible :

```
{{ range .Alerts }}
  {{ range .Labels.SortedPairs }}
    {{ .Name }} = {{ .Value }}
  {{ end }}
{{ end }}
```

L'indentation et les sauts de ligne seront également présents dans le texte :

```
    alertname = "Test"

    grafana_folder = "Test alerts"
```

Vous pouvez supprimer l'indentation et les sauts de ligne du texte en le `}}` remplaçant par le `-}}` début de chaque plage :

```
{{ range .Alerts -}}
  {{ range .Labels.SortedPairs -}}
    {{ .Name }} = {{ .Value }}
  {{ end }}
{{ end }}
```

L'indentation et les sauts de ligne du modèle sont désormais absents du texte :

```
alertname = "Test"
grafana_folder = "Test alerts"
```

# Création de modèles de notification
<a name="v10-alerting-create-templates"></a>

****  
**Cette rubrique de documentation est conçue pour les espaces de travail Grafana qui prennent en charge la version 10.x de Grafana.**  
Pour les espaces de travail Grafana compatibles avec la version 9.x de Grafana, voir. [Travailler dans la version 9 de Grafana](using-grafana-v9.md)  
Pour les espaces de travail Grafana compatibles avec la version 8.x de Grafana, voir. [Travailler dans la version 8 de Grafana](using-grafana-v8.md)

Créez des modèles de notification réutilisables à envoyer à vos points de contact.

Vous pouvez ajouter un ou plusieurs modèles à votre modèle de notification.

Le nom de votre modèle de notification doit être unique. Vous ne pouvez pas avoir deux modèles portant le même nom dans le même modèle de notification ou dans des modèles de notification différents. Évitez de définir des modèles portant le même nom que les modèles par défaut, tels que : `__subject``__text_values_list`,`__text_alert_list`, `default.title` et`default.message`.

Dans l'onglet Points de contact, vous pouvez voir la liste de vos modèles de notification.

## Création de modèles de notification
<a name="v10-alerting-creating-templates"></a>

**Pour créer un modèle de notification**

1. Choisissez **Alerte**, **Points de contact.**

1. Cliquez sur l'onglet **Modèles de notification**, puis sur **\$1 Ajouter un modèle de notification**.

1. Choisissez un nom pour le modèle de notification, par exemple`email.subject`.

1. Écrivez le contenu du modèle dans le champ de contenu.

   Par exemple :

   ```
   {{ if .Alerts.Firing -}}
      {{ len .Alerts.Firing }} firing alerts
      {{ end }}
      {{ if .Alerts.Resolved -}}
      {{ len .Alerts.Resolved }} resolved alerts
      {{ end }}
   ```

1. Enregistrez vos modifications.

   `{{ define "email.subject" }}`(où `email.subject` est le nom de votre modèle) et `{{ end }}` est automatiquement ajouté au début et à la fin du contenu.

**Pour créer un modèle de notification contenant plusieurs modèles**

1. Choisissez **Alerte**, **Points de contact.**

1. Cliquez sur l'onglet **Modèles de notification**, puis sur **\$1 Ajouter un modèle de notification**.

1. Entrez un nom pour le modèle de notification global. Par exemple, `email`.

1. Écrivez chaque modèle dans le champ Contenu, y compris `{{ define "name-of-template" }}` `{{ end }}` au début et à la fin de chaque modèle. Vous pouvez utiliser des noms descriptifs pour chacun des modèles du modèle de notification, par exemple, `email.subject` ou`email.message`. Dans ce cas, ne réutilisez pas le nom du modèle de notification que vous avez saisi ci-dessus.

   Les sections suivantes présentent des exemples détaillés de modèles que vous pourriez créer.

1. Cliquez sur Sauvegarder

## Afficher un aperçu des modèles de notification
<a name="v10-alerting-preview-templates"></a>

Prévisualisez l'apparence de vos modèles de notification avant de les utiliser dans vos points de contact, afin de comprendre le résultat du modèle que vous créez et de corriger les erreurs éventuelles avant de l'enregistrer.

**Note**  
Les aperçus des notifications ne sont disponibles que pour Grafana Alertmanager.

**Pour prévisualiser vos modèles de notification**

1. Choisissez **Alerte**, **Points de contact.**

1. Choisissez l'onglet **Modèles de notification**, puis **\$1 Ajouter un modèle de notification** ou modifiez un modèle existant.

1. Ajoutez ou mettez à jour le contenu de votre modèle.

   Les données par défaut sont fournies et vous pouvez y ajouter ou modifier des données d'alerte ainsi que des instances d'alerte. Vous pouvez ajouter des données d'alerte directement dans la fenêtre de données de charge utile elle-même, ou cliquer sur **Sélectionner des instances d'alerte** ou sur **Ajouter des alertes personnalisées**.

1. [Facultatif] Pour ajouter des données d'alerte provenant d'instances d'alerte existantes :

   1. Choisissez **Sélectionner les instances d'alerte**.

   1. Passez le curseur sur les instances d'alerte pour afficher plus d'informations sur chaque instance d'alerte/

   1. Choisissez **Confirm** pour ajouter l'instance d'alerte à la charge utile.

1. [Facultatif] Pour ajouter des données d'alerte à l'aide de l'éditeur de données d'alerte, choisissez **Ajouter des données personnalisées** :

   1. Ajoutez des annotations, des étiquettes personnalisées ou définissez un tableau de bord ou un panneau.

   1. Activez le mode Déclenchement ou Résolu, selon que vous souhaitez ajouter des alertes déclenchées ou résolues à votre notification.

   1. Choisissez **Ajouter des données d'alerte**.

   1. Choisissez **Actualiser l'aperçu** pour voir à quoi ressemblera le contenu de votre modèle et les données de charge utile correspondantes.

   Si votre modèle contient des erreurs, elles sont affichées dans l'aperçu et vous pouvez les corriger avant de les enregistrer.

1. Enregistrez vos modifications.

## Création d'un modèle pour l'objet du message
<a name="v10-alerting-create-template-subject"></a>

Créez un modèle pour l'objet d'un e-mail contenant le nombre d'alertes déclenchées et résolues, comme dans cet exemple :

```
1 firing alerts, 0 resolved alerts
```

**Pour créer un modèle pour l'objet d'un e-mail**

1. Créez un modèle appelé `email.subject` avec le contenu suivant :

   ```
   {{ define "email.subject" }}
   {{ len .Alerts.Firing }} firing alerts, {{ len .Alerts.Resolved }} resolved alerts
   {{ end }}
   ```

1. Utilisez le modèle lors de la création de votre intégration de points de contact en le plaçant dans le champ **Objet** avec le `template` mot clé.

   ```
   {{ template "email.subject" . }}
   ```

## Création d'un modèle pour le message d'un e-mail
<a name="v10-alerting-create-template-message"></a>

Créez un modèle pour le message d'un e-mail contenant un résumé de toutes les alertes déclenchées et résolues, comme dans cet exemple :

```
There are 2 firing alerts, and 1 resolved alerts

Firing alerts:

- alertname=Test 1 grafana_folder=GrafanaCloud has value(s) B=1
- alertname=Test 2 grafana_folder=GrafanaCloud has value(s) B=2

Resolved alerts:

- alertname=Test 3 grafana_folder=GrafanaCloud has value(s) B=0
```

**Pour créer un modèle pour le message d'un e-mail**

1. Créez un modèle de notification appelé `email` avec deux modèles dans le contenu : `email.message_alert` et`email.message`.

   Le `email.message_alert` modèle est utilisé pour imprimer les étiquettes et les valeurs de chaque alerte déclenchée et résolue, tandis que le `email.message` modèle contient la structure de l'e-mail.

   ```
   {{- define "email.message_alert" -}}
   {{- range .Labels.SortedPairs }}{{ .Name }}={{ .Value }} {{ end }} has value(s)
   {{- range $k, $v := .Values }} {{ $k }}={{ $v }}{{ end }}
   {{- end -}}
   
   {{ define "email.message" }}
   There are {{ len .Alerts.Firing }} firing alerts, and {{ len .Alerts.Resolved }} resolved alerts
   
   {{ if .Alerts.Firing -}}
   Firing alerts:
   {{- range .Alerts.Firing }}
   - {{ template "email.message_alert" . }}
   {{- end }}
   {{- end }}
   
   {{ if .Alerts.Resolved -}}
   Resolved alerts:
   {{- range .Alerts.Resolved }}
   - {{ template "email.message_alert" . }}
   {{- end }}
   {{- end }}
   
   {{ end }}
   ```

1. Utilisez le modèle lors de la création de votre intégration de points de contact en le plaçant dans le champ **du corps du texte** avec le `template` mot clé.

   ```
   {{ template "email.message" . }}
   ```

## Création d'un modèle pour le titre d'un message Slack
<a name="v10-alerting-create-template-slack-title"></a>

Créez un modèle pour le titre d'un message Slack contenant le nombre d'alertes déclenchées et résolues, comme dans l'exemple suivant :

```
1 firing alerts, 0 resolved alerts
```

**Pour créer un modèle pour le titre d'un message Slack**

1. Créez un modèle appelé `slack.title` avec le contenu suivant :

   ```
   {{ define "slack.title" }}
   {{ len .Alerts.Firing }} firing alerts, {{ len .Alerts.Resolved }} resolved alerts
   {{ end }}
   ```

1. Exécutez le modèle à partir du champ de titre dans l'intégration de votre point de contact.

   ```
   {{ template "slack.title" . }}
   ```

## Création d'un modèle pour le contenu d'un message Slack
<a name="v10-alerting-create-template-slack-message"></a>

Créez un modèle pour le contenu d'un message Slack contenant une description de toutes les alertes déclenchées et résolues, y compris leurs étiquettes, leurs annotations et l'URL du tableau de bord.

**Note**  
Ce modèle est réservé aux alertes gérées par Grafana. Pour utiliser le modèle pour les alertes gérées par des sources de données, supprimez les références à DashboardUrl et SilenceURL. Pour plus d'informations sur la configuration des notifications Prometheus, consultez la documentation de [Prometheus](https://prometheus.io/docs/alerting/latest/notifications/) sur les notifications.

```
1 firing alerts:

[firing] Test1
Labels:
- alertname: Test1
- grafana_folder: GrafanaCloud
Annotations:
- description: This is a test alert
Go to dashboard: https://example.com/d/dlhdLqF4z?orgId=1

1 resolved alerts:

[firing] Test2
Labels:
- alertname: Test2
- grafana_folder: GrafanaCloud
Annotations:
- description: This is another test alert
Go to dashboard: https://example.com/d/dlhdLqF4z?orgId=1
```

**Pour créer un modèle pour le contenu d'un message Slack**

1. Créez un modèle appelé `slack` avec deux modèles dans le contenu : `slack.print_alert` et`slack.message`.

   Le `slack.print_alert` modèle est utilisé pour imprimer les étiquettes, les annotations et l'URL du tableau de bord tandis que le `slack.message` modèle contient la structure de la notification.

   ```
   {{ define "slack.print_alert" -}}
   [{{.Status}}] {{ .Labels.alertname }}
   Labels:
   {{ range .Labels.SortedPairs -}}
   - {{ .Name }}: {{ .Value }}
   {{ end -}}
   {{ if .Annotations -}}
   Annotations:
   {{ range .Annotations.SortedPairs -}}
   - {{ .Name }}: {{ .Value }}
   {{ end -}}
   {{ end -}}
   {{ if .DashboardURL -}}
     Go to dashboard: {{ .DashboardURL }}
   {{- end }}
   {{- end }}
   
   {{ define "slack.message" -}}
   {{ if .Alerts.Firing -}}
   {{ len .Alerts.Firing }} firing alerts:
   {{ range .Alerts.Firing }}
   {{ template "slack.print_alert" . }}
   {{ end -}}
   {{ end }}
   {{ if .Alerts.Resolved -}}
   {{ len .Alerts.Resolved }} resolved alerts:
   {{ range .Alerts.Resolved }}
   {{ template "slack.print_alert" .}}
   {{ end -}}
   {{ end }}
   {{- end }}
   ```

1. Exécutez le modèle à partir du champ du corps du texte lors de l'intégration de votre point de contact :

   ```
   {{ template "slack.message" . }}
   ```

## Modélisez à la fois vos e-mails et Slack avec des modèles partagés
<a name="v10-alerting-create-shared-templates"></a>

Au lieu de créer des modèles de notification distincts pour chaque point de contact, tels que les e-mails et Slack, vous pouvez partager le même modèle.

Par exemple, si vous souhaitez envoyer un e-mail avec cet objet et un message Slack avec ce titre`1 firing alerts, 0 resolved alerts`, vous pouvez créer un modèle partagé.

**Pour créer un modèle partagé**

1. Créez un modèle appelé `common.subject_title` avec le contenu suivant :

   ```
   {{ define "common.subject_title" }}
   {{ len .Alerts.Firing }} firing alerts, {{ len .Alerts.Resolved }} resolved alerts
   {{ end }}
   ```

1. Pour les e-mails, exécutez le modèle à partir du champ d'objet de l'intégration de votre point de contact e-mail :

   ```
   {{ template "common.subject_title" . }}
   ```

1. Pour Slack, exécutez le modèle à partir du champ de titre dans l'intégration de votre point de contact Slack :

   ```
   {{ template "common.subject_title" . }}
   ```

## Utilisation de modèles de notification
<a name="v10-alerting-use-notification-templates"></a>

Utilisez des modèles dans les points de contact pour personnaliser vos notifications.

**Pour utiliser un modèle lors de la création d'un point de contact**

1. Dans le menu **Alertes**, choisissez l'onglet **Points de contact** pour afficher la liste des points de contact existants.

1. Choisissez **Nouveau**. Vous pouvez également modifier un point de contact existant en cliquant sur l'icône **Modifier**.

1. Entrez les modèles que vous souhaitez utiliser dans un champ, tel que **Message** ou **Objet**. Pour saisir un modèle, utilisez le formulaire `{{ template "template_name" . }}` en le *template\$1name* remplaçant par le nom du modèle que vous souhaitez utiliser.

1. Choisissez **Enregistrer le point de contact**.

# Référence de modèles
<a name="v10-alerting-template-reference"></a>

****  
**Cette rubrique de documentation est conçue pour les espaces de travail Grafana compatibles avec la version 10.x de Grafana.**  
Pour les espaces de travail Grafana compatibles avec la version 9.x de Grafana, voir. [Travailler dans la version 9 de Grafana](using-grafana-v9.md)  
Pour les espaces de travail Grafana compatibles avec la version 8.x de Grafana, voir. [Travailler dans la version 8 de Grafana](using-grafana-v8.md)

Cette section fournit des informations de référence pour créer vos modèles.

**Alerte (type)**

Le type d'alerte contient les données suivantes.


| Name | Kind | Description | Exemple | 
| --- | --- | --- | --- | 
|  Statut  |  chaîne  |  `firing` ou `resolved`.  | \$1\$1 .Status \$1\$1 | 
|  Étiquettes  |  KeyValue  |  Ensemble d'étiquettes associées à l'alerte.  | \$1\$1 .Labels \$1\$1 | 
|  Annotations  |  KeyValue  |  Ensemble d'annotations associées à l'alerte.  | \$1\$1 .Annotations \$1\$1 | 
| Valeurs | KeyValue | Les valeurs de toutes les expressions, y compris les conditions classiques | \$1\$1 .Values \$1\$1 | 
|  StartsAt  |  Heure. Heure  |  Heure à laquelle l'alerte a commencé à se déclencher.  | \$1\$1 .StartsAt \$1\$1 | 
|  EndsAt  |  Heure. Heure  |  Paramétré uniquement si l'heure de fin d'une alerte est connue. Sinon, définissez un délai d'expiration configurable à compter de la date de réception de la dernière alerte.  | \$1\$1 .EndsAt \$1\$1 | 
|  URL du générateur  |  chaîne  |  Un lien de retour vers Grafana ou un Alertmanager externe.  | \$1\$1 .GeneratorURL \$1\$1 | 
|  URL de silence  |  chaîne  |  Un lien pour désactiver l'alerte (avec des étiquettes préremplies pour cette alerte). Uniquement pour les alertes gérées par Grafana.  | \$1\$1 .SilenceURL\$1\$1 | 
|  URL du tableau de bord  |  chaîne  |  Lien vers le tableau de bord de Grafana, si la règle d'alerte appartient à l'une d'entre elles. Uniquement pour les alertes gérées par Grafana.  | \$1\$1 .DashboardURL \$1\$1 | 
|  URL du panneau  |  chaîne  |  Lien vers le panneau du tableau de bord de Grafana, si la règle d'alerte appartient à l'une d'entre elles. Uniquement pour les alertes gérées par Grafana.  | \$1\$1 .PanelURL \$1\$1 | 
|  Empreinte  |  chaîne  |  Empreinte digitale qui peut être utilisée pour identifier l'alerte.  | \$1\$1 .Fingerprint \$1\$1 | 
|  ValueString  |  chaîne  |  Chaîne contenant les libellés et la valeur de chaque expression réduite de l'alerte.  | \$1\$1 .ValueString \$1\$1 | 

 **ExtendedData**

L' ExtendedData objet contient les propriétés suivantes.


| Name | Kind | Description | Exemple | 
| --- | --- | --- | --- | 
|  Récepteur  |  `string`  |  Nom du point de contact qui envoie la notification.  |  `{{ .Receiver }}`  | 
|  Statut  |  `string`  |  L'état indique `firing` si au moins une alerte est déclenchée, sinon`resolved`.  |  `{{ .Status }}`  | 
|  Alerts (Alertes)  |  `[]Alert`  |  Liste de toutes les alertes déclenchées et résolues dans cette notification.  |  `There are {{ len .Alerts }} alerts`  | 
|  Alertes de tir  |  `[]Alert`  |  Liste de toutes les alertes de tir contenues dans cette notification.  |  `There are {{ len .Alerts.Firing }} firing alerts`  | 
|  Alertes résolues  |  `[]Alert`  |  Liste de toutes les alertes résolues dans cette notification.  |  `There are {{ len .Alerts.Resolved }} resolved alerts`  | 
|  GroupLabels  |  `KeyValue`  |  Les étiquettes qui regroupent ces alertes dans cette notification.  |  `{{ .GroupLabels }}`  | 
|  CommonLabels  |  `KeyValue`  |  Les libellés communs à toutes les alertes de cette notification.  |  `{{ .CommonLabels }}`  | 
|  CommonAnnotations  |  `KeyValue`  |  Les annotations communes à toutes les alertes de cette notification.  |  `{{ .CommonAnnotations }}`  | 
|  URL externe  |  `string`  |  Un lien vers l'espace de travail Grafana ou Alertmanager qui a envoyé cette notification.  |  `{{ .ExternalURL }}`  | 

**KeyValue type**

Le `KeyValue` type est un ensemble de paires de key/value chaînes qui représentent des étiquettes et des annotations.

Outre l'accès direct aux données stockées sous forme de fichier`KeyValue`, il existe également des méthodes de tri, de suppression et de transformation des données.


| Name | Arguments | Renvoie | Remarques | Exemple | 
| --- | --- | --- | --- | --- | 
|  SortedPairs  |    |  Liste triée des paires de chaînes de clés et de valeurs  |    | `{{ .Annotations.SortedPairs }}` | 
|  Supprimer  |  [] chaîne  |  KeyValue  |  Renvoie une copie de la Key/Value carte sans les clés données.  | `{{ .Annotations.Remove "summary" }}` | 
|  Noms  |    |  [] chaîne  |  Liste des noms  | `{{ .Names }}` | 
|  Valeurs  |    |  [] chaîne  |  Liste de valeurs  | `{{ .Values }}` | 

**Time (Période)**

L'heure est comptée dans le [https://pkg.go.dev/time#Time](https://pkg.go.dev/time#Time)package Go. Vous pouvez imprimer une heure dans différents formats. Par exemple, pour imprimer l'heure à laquelle une alerte s'est déclenchée dans ce format`Monday, 1st January 2022 at 10:00AM`, vous devez écrire le modèle suivant :

```
{{ .StartsAt.Format "Monday, 2 January 2006 at 3:04PM" }}
```

Vous pouvez trouver une référence pour le format horaire de Go [ici](https://pkg.go.dev/time#pkg-constants).

# Gérer les points de contact
<a name="v10-alerting-manage-contactpoints"></a>

****  
**Cette rubrique de documentation est conçue pour les espaces de travail Grafana qui prennent en charge la version 10.x de Grafana.**  
Pour les espaces de travail Grafana compatibles avec la version 9.x de Grafana, voir. [Travailler dans la version 9 de Grafana](using-grafana-v9.md)  
Pour les espaces de travail Grafana compatibles avec la version 8.x de Grafana, voir. [Travailler dans la version 8 de Grafana](using-grafana-v8.md)

La vue de la liste des **points de contact** répertorie tous les points de contact et modèles de notification existants.

Dans l'onglet **Points de contact**, vous pouvez :
+ Recherchez les noms et les types de points de contact et d'intégrations.
+ Consultez tous les points de contact et intégrations existants.
+ Consultez le nombre de politiques de notification pour lesquelles chaque point de contact est utilisé et accédez directement aux politiques de notification associées.
+ Consultez l'état des envois de notifications.
+ Exportez des points de contact individuels ou tous les points de contact au format JSON, YAML ou Terraform.
+ Supprimez les points de contact qui ne sont pas utilisés par une politique de notification.

Dans l'onglet **Modèles de notification**, vous pouvez :
+ Affichez, modifiez, copiez ou supprimez les modèles de notification existants.

# Désactiver les notifications d'alerte
<a name="v10-alerting-silences"></a>

****  
**Cette rubrique de documentation est conçue pour les espaces de travail Grafana compatibles avec la version 10.x de Grafana.**  
Pour les espaces de travail Grafana compatibles avec la version 9.x de Grafana, voir. [Travailler dans la version 9 de Grafana](using-grafana-v9.md)  
Pour les espaces de travail Grafana compatibles avec la version 8.x de Grafana, voir. [Travailler dans la version 8 de Grafana](using-grafana-v8.md)

Vous pouvez supprimer les notifications d'alerte par un *silence*. Un silence empêche uniquement la création de notifications : les silences n'empêchent pas l'évaluation des règles d'alerte et n'empêchent pas l'affichage des instances d'alerte dans l'interface utilisateur. Lorsque vous désactivez une alerte, vous spécifiez une période pendant laquelle elle doit être supprimée.

**Note**  
Pour supprimer les notifications d'alerte à intervalles réguliers, par exemple pendant les périodes de maintenance régulières, utilisez-les [Horaire du mode muet](v10-alerting-manage-muting.md) plutôt que des silences.

**Pour ajouter un silence**

1. **Depuis votre console Grafana, dans le menu Grafana, choisissez Alerting.**

1. Choisissez **Silences.**

1. Choisissez un gestionnaire d'alertes dans la liste déroulante du gestionnaire d'**alertes**.

1. Choisissez **Create Silence**.

1. Sélectionnez les dates de début et de fin dans **Début et fin du silence** pour indiquer quand le silence doit entrer en vigueur et quand il doit prendre fin.

1. Au lieu de définir une heure de fin, dans **Durée**, spécifiez la durée pendant laquelle le silence est appliqué. Cela met automatiquement à jour l'heure de fin dans les champs de **début et de fin du silence**.

1. Dans les champs **Étiquette** et **Valeur**, entrez une ou plusieurs *étiquettes correspondantes*. Les matchers déterminent les règles auxquelles le silence s'applique. Toutes les alertes correspondantes (en état de déclenchement) apparaîtront dans le champ **Instances d'alertes concernées**.

1. Ajoutez éventuellement un **commentaire** décrivant le silence.

1. Sélectionnez **Soumettre**.

**Pour modifier un silence**

1. **Depuis votre console Grafana, dans le menu Grafana, choisissez Alerting.**

1. Choisissez **Silences** pour afficher la liste des silences existants.

1. Recherchez le silence que vous souhaitez modifier, puis choisissez **Modifier** (icône en forme de stylo).

1. Apportez les modifications souhaitées, puis choisissez **Soumettre** pour enregistrer vos modifications.

Vous pouvez modifier un silence existant en cliquant sur l'icône **Modifier** (stylo).

**Pour créer un lien URL vers un formulaire de silence**

Lorsque vous créez un lien vers un formulaire de silence, fournissez les libellés correspondants par défaut, ainsi que les paramètres de commentaire `matcher` et de `comment` requête. Le `matcher` paramètre doit être au format suivant, dans `[label][operator][value]` lequel le `operator` paramètre peut être l'un des suivants : `=` (égal, pas regex), `!=` (pas égal, pas regex), `=~` (égal, regex), `!~` (non égal, regex). L'URL peut contenir de nombreux paramètres de requête avec la clé`matcher`. Par exemple, pour créer un lien vers un formulaire de silence avec les libellés `severity=critical` `cluster!~europe-.*` et les commentaires correspondants`Silence critical EU alerts`, créez une URL`https://mygrafana/alerting/silence/new?matcher=severity%3Dcritical&matcher=cluster!~europe-*&comment=Silence%20critical%20EU%20alert`.

Pour créer un lien vers une nouvelle page de silence pour un Alertmanager externe, ajoutez un `alertmanager` paramètre de requête

**Pour supprimer un silence**

1. **Depuis votre console Grafana, dans le menu Grafana, choisissez Alerting.**

1. Choisissez **Silences** pour afficher la liste des silences existants.

1. Sélectionnez le silence auquel vous souhaitez mettre fin, puis choisissez Annuler **le silence**. Cela met fin à la suppression de l'alerte.
**Note**  
La désactivation met fin à la suppression de l'alerte, comme si l'heure de fin était définie pour l'heure actuelle. Les silences qui ont pris fin (automatiquement ou manuellement) sont conservés et répertoriés pendant cinq jours. Vous ne pouvez pas supprimer un silence de la liste manuellement.

# Afficher et filtrer les règles d'alerte
<a name="v10-alerting-manage-rules-viewfilter"></a>

****  
**Cette rubrique de documentation est conçue pour les espaces de travail Grafana qui prennent en charge la version 10.x de Grafana.**  
Pour les espaces de travail Grafana compatibles avec la version 9.x de Grafana, voir. [Travailler dans la version 9 de Grafana](using-grafana-v9.md)  
Pour les espaces de travail Grafana compatibles avec la version 8.x de Grafana, voir. [Travailler dans la version 8 de Grafana](using-grafana-v8.md)

La page **Alertes** répertorie les règles d'alerte. Par défaut, les règles sont regroupées par type de source de données. La section **Grafana** répertorie les règles gérées par Grafana. Les règles d'alerte pour les sources de données compatibles avec Prometheus sont également répertoriées ici. Vous pouvez consulter les règles d'alerte pour les sources de données compatibles avec Prometheus, mais vous ne pouvez pas les modifier.

La section Mimir/Cortex/Loki des règles répertorie toutes les règles relatives aux sources de données Mimir, Cortex ou Loki. Les règles d'alerte cloud sont également répertoriées dans cette section.

Lorsque vous gérez de gros volumes d'alertes, vous pouvez utiliser des fonctionnalités de recherche de règles d'alerte étendues pour filtrer les dossiers, les groupes d'évaluation et les règles. En outre, vous pouvez filtrer les règles d'alerte en fonction de leurs propriétés telles que les étiquettes, l'état, le type et l'état de santé.

## Afficher les règles d'alerte
<a name="v10-alerting-manage-rules-view"></a>

Grâce aux alertes Grafana, vous pouvez consulter toutes vos alertes sur une seule page.

**Pour afficher les détails des alertes**

1. **Depuis votre console Grafana, dans le menu Grafana, choisissez **Alerting, Alert** rules.** Par défaut, la vue en liste est affichée.

1. Dans **Afficher sous**, vous pouvez basculer entre les affichages groupé, liste et état en choisissant l'option que vous préférez.

1. Développez la ligne des règles pour afficher les étiquettes des règles, les annotations, les sources de données, les requêtes relatives aux règles et la liste des instances d'alerte résultant de la règle.

À partir de cette page, vous pouvez également créer des copies d'une règle d'alerte pour vous aider à réutiliser les règles existantes.

## Exporter les règles d'alerte
<a name="v10-alerting-manage-rules-export"></a>

Vous pouvez exporter les règles au format YAML ou JSON dans l'espace de travail Grafana.
+ Choisissez l'icône **Exporter le groupe de règles** à côté de chaque groupe de règles d'alerte à exporter vers YAML, JSON ou Terraform.
+ Choisissez **Exporter les règles** pour exporter toutes les règles d'alerte gérées par Grafana vers YAML, JSON ou Terraform.
+ Choisissez **Plus**, **Modifier et exporter** à côté de chaque règle d'alerte individuelle au sein d'un groupe pour modifier les règles d'alerte configurées et exporter une version modifiée.

## Afficher les définitions de requêtes pour les alertes provisionnées
<a name="v10-alerting-manage-rules-querydef"></a>

Affichez les définitions de requêtes en lecture seule pour les alertes provisionnées. Vérifiez rapidement si vos requêtes relatives aux règles d'alerte sont correctes, sans avoir à consulter votre référentiel « en tant que code » pour les définitions de règles.

**Vue groupée**

La vue groupée montre les règles d'alerte Grafana regroupées par dossier et les règles d'alerte Loki ou Prometheus groupées par \$1. `namespace` `group` Il s'agit de la vue de liste de règles par défaut, destinée à la gestion des règles. Vous pouvez développer chaque groupe pour afficher la liste des règles de ce groupe. Développez davantage une règle pour en afficher les détails. Vous pouvez également développer les boutons d'action et les alertes résultant de la règle pour en afficher les détails.

**Vue de l'État**

La vue État affiche les règles d'alerte regroupées par état. Utilisez cette vue pour avoir une vue d'ensemble des règles dans quel état. Chaque règle peut être étendue pour afficher ses détails. Boutons d'action et toutes les alertes générées par cette règle, et chaque alerte peut être étendue pour afficher ses détails.

## Règles de filtrage des alertes
<a name="v10-alerting-manage-rules-filter"></a>

Vous pouvez filtrer les règles d'alerte qui apparaissent sur la page **Alertes de** plusieurs manières.

**Pour filtrer les règles d'alerte**

1. **Dans Sélectionner les sources de données**, sélectionnez une source de données. Vous pouvez voir les règles d'alerte qui interrogent la source de données sélectionnée.

1. Dans **Rechercher par étiquette**, entrez les critères de recherche à l'aide de sélecteurs d'étiquettes. Par exemple, `environment=production;region=~US|EU,severity!=warning`.

1. Dans **Filtrer les alertes par état**, sélectionnez l'état d'alerte que vous souhaitez consulter. Vous pouvez voir les règles d'alerte correspondant à cet état. Les règles correspondant aux autres états sont masquées.

# Horaire du mode muet
<a name="v10-alerting-manage-muting"></a>

****  
**Cette rubrique de documentation est conçue pour les espaces de travail Grafana qui prennent en charge la version 10.x de Grafana.**  
Pour les espaces de travail Grafana compatibles avec la version 9.x de Grafana, voir. [Travailler dans la version 9 de Grafana](using-grafana-v9.md)  
Pour les espaces de travail Grafana compatibles avec la version 8.x de Grafana, voir. [Travailler dans la version 8 de Grafana](using-grafana-v8.md)

Un temps de sourdine est un intervalle de temps récurrent pendant lequel aucune nouvelle notification relative à une politique n'est générée ou envoyée. Utilisez-les pour empêcher les alertes de se déclencher pendant une période spécifique et récurrente, par exemple une période de maintenance régulière.

À l'instar des silences, le temps de mise en sourdine n'empêche pas l'évaluation des règles d'alerte, ni l'affichage des instances d'alerte dans l'interface utilisateur. Ils empêchent uniquement la création de notifications.

Vous pouvez configurer les durées de sourdine gérées par Grafana ainsi que les durées de sourdine pour une source de données Alertmanager externe.

## Timings muets ou silences
<a name="v10-alerting-manage-muting-compare"></a>

Le tableau suivant met en évidence les différences entre les temps de mise en sourdine et les silences.


| Synchronisation en mode muet | Silence | 
| --- | --- | 
| Utilise des définitions d'intervalles de temps qui peuvent se reproduire. | A une heure de début et de fin fixes. | 
| Est créé puis ajouté aux politiques de notification. | Utilise des étiquettes pour établir une correspondance avec une alerte afin de déterminer s'il convient de désactiver ou non. | 

## Ajouter une temporisation muette
<a name="v10-alerting-manage-muting-add"></a>

Vous pouvez créer des horaires muets dans votre espace de travail Grafana.

**Pour ajouter une temporisation muette**

1. **Depuis votre console Grafana, dans le menu Grafana, choisissez Alerting.**

1. Choisissez **Politiques de notification**, puis sélectionnez l'onglet Durée de **mise en sourdine.**

1. Dans le menu déroulant **Alertmanager**, sélectionnez le Alertmanager que vous souhaitez modifier.

1. Cliquez sur le bouton **\$1 Ajouter une temporisation muette**.

1. Remplissez le formulaire pour créer un [intervalle de temps à comparer](#v10-alerting-manage-muting-interval) à votre temps de mise en sourdine.

1. Enregistrez votre temps de mise en sourdine.

## Ajouter une temporisation muette à une politique de notification
<a name="v10-alerting-manage-muting-add-notif"></a>

Une fois que vous avez défini le temps de mise en sourdine, vous pouvez l'utiliser en l'ajoutant à la politique de notification que vous souhaitez désactiver à intervalles réguliers.

**Pour ajouter une temporisation muette à une politique de notification**

1. **Depuis votre console Grafana, dans le menu Grafana, choisissez Alerting.**

1. Choisissez **Politiques de notification**, puis sélectionnez l'onglet **Politiques de notification**.

1. **Sélectionnez la politique de notification à laquelle vous souhaitez ajouter le temps de sourdine, puis choisissez...** , **Modifier**.

1. Dans le menu déroulant Durée de **mise en sourdine**, sélectionnez la durée de mise en sourdine que vous souhaitez ajouter à la politique.

1. Enregistrez vos modifications.

## Intervalles de temps
<a name="v10-alerting-manage-muting-interval"></a>

Un intervalle de temps est une durée spécifique pendant laquelle les alertes sont supprimées. La durée comprend généralement une plage de temps spécifique et les jours de la semaine, du mois ou de l'année. 

Support : les options d'intervalle de temps sont les suivantes :
+ **Plage horaire** : heure comprise entre l'heure de début et l'heure de fin (en UTC, si aucun lieu n'a été sélectionné, sinon heure locale).
+ **Emplacement** — Définit le lieu pour le chronométrage : la plage horaire est affichée en heure locale pour le lieu.
+ **Jours de la semaine** : jour ou plage de jours de la semaine. Par exemple, `monday:thursday`.
+ **Jours du mois** : dates comprises dans un mois. Les valeurs peuvent être comprises entre `1` -`31`. Les valeurs négatives indiquent les jours du mois dans l'ordre inverse, ce `-1` qui représente le dernier jour du mois.
+ **Mois** — Les mois de l'année sont exprimés sous forme numérique ou sous le nom complet du mois calendaire. Par exemple, `1, may:august`.
+ **Années** : année ou années de l'intervalle. Par exemple, `2023:2024`.

Chacun de ces éléments peut être une liste, et au moins un élément de l'élément doit être satisfait pour correspondre. Les champs prennent également en charge les plages, en utilisant`:`. Par exemple, `monday:thursday`.

Si un champ est laissé vide, le champ correspondra à tout moment. Pour qu'un instant corresponde à un intervalle de temps complet, tous les champs doivent correspondre. Une temporisation muette peut contenir plusieurs intervalles de temps.

Si vous souhaitez spécifier une durée exacte, spécifiez toutes les options nécessaires pour cette durée. Par exemple, si vous souhaitez créer un intervalle de temps pour le premier lundi du mois, pour mars, juin, septembre et décembre, entre 12 h 00 et 24 h 00 UTC, votre spécification d'intervalle de temps peut être la suivante :
+ Plage de temps :
  + Heure de début : `12:00`
  + Heure de fin : `24:00`
+ Jours de la semaine : `monday`
+ Mois : `3, 6, 9, 12`
+ Jours du mois : `1:7`

# Afficher l'état et l'état des règles d'alerte
<a name="v10-alerting-manage-rulestate"></a>

****  
**Cette rubrique de documentation est conçue pour les espaces de travail Grafana qui prennent en charge la version 10.x de Grafana.**  
Pour les espaces de travail Grafana compatibles avec la version 9.x de Grafana, voir. [Travailler dans la version 9 de Grafana](using-grafana-v9.md)  
Pour les espaces de travail Grafana compatibles avec la version 8.x de Grafana, voir. [Travailler dans la version 8 de Grafana](using-grafana-v8.md)

Les règles relatives à l'état et à l'état des alertes vous fournissent plusieurs indicateurs de statut clés concernant vos alertes.

Il y a trois composantes :
+ [État de la règle d'alerte](#v10-alerting-manage-rulestate-state)
+ [État de l'instance d'alerte](#v10-alerting-manage-rulestate-instance)
+ [État des règles d'alerte](#v10-alerting-manage-rulestate-health)

Bien que lié, chaque composant transmet des informations subtilement différentes.

**Pour consulter l'état et l'état de vos règles d'alerte**

1. **Depuis votre console Grafana, dans le menu Grafana, choisissez Alerting.**

1. Choisissez **Règles d'alerte** pour afficher la liste des alertes existantes.

1. Choisissez une règle d'alerte pour voir son état et son état de santé.

## État de la règle d'alerte
<a name="v10-alerting-manage-rulestate-state"></a>

Une règle d'alerte peut avoir l'un des états suivants :


| State | Description | 
| --- | --- | 
| Normal | Aucune des séries chronologiques renvoyées par le moteur d'évaluation n'est à firing l'état pending or. | 
| En suspens | Au moins une série chronologique renvoyée par le moteur d'évaluation estpending. | 
| Mise à feu | Au moins une série chronologique renvoyée par le moteur d'évaluation estfiring. | 

**Note**  
Les alertes passent d'abord à `pending` puis`firing`, il faut donc au moins deux cycles d'évaluation avant qu'une alerte ne soit déclenchée.

## État de l'instance d'alerte
<a name="v10-alerting-manage-rulestate-instance"></a>

Une instance d'alerte peut se trouver dans l'un des états suivants :


| State | Description | 
| --- | --- | 
| Normal | État d'une alerte qui n'est ni « pending ni firing ». Tout fonctionne comme prévu. | 
| En suspens | État d'une alerte active pendant une durée inférieure au seuil configuré. | 
| Alerte | État d'une alerte active pendant une durée supérieure au seuil configuré. | 
| Aucune donnée | Aucune donnée n'a été reçue pour la fenêtre horaire configurée. | 
| Alerte | Une erreur s'est produite lors de la tentative d'évaluation d'une règle d'alerte. | 

## Conserver le dernier état
<a name="v10-alerting-manage-rulestate-keepstate"></a>

Une règle d'alerte peut être configurée pour conserver le dernier état lorsqu'un `Error` état `NoData` ou est détecté. Cela empêchera à la fois le déclenchement des alertes, leur résolution et leur réactivation. Tout comme dans le cas d'une évaluation normale, la règle d'alerte passera de `pending` à une `firing` fois la période d'attente écoulée.

## État des règles d'alerte
<a name="v10-alerting-manage-rulestate-health"></a>

Une règle d'alerte peut avoir l'un des états de santé suivants.


| State | Description | 
| --- | --- | 
| D'accord | Aucune erreur lors de l'évaluation de la règle d'alerte. | 
| Error (Erreur) | Une erreur s'est produite lors de l'évaluation de la règle d'alerte. | 
| NoData | Absence de données dans au moins une série chronologique renvoyée lors de l'évaluation d'une règle. | 
| \$1statut\$1, KeepLast | La règle aurait reçu un autre statut, mais elle a été configurée pour conserver le dernier état de la règle d'alerte. | 

## Alertes spéciales en cas NoData d'erreur
<a name="v10-alerting-manage-rulestate-special"></a>

Lorsque l'évaluation d'une règle d'alerte produit l'état `NoData` ou`Error`, l'alerte Grafana génère des instances d'alerte portant les étiquettes supplémentaires suivantes.


| Étiquette | Description | 
| --- | --- | 
| nom de l'alerte | SoitDatasourceError, DatasourceNoData soit, selon l'état. | 
| dataource\$1uid | L'UID de la source de données à l'origine de l'état. | 

**Note**  
Vous devez définir la règle d'absence de données ou de gestion des erreurs sur `NoData` ou `Error` dans la règle d'alerte, comme décrit dans la [Configurer les règles d'alerte gérées par Grafana](v10-alerting-configure-grafanamanaged.md) rubrique, pour générer les étiquettes supplémentaires.

Vous pouvez gérer ces alertes de la même manière que les alertes classiques, notamment en ajoutant des silences, en les acheminant vers un point de contact, etc.

# Afficher et filtrer par groupes d'alertes
<a name="v10-alerting-manage-viewfiltergroups"></a>

****  
**Cette rubrique de documentation est conçue pour les espaces de travail Grafana compatibles avec la version 10.x de Grafana.**  
Pour les espaces de travail Grafana compatibles avec la version 9.x de Grafana, voir. [Travailler dans la version 9 de Grafana](using-grafana-v9.md)  
Pour les espaces de travail Grafana compatibles avec la version 8.x de Grafana, voir. [Travailler dans la version 8 de Grafana](using-grafana-v8.md)

Les groupes d'alertes affichent les alertes groupées provenant d'une instance d'Alertmanager. Par défaut, les règles d'alerte sont regroupées en fonction des clés d'étiquette correspondant à la politique par défaut dans les politiques de notification. Le regroupement des règles d'alerte communes dans un seul groupe d'alertes empêche le déclenchement de règles d'alerte dupliquées.

Vous pouvez afficher les groupes d'alertes et également filtrer les règles d'alerte correspondant à des critères spécifiques.

**Pour afficher les groupes d'alertes**

1. **Depuis votre console Grafana, dans le menu Grafana, choisissez Alerting.**

1. Choisissez **Groupes** pour afficher les groupes existants.

1. Dans le menu déroulant **Alertmanager**, sélectionnez un Alertmanager externe comme source de données.

1. Dans le menu déroulant **Grouper par personnalisé**, sélectionnez une combinaison d'étiquettes pour afficher un regroupement autre que celui par défaut. Cela est utile pour déboguer et vérifier votre regroupement de politiques de notification.

Si une alerte ne contient aucune étiquette spécifiée dans le regroupement de la politique racine ou dans le regroupement personnalisé, l'alerte est ajoutée à un groupe catch all avec un en-tête de`No grouping`.

Vous pouvez filtrer les alertes par étiquette ou par état des alertes.

**Pour filtrer par étiquette**
+ Dans **Rechercher**, entrez une étiquette existante pour afficher les alertes correspondant à cette étiquette.

  Par exemple, `environment=production,region=~US|EU,severity!=warning`.

**Pour filtrer par état**
+ Dans **États**, sélectionnez l'état actif, supprimé ou non traité pour afficher les alertes correspondant à l'état sélectionné. Toutes les autres alertes sont masquées.

# Afficher les erreurs de notification
<a name="v10-alerting-manage-viewnotificationerrors"></a>

****  
**Cette rubrique de documentation est conçue pour les espaces de travail Grafana qui prennent en charge la version 10.x de Grafana.**  
Pour les espaces de travail Grafana compatibles avec la version 9.x de Grafana, voir. [Travailler dans la version 9 de Grafana](using-grafana-v9.md)  
Pour les espaces de travail Grafana compatibles avec la version 8.x de Grafana, voir. [Travailler dans la version 8 de Grafana](using-grafana-v8.md)

Consultez les erreurs de notification et comprenez pourquoi elles n'ont pas été envoyées ou n'ont pas été reçues.

**Note**  
Cette fonctionnalité n'est prise en charge que pour Grafana Alertmanager.

**Pour afficher les erreurs de notification**

1. Dans le menu de gauche, choisissez **Alerte** puis **Points de contact**.

   Si l'un des points de contact est défaillant, un message dans le coin droit de l'espace de travail vous indique qu'il y a des erreurs et leur nombre.

1. Sélectionnez un point de contact pour afficher le détail des erreurs associées à ce point de contact.

   Les détails de l'erreur s'affichent si vous passez le curseur sur l'icône d'erreur.

   Si un point de contact possède plusieurs intégrations, toutes les erreurs s'affichent pour chacune des intégrations répertoriées.

1. Dans la colonne Health, vérifiez l'état de la notification.

   Cela peut être OK, Aucune tentative ou Erreur.