Intégrer les événements de la plateforme Datadog

  • Rversion finale: Washingtondc
  • Mis à jour 1 févr. 2024
  • 2 minutes de lecture

    • Intégrez Datadog à Gestion des événements en ajoutant un webhook standard dans la console Datadog.

    Avant de commencer

    Assurez-vous que le module d’extension Gestion des événements Connecteurs (sn_em_connector) est installé sur l’instance Now Platform .

    • Rôle requis : evt_mgmt_integration
    • Le module d'extension Gestion des événements doit être installé sur l'instance Now Platform.
    • Vérifiez que les éléments de configuration pour les hôtes gérés par Datadog existent dans ServiceNow. Ces CI peuvent être physiques ou virtuels, et peuvent être créés ou détectés manuellement à l'aide de la détection d'adresses IP ou de Cloud Discovery.

    Pourquoi et quand exécuter cette tâche

    Configurez l'environnement Gestion des événements pour la collecte d'événements à partir de Datadog. Dans votre console Datadog, définissez votre instance Now Platform en tant que point de terminaison REST à l'aide d'un webhook standard.

    Procédure

    1. Dans la console Datadog, ajoutez des balises de fournisseur dans le cloud :
      1. Accédez à la Menu > Infrastructure > Liste d’infrastructures
      2. Cliquez sur Inspecter pour l'ordinateur virtuel sur lequel l'agent Datadog est installé.
      3. Cliquez sur Modifier les balises et ajoutez la balise cloud_provider.
        La balise doit être suivie de la valeur aws, azure ou gcp pour identifier les options de fournisseur AWS, Microsoft Azure ou Google Cloud Platform (GCP). Par exemple : cloud_provider:aws
      4. Cliquez sur Enregistrer les balises pour enregistrer la nouvelle balise.
        Remarque :
        Datadog ajoute la balise cloud_provider par défaut lorsque l'intégration Azure et Google est installée sur l'agent Datadog. Il est également possible d'ajouter des balises au niveau du fournisseur dans le cloud. Datadog collecte toutes les balises définies au niveau de l'ordinateur virtuel dans le cloud.
    2. Dans la console Datadog, ajoutez un webhook :
      1. Accédez à la Menu > Intégration > Intégrationset recherchez des webhooks.
      2. Créez un webhook qui inclut l'ID d'utilisateur et le mot de passe de l'utilisateur ServiceNow dans le point de terminaison.
        Par exemple, utilisez https://<nom d'utilisateur>:<mot de passe>@<nom-instance>.service-now.com/api/sn_em_connector/em/inbound_event?source=datadog.
        Remarque :
        assurez-vous que le rôle evt_mgmt_integration est affecté à l'utilisateur sélectionné ; pour garantir une authentification appropriée, utilisez l'utilisateur le moins privilégié disposant du rôle evt_mgmt_integration, plutôt qu'un utilisateur possédant des privilèges élevés.
      3. Ajoutez la structure de charge utile suivante. 
        { 
    "body": "$EVENT_MSG", 
    "last_updated": "$LAST_UPDATED", 
    "event_type": "$EVENT_TYPE", 
    "title": "$EVENT_TITLE", 
    "date": "$DATE", 
    "org": { 
        "id": "$ORG_ID", 
        "name": "$ORG_NAME" 
    }, 
    "id": "$ID", 
    "alert_id": "$ALERT_ID", 
    "alert_metric": "$ALERT_METRIC", 
    "metric_namespace": "$METRIC_NAMESPACE",
    "alert_priority": "$ALERT_PRIORITY", 
    "alert_transition": "$ALERT_TRANSITION", 
    "alert_status": "$ALERT_STATUS", 
    "alert_title": "$ALERT_TITLE", 
    "alert_type": "$ALERT_TYPE", 
    "host_name": "$HOSTNAME", 
    "priority": "$PRIORITY", 
    "tags": "$TAGS", 
    "alert_scope": "$ALERT_SCOPE" 
}
    3. Dans la console Datadog, définissez les règles suivantes :
      1. Accédez à la Menu > Surveillances > Gérer les moniteurset configurez des règles sur le moment de créer un problème à partir de Datadog sur les hôtes gérés.
      2. Dans la section Notifier votre équipe, sélectionnez le webhook problématique sur lequel porte la notification.

    Résultats

    L'envoi des alertes des agents Datadog au module d'extension Event Management commence. Le module d'extension extrait les informations du message d'alerte Datadog d'origine pour renseigner les champs d'événement requis et insère l'événement dans la base de données. Dans votre instance Now Platform, accédez à Tous les événements pour afficher les événements.

    Remarque :
    Par défaut, la liaison d’hôtes est activée pour les événements Datadog pour les fournisseurs (AWS/Azure/GCP). Si tous les hôtes de l'environnement sont détectés via Détection dans le cloud en fournissant des informations d'identification et que les ressources détectées se trouvent dans la liste cmdb_ci_vm_object, la liaison d'ordinateurs virtuels est impossible. Pour résoudre ce problème, vous devez activer la règle d'événement Datadog - Général. Pour en savoir plus sur les règles d'événements, consultez la rubrique Règles d'événements.