Guide d'intégration Datadog

Avantages de l'intégration PagerDuty + Datadog

• Avertissez les intervenants d'astreinte en fonction des alertes envoyées par Datadog.
• Envoyez des données d'événement enrichies depuis Datadog, y compris des visualisations de la métrique/indicateur de niveau de service (SLI) qui a déclenché l'événement.
• Créez des incidents d'urgence élevée et faible en fonction de la gravité de l'événement à partir de la charge utile de l'événement Datadog.
• Les incidents et les escalades sont synchronisés sur PagerDuty et Datadog au fur et à mesure de leur mise à jour.
• Les incidents seront automatiquement résolus dans PagerDuty lorsque la métrique dans Datadog reviendra à la normale avec une synchronisation bidirectionnelle.

Comment ça fonctionne

• Les métriques Datadog qui se situent en dehors d'une plage désignée enverront un événement à un service dans PagerDuty. Les événements de Datadog déclencheront un nouvel incident sur le service PagerDuty correspondant, ou groupe comme alertes dans un incident existant.
• Une fois que la métrique est revenue à sa plage désignée, un résoudre L'événement sera envoyé au service PagerDuty pour résoudre l'alerte et l'incident associé sur ce service.

Exigences

• Les intégrations PagerDuty nécessitent un Rôle de base d'administrateur pour l'autorisation de compte. Si vous ne disposez pas de ce rôle, veuillez contacter un administrateur ou un propriétaire de compte au sein de votre organisation pour configurer l'intégration.

Procédure pas à pas d'intégration

Dans PagerDuty

Il existe deux manières d'intégrer Datadog à PagerDuty: via Global Event Routing ou via une intégration sur un service PagerDuty .

Si vous ajoutez Datadog à un service PagerDuty existant, veuillez passer à la page Intégration avec un service PagerDuty section de ce guide.

Intégration avec le routage global des événements

L'intégration avec Global Event Routing vous permet d'acheminer des événements vers des services spécifiques en fonction de la charge utile de l'événement de Datadog. Si vous souhaitez en savoir plus, veuillez consulter notre article sur Ensembles de règles .

1. Du Automatisation menu, sélectionnez Règles de l'événement et cliquez sur votre Ensemble de règles globales par défaut.

2. Sur l'écran Règles de l'événement, cliquez sur la flèche à côté de Source d'événement entrant pour afficher les informations sur la clé d'intégration. Copiez votre Clé d'intégration . Il s'agit de la même clé d'intégration que vous utiliserez pour tout autre outil que vous souhaitez intégrer à l'aide de règles d'événement. Lorsque vous aurez terminé de configurer l'intégration dans Datadog, vous reviendrez à cette interface pour spécifier comment acheminer les événements de Datadog vers les services dans PagerDuty.

 

Conservez cette clé dans un endroit sûr pour une utilisation ultérieure. Vous pouvez maintenant passer au Dans Datadog section ci-dessous.

Note : Si votre équipe a déjà intégré en utilisant règles de l'événement , vous pouvez le vérifier en recherchant la clé d'intégration des règles d'événement PagerDuty dans l'onglet Intégrations de Datadog. Vous pouvez ensuite utiliser l'intégration existante et rediriger les événements Datadog vers votre service en écrivant de nouvelles règles d'événement pour votre service.

Intégration avec un service PagerDuty

L'intégration directe avec un service PagerDuty peut être bénéfique si vous n'avez pas besoin d'acheminer les alertes de Datadog vers différents intervenants en fonction de la charge utile de l'événement. Vous pouvez toujours utiliser règles d'événement au niveau du service pour effectuer des actions telles que la suppression des alertes non exploitables et l'ajustement de la gravité.

1. Du Prestations de service menu, sélectionnez Répertoire des services .

2. Si vous ajoutez votre intégration à un service existant , cliquez sur le nom du service auquel vous souhaitez ajouter l'intégration. Sélectionnez ensuite le Onglet Intégrations et cliquez sur le Ajouter une intégration .

Si vous créez un nouveau service pour votre intégration, veuillez lire notre documentation dans la section Configuration des services et des intégrations et suivez les étapes décrites dans le Créer un nouveau service section, en sélectionnant Datadog comme Type d'intégration à l'étape 4. Continuez avec la Dans Datadog (ci-dessous) une fois que vous avez terminé ces étapes.

3.S élire Chien de données du Type d'intégration menu.

4. Cliquez sur Ajouter pour enregistrer votre nouvelle intégration. Vous serez redirigé vers l'onglet Intégrations de votre service.

5. Recherchez votre intégration dans la liste et cliquez sur le ∨ à droite. Le Clé d'intégration généré ici sera ici utilisé lorsque vous configurerez l’intégration avec Datadog dans la section suivante.

Dans Datadog

Si vous avez déjà installé Datadog, veuillez passer à l'étape 6.

1. Dans votre compte Datadog, accédez à la barre de menu Intégrations et cliquez sur Intégrations .

2. Recherchez PagerDuty et survolez l'icône pour cliquer Installer .

3. Sur l’écran Intégration PagerDuty , sélectionnez le Configuration onglet puis cliquez sur Alerte avec PagerDuty .

4. Vous serez redirigé vers un écran d'autorisation PagerDuty . Il existe deux manières d'autoriser l'intégration :

un. Entrez vos informations de connexion PagerDuty et cliquez sur Autoriser l'intégration .

b. Si votre compte utilise un fournisseur d'authentification unique, saisissez votre sous-domaine et cliquez sur Connectez-vous à l'aide de votre fournisseur d'identité .

5. Sur l'écran suivant, plusieurs options vous seront proposées en fonction de la façon dont vous intégrez :

un. Si vous êtes Intégration avec un service PagerDuty : sélectionner Utiliser une intégration sur un service existant et sélectionnez votre service dans le menu déroulant.

b. Si vous êtes Intégration avec le routage global des événements : sélectionner Créer un nouveau service avec une intégration pour Datadog . Entrez un espace réservé Nom du service et Politique de remontée d'informations — ce service et tous ses paramètres seront remplacés par votre clé d'intégration du routage d'événements global à l'étape 6 (ci-dessous).

c. Une fois votre sélection effectuée, cliquez sur Terminer l'intégration .

6. Vous serez redirigé vers l'écran d'intégration PagerDuty dans Datadog et votre nouvelle intégration sera autorisée. Sur cet écran, vous aurez plusieurs options pour corréler les incidents dans les services PagerDuty avec les métriques Datadog :

un. Avertissez PagerDuty avec @ Mentions : Si vous souhaitez déclencher, accuser réception ou résoudre des incidents dans PagerDuty via le flux d'événements Datadog, vous devrez saisir votre clé d'intégration :

je. Si vous êtes Intégration avec le routage global des événements : Supprimez les informations pré-remplies dans le Nom du service/table de règles et Champs Clé d'intégration / Clé de routage et saisissez un nom et la clé d'intégration générés à l'étape 2 du Intégration avec le routage global des événements section.

ii. Si vous êtes Intégration avec un service PagerDuty : Le nom du service et la clé d'intégration générés à l'étape 5 du Intégration avec un service PagerDuty La section sera pré-remplie pour vous et aucune action n'est nécessaire. Si vous souhaitez ajouter plusieurs services à votre flux d'événements, saisissez le nom et la clé d'intégration de chaque service dans le champ
Nom du service/table de règles et Champs Clé d'intégration / Clé de routage .

b. Afficher qui est de garde dans votre flux d'événements : Si vous souhaitez consulter vos plannings de garde PagerDuty dans votre flux d'événements Datadog, vous devrez récupérer l'URL du planning PagerDuty . Dans PagerDuty, accédez au Configuration menu et sélectionnez Des horaires , puis cliquez sur le planning souhaité et copiez son URL, qui devrait ressembler à ceci : https://VOTRESUBDOMAIN.pagerduty.com/schedules#PXXXXXX . Dans Datadog, collez ceci dans le URL de planification champ.

c. Vous aurez alors deux options pour extraire les informations de PagerDuty dans votre flux d'événements :

je. Jeton API  : Pour extraire des informations limitées sur les incidents PagerDuty dans votre flux d'événements Datadog, saisissez le PagerDuty Clé API REST ici.

ii. Afficher les incidents PagerDuty dans votre flux d'événements : (Recommandé) Pour extraire des informations sur PagerDuty dans votre flux d'événements Datadog, suivez les étapes décrites dans cette section.

d. Une fois que vous avez saisi ces informations d'identification, cliquez sur Mettre à jour la configuration en bas de l'écran.

 

7. Pour tester l'intégration, accédez à Événements → Flux dans le menu de gauche, puis rédigez un message dans le Laisser une mise à jour du statut… champ avec @pagerduty-[Nom du service] (c'est à dire @pagerduty-Shopping-Cart Ouais, c'est ma première alerte Datadog ! ). Cliquez sur Poste et cette publication apparaîtra dans votre flux d'événements Datadog et créera un incident dans PagerDuty.

8. Vous pouvez également accuser réception ou résoudre l'incident PagerDuty dans Datadog en mentionnant @pagerduty-reconnaître ou @pagerduty-résolution .

9. Note: Vous devez ajouter ces mentions comme commentaire sur la publication originale dans le flux de votre événement. Vous pouvez simplement utiliser ces mentions et/ou ajouter des commentaires qui apparaîtront dans le cadre du message d'accusé de réception ou de résolution dans l'incident PagerDuty . Onglet Chronologie :

FAQ

Est-il possible qu'une intégration Datadog achemine les alertes vers plusieurs services ?

Oui. Vous avez deux options : intégrer le routage global des événements ou ajouter plusieurs services à la configuration. Si vous ajoutez plusieurs services à la configuration, dans la configuration d'intégration PagerDuty , vous trouverez votre service intégré existant ainsi que sa clé d'intégration. En dessous, cliquez sur Ajouter une rangée et vous pourrez saisir une autre intégration Datadog sur un autre service.

Vous pouvez ensuite référencer le deuxième service sous Informez votre équipe dans un moniteur Datadog, pour envoyer des alertes à l'autre service spécifiquement pour ce moniteur.

Vous pouvez également cliquer sur le Cliquez ici pour utiliser le même workflow de configuration d'intégration que celui utilisé pour la première intégration.

 

Je vois des événements dans mon fil d'actualité Datadog provenant des services PagerDuty , ce que j'ai fait pas sélectionner pour l'intégration ; Comment puis-je réparer ça?

Par défaut, le Afficher tous les incidents PagerDuty disponibles ? L'option est sélectionnée dans les paramètres d'intégration de PagerDuty dans Datadog. Si vous souhaitez uniquement voir les événements des services que vous avez définis dans le Filtrer les événements par service paramètre, vous devez décocher cette option dans votre configuration d'intégration.