INTÉGRATION PAGERDUTY n8n : AUTOMATISER PAGERDUTY AVEC N8N

L'action "Get User" permet de récupérer les informations détaillées d'un utilisateur spécifique dans PagerDuty. C'est particulièrement utile pour enrichir vos workflows avec des données utilisateur — par exemple, récupérer l'email ou le numéro de téléphone de l'astreinte actuelle pour l'inclure dans une notification.

Paramètres de configuration :

• Credential to connect with : Sélectionnez votre compte PagerDuty (menu déroulant, requis)
• Resource : Choisissez "User" (menu déroulant, requis)
• Operation : Sélectionnez "Get" (menu déroulant, requis)
• User ID : L'identifiant unique de l'utilisateur PagerDuty à récupérer (champ texte, requis)

Cas d'usage typiques :

• Récupérer les coordonnées de l'ingénieur d'astreinte pour les inclure dans un message Slack
• Vérifier le statut d'un utilisateur avant de lui assigner un incident
• Alimenter un dashboard avec les informations des membres de l'équipe

L'action "Log Entry: Get Many" récupère plusieurs entrées de logs depuis PagerDuty. Les log entries tracent toutes les activités sur vos incidents : assignations, escalades, acknowledgements, résolutions. C'est une mine d'or pour l'analyse et le reporting.

Paramètres de configuration :

• Credential to connect with : Votre compte PagerDuty (menu déroulant, requis)
• Resource : Sélectionnez "Log Entry" (menu déroulant, requis)
• Operation : Choisissez "Get Many" (menu déroulant, requis)
• Return All : Interrupteur on/off pour récupérer tous les résultats sans limite (optionnel)
• Limit : Nombre maximum d'entrées à récupérer, par défaut 100 (champ numérique, actif si Return All est désactivé)
• Options : Paramètres additionnels pour filtrer par incident ID ou par date

Cas d'usage typiques :

• Générer un rapport d'activité hebdomadaire des incidents
• Analyser les temps de réponse moyens de l'équipe
• Exporter l'historique des logs vers un data warehouse pour analyse

L'action "Log Entry: Get" récupère une entrée de log spécifique via son identifiant. Utile quand vous connaissez précisément l'événement que vous souhaitez analyser.

Paramètres de configuration :

• Credential to connect with : Compte PagerDuty (menu déroulant, requis)
• Resource : "Log Entry" (menu déroulant, requis)
• Operation : "Get" (menu déroulant, requis)
• Log Entry ID : L'identifiant unique de l'entrée de log (champ texte, requis)

Cas d'usage typiques :

• Récupérer les détails d'un événement spécifique mentionné dans un autre système
• Valider qu'une action a bien été enregistrée dans PagerDuty

Cette action récupère les notes associées à un ou plusieurs incidents. Les notes sont essentielles pour documenter le contexte, les actions prises et les observations durant la résolution d'un incident.

Paramètres de configuration :

• Credential to connect with : Compte PagerDuty (menu déroulant, requis)
• Resource : "Incident Note" (menu déroulant, requis)
• Operation : "Get Many" (menu déroulant, requis)
• Incident ID : Filtrer les notes par incident spécifique (champ texte, optionnel)
• Return All : Récupérer toutes les notes sans limite (interrupteur, optionnel)
• Limit : Nombre maximum de notes, par défaut 100 (champ numérique)

Cas d'usage typiques :

• Compiler toutes les notes d'un incident pour un post-mortem
• Synchroniser les notes PagerDuty vers Confluence ou Notion
• Alimenter un rapport d'incident automatique

L'action "Create Incident Note" ajoute une nouvelle note à un incident existant. C'est l'une des actions les plus utiles pour enrichir automatiquement vos incidents avec du contexte provenant d'autres systèmes.

Paramètres de configuration :

• Credential to connect with : Compte PagerDuty (menu déroulant, requis)
• Resource : "Incident Note" (menu déroulant, requis)
• Operation : "Create" (menu déroulant, requis)
• Incident ID : L'identifiant de l'incident cible (champ texte, requis)
• Content : Le contenu textuel de la note (champ texte, requis)
• Email : L'email de l'utilisateur créant la note, pour l'attribution (champ texte, requis)

Cas d'usage typiques :

• Ajouter automatiquement les logs d'erreur depuis votre système de monitoring
• Documenter les actions automatisées (restart de service, rollback, etc.)
• Inclure les métriques système au moment de l'incident

💡 TIPS : Structurez vos notes automatiques avec un format cohérent (timestamp, source, détails) pour faciliter la lecture lors des post-mortems.

L'action "Update Incident" permet de modifier un incident existant : changer son statut, sa priorité, l'assignation, ou ajouter des informations de conference bridge.

Paramètres de configuration :

• Credential to connect with : Compte PagerDuty (menu déroulant, requis)
• Resource : "Incident" (menu déroulant, requis)
• Operation : "Update" (menu déroulant, requis)
• Incident ID : L'identifiant de l'incident à modifier (champ texte, requis)
• Email : L'email de l'utilisateur effectuant la mise à jour (champ texte, requis)
• Update Fields : Champs à modifier (status, priority, assigned user, etc.) via le bouton "Add Field"
• Conference Bridge : Informations de bridge audio/vidéo à attacher à l'incident

Cas d'usage typiques :

• Passer automatiquement un incident en "resolved" quand le check de monitoring repasse au vert
• Escalader la priorité si l'incident n'est pas acknowled dans les 5 minutes
• Ajouter un lien de visioconférence Zoom pour les incidents critiques

Cette action récupère une liste d'incidents depuis PagerDuty. Parfait pour construire des dashboards, des rapports ou synchroniser l'état des incidents avec d'autres systèmes.

Paramètres de configuration :

• Credential to connect with : Compte PagerDuty (menu déroulant, requis)
• Resource : "Incident" (menu déroulant, requis)
• Operation : "Get Many" (menu déroulant, requis)
• Return All : Récupérer tous les incidents (interrupteur, optionnel)
• Limit : Nombre maximum d'incidents, par défaut 100 (champ numérique)
• Options : Filtres additionnels (statut, service, date, urgence, etc.)

Cas d'usage typiques :

• Générer un rapport quotidien des incidents ouverts
• Synchroniser les incidents vers Jira ou un autre outil de ticketing
• Créer un dashboard en temps réel dans Google Sheets ou Airtable

L'action "Get Incident" récupère les détails complets d'un incident spécifique via son identifiant.

Paramètres de configuration :

• Credential to connect with : Compte PagerDuty (menu déroulant, requis)
• Resource : "Incident" (menu déroulant, requis)
• Operation : "Get" (menu déroulant, requis)
• Incident ID : L'identifiant unique de l'incident (champ texte, requis)

Cas d'usage typiques :

• Récupérer le statut actuel d'un incident pour une vérification conditionnelle
• Extraire les métadonnées d'un incident pour les inclure dans une notification enrichie

L'action "Create Incident" est probablement l'action la plus utilisée : elle permet de créer un nouvel incident dans PagerDuty de manière programmatique.

Paramètres de configuration :

• Credential to connect with : Compte PagerDuty (menu déroulant, requis)
• Resource : "Incident" (menu déroulant, requis)
• Operation : "Create" (menu déroulant, requis)
• Title : Le titre/résumé de l'incident (champ texte, requis)
• Service Name or ID : Le service PagerDuty auquel rattacher l'incident (champ texte, requis)
• Email : L'email de l'utilisateur créant l'incident (champ texte, requis)
• Additional Fields : Champs optionnels (urgency, body, priority, etc.)
• Conference Bridge : Informations de bridge à inclure dès la création

Cas d'usage typiques :

• Créer un incident automatiquement quand une alerte Prometheus/Grafana se déclenche
• Transformer un ticket Zendesk urgent en incident PagerDuty
• Déclencher un incident depuis un formulaire interne (Typeform, Google Forms)