View a markdown version of this page

Connecter PagerDuty - AWS DevOps Agent
PagerDuty exigencesS'inscrire PagerDutyAjouter PagerDuty à un espace d'agentGestion des PagerDuty connexionsPrise en charge des webhooks

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Connecter PagerDuty

PagerDuty l'intégration permet à l' AWS DevOps agent d'accéder et de mettre à jour les données sur les incidents, les horaires d'astreinte et les informations de service depuis votre PagerDuty compte lors des enquêtes sur les incidents et des réponses automatisées. Cette intégration utilise OAuth 2.0 pour une authentification sécurisée.

Important

AWS DevOps L'agent ne prend en charge que la nouvelle version PagerDuty OAuth 2.0 (Scoped OAuth). L'ancienne version PagerDuty d'OAuth avec URL de redirection n'est pas prise en charge.

PagerDuty exigences

Avant de vous connecter PagerDuty, assurez-vous d'avoir :

  • Un PagerDuty compte avec votre identifiant client OAuth et votre secret client

  • Le sous-domaine de votre PagerDuty compte (par exemple, si votre PagerDuty URL esthttps://your-company.pagerduty.com, le sous-domaine est) your-company

S'inscrire PagerDuty

PagerDuty est enregistré au niveau du AWS compte et partagé entre tous les espaces d'agent de ce compte. Chaque enregistrement correspond à un PagerDuty compte, identifié par sa région et son sous-domaine. Pour enregistrer des PagerDuty comptes supplémentaires, répétez cette procédure pour chacun d'entre eux.

Étape 1 : configurer l'accès dans PagerDuty

  1. Connectez-vous à la console AWS de gestion

  2. Accédez à la console de AWS DevOps l'agent

  3. Accédez à la page Capability Providers (accessible depuis la navigation latérale)

  4. Recherchez PagerDuty dans la section «  Fournisseurs disponibles » sous «  Communication » et choisissez «  S'inscrire »

  5. Suivez la procédure de configuration guidée sur la PagerDuty page Configurer l'accès dans :

Vérifiez votre région de service et votre sous-domaine :

  • Étendue du compte — Sélectionnez votre PagerDuty région (États-Unis ou UE) et entrez votre PagerDuty sous-domaine. Par exemple, si votre PagerDuty URL esthttps://your-company.pagerduty.com, entrezyour-company.

Créez une nouvelle application dans PagerDuty :

  • Dans un onglet de navigateur distinct, connectez-vous PagerDuty et accédez à Intégrations > Enregistrement de l'application

  • Créez une nouvelle application à l'aide d'OAuth 2.0 Scoped OAuth

  • Sous Autorisations, accordez les étendues minimales requises suivantes : incidents.readincidents.write, services.readwebhook_subscriptions.read, et webhook_subscriptions.write

  • Activez l'intégration des événements pour permettre une communication bidirectionnelle entre AWS DevOps l'agent et PagerDuty

Configurez les informations d'identification OAuth :

  • Étendue des autorisations — Les étendues minimales requises sont les suivantes :incidents.read,incidents.write,services.read, webhook_subscriptions.read webhook_subscriptions.write

  • Nom du client  : entrez un nom descriptif pour votre client OAuth

  • ID client  : entrez l'identifiant client OAuth lors de l'enregistrement de votre application PagerDuty

  • Secret du client  : entrez le code secret du client OAuth lors de l'enregistrement de votre application PagerDuty

Étape 2 : Vérifier et soumettre PagerDuty l'inscription

  1. Vérifiez tous les détails PagerDuty de configuration

  2. Choisissez Soumettre pour terminer l'inscription

  3. Une fois l'inscription réussie, PagerDuty apparaît dans la section Actuellement enregistré de la page Capability Providers

Ajouter PagerDuty à un espace d'agent

Une fois enregistré PagerDuty au niveau du compte, vous pouvez le connecter à des espaces d'agent individuels :

  1. Dans la console de l' AWS DevOps agent, sélectionnez votre espace d'agent

  2. Accédez à l'onglet Capacités

  3. Dans la section Communications, choisissez Ajouter

  4. Choisissez l'PagerDutyenregistrement auquel vous souhaitez vous connecter à cet espace d'agent.

  5. Choisissez Enregistrer.

Un seul espace d'agent peut utiliser plus PagerDuty d'un enregistrement. Pour connecter un autre enregistrement, répétez ces étapes.

Gestion des PagerDuty connexions

  • Mise à jour des informations d'identification  : si vos informations d'identification OAuth doivent être mises à jour, PagerDuty désenregistrez-vous sur la page Capability Providers et réinscrivez-vous avec les nouvelles informations d'identification.

  • Affichage des connexions  : dans la console de l' AWS DevOps agent, sélectionnez votre espace agent et accédez à l'onglet Fonctionnalités pour afficher les intégrations de communications connectées.

  • Suppression PagerDuty  : pour vous PagerDuty déconnecter d'un espace d'agent, sélectionnez-le dans la section Communications et choisissez Supprimer. Pour supprimer complètement l'enregistrement, supprimez-le d'abord de tous les espaces d'agent, puis désenregistrez-vous de la page Capability Providers.

Prise en charge des webhooks

AWS DevOps L'agent ne prend en charge que les webhooks PagerDuty V3. Les versions antérieures du webhook ne sont pas prises en charge.

Pour plus d'informations sur les abonnements Webhook PagerDuty V3, consultez la section Présentation des Webhooks dans la documentation destinée aux PagerDuty développeurs.