Connecter PagerDuty

Alertez votre équipe d'astreinte via PagerDuty chaque fois qu'un moniteur tombe en panne — ce guide s'adresse à toute personne configurant InfraNest pour alerter automatiquement son équipe.

Aperçu

• InfraNest alerte PagerDuty lorsqu'un moniteur tombe en panne, en utilisant une Integration Key PagerDuty (aussi appelée routing key).
• Lorsque le moniteur se rétablit, InfraNest résout automatiquement l'incident PagerDuty correspondant.
• Acquitter ou résoudre dans l'un des deux outils peut mettre à jour l'autre, une fois qu'une étape de configuration optionnelle est effectuée.

Obtenir votre Integration Key depuis PagerDuty

1. Dans PagerDuty, allez dans Services et ouvrez le service pour lequel vous souhaitez être alerté (ou créez-en un nouveau).
2. Ouvrez l'onglet Integrations du service et choisissez Add integration.
3. Recherchez Events API v2 et ajoutez-le.
4. Copiez l'Integration Key affichée — une clé de 32 caractères. C'est cette valeur dont InfraNest a besoin.

WarningN'utilisez pas l'API Access Key de la page Integrations → API Access Keys de PagerDuty (des clés comme PSOJL90…). Celle-ci est destinée à l'API REST de PagerDuty et InfraNest la rejettera. Utilisez toujours l'Events API v2 Integration Key de l'onglet Integrations d'un service.

Connecter PagerDuty dans InfraNest

1. Allez dans Alertes → Destinations.
2. Sélectionnez Connecter une nouvelle destination et choisissez PagerDuty.
3. Collez la Clé d'intégration (routing key).
4. Sélectionnez Envoyer un test pour déclencher une alerte de test et confirmer qu'un incident apparaît dans PagerDuty. Vous pourrez le résoudre par la suite.
5. Sélectionnez Enregistrer.

Envoyer des alertes à PagerDuty

1. Une fois la destination enregistrée, choisissez PagerDuty lorsque vous décidez où envoyer chaque alerte, sous Prévenez-moi quand….
2. Un moniteur qui tombe en panne déclenche un incident PagerDuty marqué comme critique.
3. Lorsque le moniteur se rétablit, InfraNest résout automatiquement ce même incident PagerDuty.

Acquitter et résoudre — dans les deux sens

• Acquitter ou résoudre dans InfraNest → l'incident PagerDuty lié est également acquitté ou résolu.
• Acquitter ou résoudre dans PagerDuty → l'incident InfraNest est mis à jour en conséquence.

Le second sens (PagerDuty → InfraNest) nécessite une configuration optionnelle et unique sur votre destination PagerDuty — voir Synchronisation bidirectionnelle (optionnel). L'envoi d'alertes et les mises à jour sortantes fonctionnent immédiatement avec la seule Integration Key.

Astuces

• Une destination alerte un service PagerDuty. Ajoutez une autre destination si vous devez alerter un service ou une équipe différente.
• Les automatisations peuvent alerter PagerDuty pour des événements qu'un moniteur ne voit jamais — comme un certificat qui expire ou une tâche échouée.

NoteL'Integration Key est stockée de manière sécurisée et masquée après l'enregistrement. Vous n'avez pas besoin d'une clé API REST PagerDuty ni d'OAuth pour les alertes ou la synchronisation bidirectionnelle — seulement l'Integration Key.

Résolution des problèmes

Le test échoue avec « invalid routing key ». Vous avez probablement collé une REST API Access Key au lieu d'une Events API v2 Integration Key. Supprimez-la, suivez les étapes ci-dessus pour obtenir la bonne clé depuis l'onglet Integrations de votre service, et collez-la à la place.

Rien ne se déclenche. Vérifiez que la destination est Activé et que les alertes du moniteur y sont bien routées. Sélectionnez à nouveau Envoyer un test pour confirmer que la clé fonctionne.

Une alerte réelle n'a pas créé de nouvel incident PagerDuty. PagerDuty regroupe les alertes répétées pour le même problème en un seul incident ouvert jusqu'à sa résolution ; ainsi, un moniteur instable met à jour l'incident existant au lieu de déclencher une nouvelle alerte. C'est un comportement normal — résolvez l'incident, ou attendez le rétablissement, et la prochaine occurrence déclenchera une nouvelle alerte.