Configuration des points de contact

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

Pour les espaces de travail Grafana compatibles avec la version 8.x de Grafana, voir. Travailler dans la version 8 de Grafana

Utilisez les points de contact pour définir la manière dont vos contacts sont avertis lorsqu'une règle d'alerte est déclenchée.

Note

Vous pouvez créer et modifier des points de contact pour les alertes gérées par Grafana. Les points de contact pour les alertes gérées par les sources de données sont en lecture seule.

Travailler avec les points de contact

Les procédures suivantes indiquent comment ajouter, modifier, supprimer et tester un point de contact.

Pour ajouter un point de contact

1. Dans le menu de gauche, choisissez le portail de gestion des alertes IRM, puis Alerting.

2. Choisissez Points de contact.

3. Dans le menu déroulant Choisir un gestionnaire d'alertes, sélectionnez un gestionnaire d'alertes. Le Grafana Alertmanager est sélectionné par défaut.

4. Dans l'onglet Points de contact, choisissez + Ajouter un point de contact.

5. Entrez un nom pour le point de contact.

6. Dans Intégration, choisissez un type et remplissez les champs obligatoires en fonction de ce type. Par exemple, si vous choisissez Slack, entrez les chaînes Slack et les utilisateurs à contacter.

7. Si disponible pour le point de contact que vous avez sélectionné, choisissez les paramètres facultatifs souhaités pour définir des paramètres supplémentaires.

8. Dans Paramètres de notification, sélectionnez éventuellement Désactiver le message résolu si vous ne souhaitez pas être averti lorsqu'une alerte est résolue.

9. Pour ajouter une autre intégration de point de contact, choisissez Ajouter une intégration de point de contact et répétez les étapes pour chaque type de point de contact requis.

10. Enregistrez vos modifications.

Pour modifier un point de contact

1. Dans le menu de gauche, choisissez le portail de gestion des alertes IRM, puis Alerting.

2. Choisissez Points de contact pour voir la liste des points de contact existants.

3. Sélectionnez le point de contact à modifier, puis choisissez Modifier.

4. Mettez à jour le point de contact, puis enregistrez vos modifications.

Vous pouvez supprimer les points de contact qui ne sont pas utilisés par une politique de notification.

Pour supprimer un point de contact

1. Dans le menu de gauche, choisissez le portail de gestion des alertes IRM, puis Alerting.

2. Choisissez Points de contact pour ouvrir la liste des points de contact existants.

3. Dans les points de contact, sélectionnez le point de contact à supprimer, puis choisissez Plus, Supprimer.

4. Dans la boîte de dialogue de confirmation, choisissez Oui, supprimer.

Note

Si le point de contact est utilisé par une politique de notification, vous devez supprimer la politique de notification ou la modifier pour utiliser un autre point de contact avant de supprimer le point de contact.

Une fois votre point de contact créé, vous pouvez envoyer une notification de test pour vérifier qu'il est correctement configuré.

Pour envoyer une notification de test

1. Dans le menu de gauche, choisissez le portail de gestion des alertes IRM, puis Alerting.

2. Choisissez Points de contact pour ouvrir la liste des points de contact existants.

3. Sur les points de contact, sélectionnez le point de contact à tester, puis choisissez Modifier. Vous pouvez également créer un nouveau point de contact si nécessaire.

4. Choisissez Test pour ouvrir la boîte de dialogue de test du point de contact.

5. Choisissez d'envoyer une notification de test prédéfinie ou de choisir Personnalisé pour ajouter vos propres annotations et étiquettes personnalisées dans la notification de test.

6. Choisissez Envoyer une notification de test pour tester l'alerte auprès des points de contact indiqués.

Configurer les intégrations de points de contact

Configurez les intégrations de points de contact dans Grafana pour sélectionner votre canal de communication préféré pour recevoir des notifications lorsque vos règles d'alerte se déclenchent. Chaque intégration possède ses propres options de configuration et processus de configuration. Dans la plupart des cas, cela implique de fournir une clé d'API ou une URL de webhook.

Une fois configurée, vous pouvez utiliser les intégrations dans le cadre de vos points de contact pour recevoir des notifications chaque fois que l'état de votre alerte change. Dans cette section, nous aborderons les étapes de base pour configurer une intégration, en prenant PagerDuty comme exemple le fait que vous puissiez commencer à recevoir des alertes en temps réel et rester au courant de vos données de surveillance.

Liste des intégrations prises en charge

Le tableau suivant répertorie les types de points de contact pris en charge par Grafana.

Nom	Type
Amazon SNS	sns
OpsGenie	opsgenie
Devoir de téléavertisseur	pagerduty
Slack	slack
VictorOps	victorops

Configuration PagerDuty des alertes

Pour le configurer PagerDuty, vous devez fournir une clé d'intégration. Fournissez les informations suivantes.

Paramètre	Description
Clé d'intégration	Clé d'intégration pour PagerDuty
Sévérité	Niveau pour les notifications dynamiques. La valeur par défaut est critical.
Détails personnalisés	Informations supplémentaires sur l'événement

Le CustomDetails champ est un objet contenant des paires clé-valeur arbitraires. Les détails définis par l'utilisateur sont fusionnés avec ceux utilisés par défaut.

Les valeurs par défaut pour CustomDetails sont les suivantes :

{
	"firing":       `{{ template "__text_alert_list" .Alerts.Firing }}`,
	"resolved":     `{{ template "__text_alert_list" .Alerts.Resolved }}`,
	"num_firing":   `{{ .Alerts.Firing | len }}`,
	"num_resolved": `{{ .Alerts.Resolved | len }}`,
}

En cas de double clé, les informations définies par l'utilisateur remplacent celles définies par défaut.