Vue d’ensemble
Configuration
Déployer un service passerelle webhook
Mettez en place un petit handler qui reçoit les payloads d’incident PagerDuty et appelle l’API Devin pour lancer des sessions d’investigation.Créez un utilisateur de service dans Settings > Service Users avec l’autorisation Déployez ce service partout où il peut recevoir du trafic HTTPS — par exemple dans un Cloudflare Worker, une AWS Lambda ou un petit conteneur.
ManageOrgSessions. Stockez le jeton d’API dans DEVIN_API_KEY, l’ID de votre organisation dans DEVIN_ORG_ID et un secret partagé dans WEBHOOK_SECRET sur votre service passerelle. Vous configurerez ce même secret dans les Custom Headers du webhook PagerDuty à l’étape suivante.Ajouter une intégration webhook dans PagerDuty
- Dans PagerDuty, accédez à Services > [votre service] > Integrations
- Cliquez sur Add Integration et sélectionnez Generic Webhooks (v3)
- Renseignez la Webhook URL avec l’endpoint de votre service passerelle (par ex.
https://your-bridge.example.com/pagerduty-alert) - Dans Custom Headers, ajoutez
X-Webhook-Secretavec la même valeur que celle stockée dansWEBHOOK_SECRETsur votre service passerelle - Dans Event Subscription, filtrez sur le type d’événement
incident.triggeredpour ne déclencher le webhook que pour les nouveaux incidents
Vérifier le pipeline
Déclenchez un incident de test dans PagerDuty (ou utilisez un service de test) et confirmez que :
- Votre passerelle reçoit le payload du webhook
- Une nouvelle session Devin est créée sur app.devin.ai
- Devin commence à analyser l’incident
Bonnes pratiques
- Commencez par des monitors de niveau warning. Testez le pipeline avec des incidents non critiques avant d’acheminer des alertes P1 de production vers Devin.
- Filtrez par service ou par gravité. Utilisez les abonnements aux événements webhook de PagerDuty ou ajoutez une logique dans votre passerelle pour ignorer les services peu prioritaires ou trop bruyants. Cela évite que Devin soit submergé par des alertes peu utiles.
- Utilisez des playbooks différents selon la gravité. Acheminez les alertes P1 pour une investigation immédiate et un correctif d’urgence. Acheminez les alertes P3 uniquement pour une analyse des causes racines. Transmettez des valeurs
playbook_iddifférentes dans la requête à l’API Devin selon le niveau d’urgence. - Étiquetez les sessions pour en faciliter le suivi. L’exemple de code étiquette chaque session avec
pagerduty-triageet le nom du service, ce qui facilite le filtrage et l’examen dans le tableau de bord Devin.
Combiner avec Datadog
- PagerDuty achemine l’alerte vers Devin (ce qui active la session d’investigation)
- Devin utilise le Datadog MCP pour interroger les journaux, les métriques et les traces du service concerné
