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 DataDog

Built-in, intégration unidirectionnelle

Actuellement, AWS DevOps l'Agent prend en charge les utilisateurs de Datadog grâce à une intégration unidirectionnelle intégrée, qui permet de :

Intégration

Étape 1 : Connexion

Établissez une connexion à votre endpoint MCP distant Datadog à l'aide des informations d'accès au compte

Configuration

Points de terminaison du site Datadog

L'URL du point de terminaison MCP varie en fonction de votre site Datadog. Pour identifier votre site, vérifiez l'URL de votre navigateur lorsque vous êtes connecté à Datadog, ou consultez la section Accéder au site Datadog.

Autorisation

Complétez l'autorisation OAuth en :

Une fois configuré, Datadog devient disponible dans tous les espaces d'agent.

Chaque inscription permet de se connecter à une organisation Datadog. Pour connecter d'autres organisations Datadog, répétez cette procédure pour chacune d'entre elles et attribuez à chaque enregistrement son propre nom de serveur.

Étape 2 : activer

Activez DataDog dans un espace d'agent spécifique et configurez la portée appropriée

Configuration

Un seul espace d'agent peut utiliser plusieurs enregistrements Datadog. Pour ajouter un autre enregistrement, répétez ces étapes.

Étape 3 : Configuration des webhooks

À l'aide de l'URL du Webhook et de la clé d'API de l'étape 2, vous pouvez configurer Datadog pour qu'il envoie des événements qui déclenchent une enquête, par exemple lorsqu'un moniteur émet une alerte.

Les webhooks Datadog utilisent l'authentification par jeton du porteur. Pour le format général de demande de webhook et le schéma de charge utile, consultez. Invoquer un DevOps agent via Webhook Les sections suivantes fournissent une configuration Datadog prête à l'emploi ; vous n'avez pas besoin de créer vous-même la charge utile.

Étape 3.1 : Création du webhook dans Datadog

Valeur d'en-tête personnalisée pour l'étape 6 :

{"Authorization": "Bearer <API_KEY_FROM_STEP_2>"}

Pour éviter de stocker la clé en clair, définissez une variable personnalisée (par exemple$DEVOPS_AGENT_API_KEY) dans la vignette du webhook en sélectionnant Masquer de la vue, et faites plutôt référence à la variable dans la valeur d'en-tête.

Étape 3.2 : Modèle de charge utile pour les alertes déclenchées par le moniteur

Le modèle suivant fonctionne pour les alertes de moniteur standard, y compris les moniteurs métriques, journaux, APM et synthétiques. Datadog remplace les $VARIABLE espaces réservés lorsqu'il envoie le webhook ; conservez-les tels qu'ils sont écrits.

{
  "eventType": "incident",
  "incidentId": "datadog-$ALERT_CYCLE_KEY",
  "action": "created",
  "priority": "HIGH",
  "title": "$ALERT_TITLE",
  "description": "$TEXT_ONLY_MSG",
  "service": "datadog",
  "data": {
    "monitorId": "$ALERT_ID",
    "eventType": "$EVENT_TYPE",
    "alertQuery": "$ALERT_QUERY",
    "alertScope": "$ALERT_SCOPE",
    "alertMetric": "$ALERT_METRIC",
    "alertTransition": "$ALERT_TRANSITION",
    "alertPriority": "$ALERT_PRIORITY",
    "tags": "$TAGS",
    "eventUrl": "$LINK",
    "hostname": "$HOSTNAME"
  }
}

Comment les variables Datadog sont mappées au schéma du webhook

Étape 3.3 : Référencez le webhook depuis vos moniteurs

Dans chaque moniteur dont les alertes devraient déclencher une enquête, ajoutez la mention du webhook au message du moniteur, en veillant à ce que seule la transition d'alerte la déclenche :

{{#is_alert}}
@webhook-devops-agent
{{/is_alert}}

Sans les {{#is_alert}} conditions, les notifications d'avertissement et de restauration envoient également le webhook. Les événements de restauration sont dédupliqués par rapport à l'enquête ouverte$ALERT_CYCLE_KEY, mais les avertissements lancent des enquêtes pour les seuils que vous ne souhaitez peut-être pas examiner.

Vérifiez la configuration

Envoyez une notification de test depuis un moniteur (Notifications de test dans l'éditeur de moniteur) et confirmez ce qui suit :

Pour la résolution générale des problèmes liés aux webhooks, consultezInvoquer un DevOps agent via Webhook.

Pour en savoir plus : Datadog Remote MCP Server

Enlèvement

La source de télémétrie est connectée à deux niveaux au niveau de l'espace agent et au niveau du compte. Pour le supprimer complètement, vous devez d'abord le supprimer de tous les espaces d'agent où il est utilisé, puis vous pouvez le désenregistrer.

Étape 1 : Supprimer de l'espace agent

Étape 2 : Désenregistrer du compte