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

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

Intégration

Étape 1 : Connect

Établissez une connexion à votre point de terminaison MCP distant Datadog à l'aide des identifiants 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 dans votre navigateur lorsque vous êtes connecté à Datadog, ou consultez Accéder au site Datadog.

Autorisation

Complétez l'autorisation OAuth en :

Une fois configuré, Datadog est disponible dans tous les espaces Agent.

Étape 2 : activer

Activez DataDog dans un espace d'agent spécifique et configurez le scoping approprié

Configuration

Étape 3 : Configuration des webhooks

À l'aide de l'URL du webhook et de la clé d'API indiquées à 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 porteur. Pour le format général de demande de webhook et le schéma de charge utile, voir. Invocation de DevOps l'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 référencez plutôt 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 surveillance standard, notamment les moniteurs métriques, log, APM et Synthetics. Datadog remplace les $VARIABLE espaces réservés lorsqu'il envoie le webhook ; laissez-les tels quels.

{
  "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, de manière à ce que seule la transition d'alerte le 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 déclenchent des enquêtes pour des 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 les points suivants :

Pour la résolution générale des problèmes liés aux webhooks, consultezInvocation de DevOps l'agent via Webhook.

Pour en savoir plus : Serveur MCP distant Datadog

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 il peut être désenregistré.

Étape 1 : Supprimer de l'espace agent

Étape 2 : Désenregistrer du compte