Connecter PagerDuty

Alertez votre équipe d'astreinte via PagerDuty dès qu'un moniteur tombe en panne, directement depuis InfraNest.

Aperçu

• Un moniteur qui tombe en panne déclenche automatiquement un incident PagerDuty ; lorsqu'il se rétablit, InfraNest résout ce même incident.
• Accuser réception ou résoudre dans un outil met à jour l'autre, une fois connecté.
• Vous avez seulement besoin d'une clé d'intégration PagerDuty — aucune clé API REST ni OAuth requis.

Avant de commencer

Vous avez besoin d'une clé d'intégration PagerDuty (parfois appelée routing key). Elle provient d'une intégration Events API v2 sur un de vos services PagerDuty — ce n'est pas une « API Access Key ».

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

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

Connecter PagerDuty

1. Allez dans Alertes, puis Destinations d'alerte.
2. Sélectionnez Ajouter une destination et choisissez PagerDuty.
3. Collez la clé dans Clé d’intégration (routing key). InfraNest la vérifie lors de l'enregistrement : une clé d'intégration PagerDuty comporte 32 lettres et chiffres, et toute autre valeur est refusée immédiatement plutôt qu'enregistrée pour échouer plus tard.
4. Sélectionnez Envoyer un test pour déclencher une alerte de test et confirmer qu'un incident apparaît dans PagerDuty (vous pouvez le résoudre ensuite).
5. Sélectionnez Enregistrer et tester.

Envoyer des alertes à PagerDuty

Une fois la destination enregistrée, choisissez PagerDuty lorsque vous décidez où envoyer chaque alerte. Un moniteur qui tombe en panne déclenche un incident PagerDuty (critique) ; lorsqu'il se rétablit, InfraNest résout ce même incident.

Accuser réception et résoudre — dans les deux sens

• Accuser réception ou résoudre dans InfraNest → l'incident PagerDuty lié est également accusé/résolu.
• Accuser réception ou résoudre dans PagerDuty → l'incident InfraNest est mis à jour en conséquence.

Le second sens (PagerDuty → InfraNest) est une configuration optionnelle et ponctuelle sur votre destination PagerDuty — recherchez Configurer la synchro bidirectionnelle sur la destination. L'envoi d'alertes et les mises à jour sortantes fonctionnent immédiatement avec seulement la clé d'intégration.

Astuces

• La clé d'intégration est stockée de façon sécurisée et masquée après l'enregistrement.
• Une destination alerte un service PagerDuty. Ajoutez une autre destination pour alerter un autre service ou une autre équipe.
• Les automatisations peuvent aussi alerter PagerDuty, pour des situations qu'un moniteur ne voit jamais — un certificat qui expire, une tâche échouée.

NoteVous n'avez pas besoin d'une clé API REST PagerDuty ni d'OAuth pour l'envoi d'alertes ou la synchro bidirectionnelle — seulement la clé d'intégration.

Dépannage

InfraNest n'accepte pas la clé. La clé que vous avez collée n'a pas le format attendu pour une clé d'intégration, qui comporte toujours 32 lettres et chiffres. Le plus souvent, il s'agit d'une API Access Key REST (elles ressemblent à PSOJL90… et sont bien plus courtes) ou d'une clé contenant un tiret. Suivez la section Avant de commencer ci-dessus pour récupérer la clé d'intégration depuis l'onglet Integrations de votre service, et collez-la à la place.

Le test a échoué avec un message « invalid routing key ». C'est le même problème vu de l'autre côté — une destination enregistrée avant qu'InfraNest ne commence à vérifier la clé. Ouvrez la destination, collez la Integration Key Events API v2 de votre service, puis enregistrez.

Envoyer un test affiche Test envoyé avec succès, mais rien n'arrive dans PagerDuty. Une clé au bon format mais appartenant à une intégration supprimée est acceptée par PagerDuty puis ne mène nulle part — PagerDuty répond « received » dans les deux cas, donc rien de notre côté ne permet de le détecter. Ouvrez l'onglet Integrations du service dans PagerDuty, confirmez que l'intégration Events API v2 est toujours présente, et copiez à nouveau sa clé.

Rien n'alerte. 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 vraie alerte n'a pas créé de nouvel incident PagerDuty. PagerDuty regroupe les alertes répétées pour un même problème dans un seul incident ouvert jusqu'à sa résolution — donc un moniteur instable met à jour l'incident existant plutôt que de déclencher une nouvelle alerte. C'est normal ; résolvez l'incident (ou attendez le rétablissement) et la prochaine occurrence déclenchera une nouvelle alerte.