11.7. Envoi de notifications à des systèmes externes

Procédure

1. Dans la perspective Administrator, naviguez vers Administration Cluster Settings Configuration Alertmanager.

   Note

   Vous pouvez également accéder à la même page via le tiroir de notification. Sélectionnez l'icône de cloche en haut à droite de la console web OpenShift Container Platform et choisissez Configure dans l'alerte AlertmanagerReceiverNotConfigured.

2. Sélectionnez Create Receiver dans la section Receivers de la page.
3. Dans le formulaire Create Receiver, ajoutez un Receiver Name et choisissez un Receiver Type dans la liste.

4. Modifier la configuration du récepteur :

   • Pour les récepteurs PagerDuty :

     1. Choisissez un type d'intégration et ajoutez une clé d'intégration PagerDuty.
     2. Ajoutez l'URL de votre installation PagerDuty.
     3. Sélectionnez Show advanced configuration si vous souhaitez modifier les détails du client et de l'incident ou la spécification de gravité.

   • Pour les récepteurs webhook :

     1. Ajoutez le point de terminaison auquel envoyer des requêtes HTTP POST.
     2. Sélectionnez Show advanced configuration si vous souhaitez modifier l'option par défaut d'envoi des alertes résolues au destinataire.

   • Pour les destinataires du courrier électronique :

     1. Ajouter l'adresse électronique à laquelle envoyer les notifications.
     2. Ajoutez les détails de la configuration SMTP, y compris l'adresse à partir de laquelle les notifications sont envoyées, le smarthost et le numéro de port utilisés pour l'envoi des courriels, le nom d'hôte du serveur SMTP et les détails d'authentification.
     3. Choisissez si TLS est nécessaire.
     4. Sélectionnez Show advanced configuration si vous souhaitez modifier l'option par défaut consistant à ne pas envoyer d'alertes résolues au destinataire ou modifier le corps de la configuration des notifications par courrier électronique.

   • Pour les destinataires de Slack :

     1. Ajoutez l'URL du webhook Slack.
     2. Ajoutez le canal Slack ou le nom d'utilisateur auquel envoyer les notifications.
     3. Sélectionnez Show advanced configuration si vous souhaitez modifier l'option par défaut consistant à ne pas envoyer d'alertes résolues au destinataire ou modifier la configuration de l'icône et du nom d'utilisateur. Vous pouvez également choisir de rechercher et de lier les noms de canaux et les noms d'utilisateurs.

5. Par défaut, les alertes de déclenchement dont les étiquettes correspondent à tous les sélecteurs sont envoyées au destinataire. Si vous souhaitez que les valeurs des étiquettes des alertes de déclenchement correspondent exactement avant qu'elles ne soient envoyées au destinataire :

   1. Ajoutez les noms et valeurs des étiquettes de routage dans la section Routing Labels du formulaire.
   2. Sélectionnez Regular Expression si vous souhaitez utiliser une expression régulière.
   3. Sélectionnez Add Label pour ajouter d'autres étiquettes de routage.
6. Sélectionnez Create pour créer le récepteur.

Procédure

1. Créez un fichier YAML pour le routage des alertes. L'exemple de cette procédure utilise un fichier appelé example-app-alert-routing.yaml.

2. Ajoutez une définition YAML AlertmanagerConfig au fichier. Par exemple :

   apiVersion: monitoring.coreos.com/v1beta1
   kind: AlertmanagerConfig
   metadata:
     name: example-routing
     namespace: ns1
   spec:
     route:
       receiver: default
       groupBy: [job]
     receivers:
     - name: default
       webhookConfigs:
       - url: https://example.org/post

   Note

   Pour les règles d'alerte définies par l'utilisateur, le routage défini par l'utilisateur est limité à l'espace de noms dans lequel la ressource est définie. Par exemple, une configuration de routage définie dans l'objet AlertmanagerConfig pour l'espace de noms ns1 ne s'applique qu'aux ressources PrometheusRules du même espace de noms.

3. Enregistrer le fichier.

4. Appliquer la ressource au cluster :

   $ oc apply -f example-app-alert-routing.yaml

   La configuration est automatiquement appliquée aux pods Alertmanager.