ServiceNow
Rapport de recherche Datadog : Bilan sur l'adoption de l'informatique sans serveur Rapport : Bilan sur l'adoption de l'informatique sans serveur

ServiceNow

Crawler Crawler

Présentation

ServiceNow est une plateforme de gestion informatique centralisée pour l’enregistrement, le suivi et la gestion des processus informatiques d’entreprise.

L’intégration Datadog/ServiceNow est une intégration bidirectionnelle qui vous permet de :

  1. Créer des incidents ou des événements avec un contexte détaillé dans ServiceNow à partir d’alertes Datadog
  2. Synchroniser des métadonnées importantes telles que des services métier à partir de votre CMDB avec Datadog, et de vous en servir comme de tags dans l’ensemble de la plateforme Datadog pour regrouper et filtrer ainsi que pour créer des alertes
  3. Créer des éléments de configuration (configuration items ou CI) serveur dans la CMDB, pour les hosts découverts récemment à partir de Datadog

Datadog peut être intégré aux outils ServiceNow suivants :

  • ITOM
  • ITSM
  • CMDB

Remarque : chacun de ces modules ServiceNow peut être utilisé de façon indépendante avec l’intégration. Par exemple, vous pouvez utiliser ITSM sans CMDB.

Implémentation

Pour utiliser l’un des modules, commencez par installer le dernier ensemble de mise à jour de Datadog sur votre instance ServiceNow, puis configurez le carré d’intégration ServiceNow dans Datadog.

  1. Installer le dernier ensemble de mise à jour Datadog
  2. Définir les autorisations du compte Datadog
  3. Instructions pour CMDB
  4. Instructions pour ITOM et ITSM

Installer l’ensemble de mise à jour Datadog

Dans ServiceNow :

  • Recherchez Update Set.
  • Cherchez Retrieved Update Sets dans le menu.
  • Importez manuellement le fichier Datadog-SNow_Update_Set_vX.X.X.xml.

Importez l’ensemble de mise à jour XML Datadog fourni.

Une fois le fichier XML téléchargé, l’état Loaded s’affiche. Cliquez sur le nom de l’ensemble de mise à jour pour afficher un aperçu et réaliser un commit du code dans le système.

Affichez un aperçu de l’ensemble de mise à jour pour vérifier l’absence d’erreurs :

Sélectionnez Commit Update Set pour fusionner l’application avec votre système :

Vous devriez maintenant être en mesure de rechercher Datadog dans le menu de navigation et de voir les tables s’afficher :

Autorisations

Pour accéder aux tables d’importation et appliquer des transform maps, l’utilisateur ServiceNow doit disposer des autorisations suivantes :

  • x_datad_datadog.user
  • import_set_loader
  • import_transformer

Pour les utilisateurs d’ITOM et ITSM :

Si vous souhaitez envoyer des notifications directement dans une table Incident ou Event, les rôles ITIL et evt_mgmt_integration sont alors nécessaires.

Configuration de l’intégration pour CMDB

Nous partons du principe que vous avez déjà installé le dernier ensemble de mise à jour Datadog. Si ce n’est pas le cas, consultez les instructions d’installation du dernier ensemble de mise à jour.

Ajoutez Datadog en tant que source de découverte afin d’associer les CI et de les ajouter à la CMDB.

  1. Dans ServiceNow, accédez à System Definitions > Choice Lists et créez une nouvelle entrée avec les valeurs suivantes :

    • Table : Configuration Item [cmdb_ci]
    • Element : discovery_source
    • Label : Datadog
    • Value : Datadog
  2. Recherchez l’intégration Datadog, puis cliquez sur Datadog Integration Settings dans le menu.

  3. Activez le paramètre suivant : Enable adding Datadog hosts into ServiceNow CMDB.

    • Cela permet à Datadog d’envoyer les données de configuration à la CMDB ServiceNow. Vous pouvez ajouter des tags aux hosts qui ont été associés aux CI de la CMDB ServiceNow dans Datadog.

    Remarque : l’option « Enable adding Datadog hosts into ServiceNow CMDB » doit être activée pour que la fonctionnalité de synchronisation de tag fonctionne.

    • Par défaut, aucun tag n’est synchronisé entre ServiceNow et Datadog. Trois sources de données différentes peuvent être utilisées pour les tags :

      • Labels
      • Business Services
      • Configuration Item (CI) attributes
    • Dans l’exemple de configuration ci-dessous, les étiquettes et les services métiers sont ajoutés en tant que tags, ainsi que les attributs sys_id and sys_class_name

  4. Vous pouvez personnaliser la fréquence d’écriture des données sur votre CMDB en modifiant votre règle Autoflush.

  5. Il est également possible de personnaliser les entrées dans la CMDB en configurant des transform maps personnalisées.

  6. Configurer le carré d’intégration ServiceNow dans Datadog

Configuration pour l’utilisation des modules ITOM et ITSM

Les notifications Datadog mentionnant @servicenow remplissent les tables intermédiaires sélectionnées dans votre carré ServiceNow. Veuillez noter que pour les étapes décrites ci-dessous, nous partons du principe que vous avez déjà configuré le carré d’intégration dans la page d’intégrations Datadog. Procédez ainsi comme suit :

  1. Depuis la liste déroulante, sélectionnez la table intermédiaire vers laquelle vous souhaitez envoyer les notifications.
  2. Pour vérifier que l’intégration est correctement configurée, ajoutez @servicenow dans une notification de monitor ou d’événement. Les données brutes remplissent les lignes dans la table temporaire et sont transmises à la table ServiceNow spécifiée dans les mappages et les transformations que vous avez créés.
  3. Utilisez des transform maps pour personnaliser le format des données envoyées aux tables.
  4. Configurer le carré d’intégration ServiceNow dans Datadog

Configurer le carré d’intégration ServiceNow dans Datadog

  1. Accédez au carré d’intégration ServiceNow Datadog, depuis la page Integrations.
  2. Ajoutez le nom de l’instance, à savoir le sous-domaine de votre domaine ServiceNow : <NOM_INSTANCE>.service-now.com.
  3. Ajoutez le nom d”utilisateur et le mot de passe de votre instance ServiceNow. Si vous utilisez le module ITSM ou ITOM et souhaitez envoyer des notifications à une table intermédiaire, sélectionnez-la dans la liste déroulante.

Remarque : vous pouvez créer un utilisateur limité dédié à Datadog dans ServiceNow.

Personnaliser les données avec des transform maps

Pour CMDB

Datadog propose des transform maps qui créent des incidents et des éléments de configuration de la CMDB. Chaque CMDB pouvant être différente, vérifiez la correspondance par défaut requise par votre CMDB.

Pour accéder aux transform maps :

  1. Recherchez Datadog Tables ou Import hosts.
  2. Choisissez une table dans la barre latérale.
  3. Cliquez sur Transform Maps sous Related Links.

La table « Import hosts » possède deux transform maps, une pour chaque profil pouvant être créé. Si vous utilisez Linux, le profil cmdb_ci_linux_server est créé (ou mis en correspondance avec un CI existant). Sinon, le profil cmdb_ci_server est utilisé comme solution alternative. Des transform maps supplémentaires peuvent être créées pour veiller à ce que le bon profil de configuration soit utilisé.

Pour en savoir plus sur la modification ou la création de mappages et de transformations supplémentaires, consultez la section Définir des mappages personnalisés.

Pour ITOM et ITSM

Les tables Datadog Incident et Datadog Event utilisent une transform map pour transformer les événements Datadog en incidents et événements correspondants dans ServiceNow.

Dépannage

Si aucun événement n’apparaît dans vos tables ServiceNow, et que :

  • Vous voyez un message d’erreur dans votre carré d’intégration Datadog ou une notification Error while trying to post to your ServiceNow instance :

    • Vérifiez que seul le sous-domaine a été indiqué pour le nom de votre instance.
    • Vérifiez que l’utilisateur créé dispose des autorisations requises.
    • Vérifiez que le nom d’utilisateur et le mot de passe sont corrects.
  • L’intégration est configurée, une alerte se déclenche, mais aucun ticket n’est créé :

    • Vérifiez que la table temporaire contient bien les données. Si c’est bien le cas, le problème est lié aux mappages et aux transformations. Vous pouvez débuguer davantage vos mappages et scripts en accédant à Transform Errors dans ServiceNow.
    • Vérifiez que vous utilisez la table intermédiaire spécifiée dans le carré.

L’utilisateur ServiceNow doit posséder les rôles rest_service et x_datad_datadog.user afin de pouvoir accéder aux tables d’importation. Si vous utilisez l’ancienne méthode consistant à envoyer les notifications directement à la table Incident ou Event, les autorisations itil et evt_mgmt_integration sont alors nécessaires.

Besoin d’aide supplémentaire ? Contactez l’assistance Datadog.

Base de connaissances

Règle Autoflush de la table Import Host

Pour empêcher la table Import Set x_datad_datadog_import_host d’accumuler un nombre trop important de lignes, une règle AutoFlush a été ajoutée dans le nettoyeur de table afin de conserver uniquement les données des dernières 24 heures. Ce paramètre de configuration peut être modifié en fonction de vos besoins. Pour ce faire, accédez à sys_auto_flush_list.do dans le navigateur de filtres, puis à la règle de la table x_datad_datadog_import_host. Vous pouvez alors modifier la valeur du champ Age in seconds.

Générer des tickets d’assistance automatiquement à partir des alertes Datadog

Une fois que ServiceNow est connecté à votre compte Datadog, les alertes reçues peuvent automatiquement créer des tickets d’assistance et les envoyer dans la file d’attente de tickets ServiceNow. Votre équipe d’assistance est alors informée des problèmes à l’aide des workflows de communication que vous avez déjà établis dans ServiceNow. Mentionnez @servicenow dans le message d’alerte ou ajoutez @servicenow à la liste de notifications pour ce monitor.

Utiliser des variables dans la charge utile des tickets et les mappages de champ

Des variables peuvent être utilisées dans le corps de vos alertes ou dans les mappages de champ pour s’assurer que les détails de l’événement sont inclus dans ServiceNow. Par exemple, il est possible d’inclure le titre et la sévérité dans le champ ServiceNow approprié, ou encore d’ajouter un lien permettant de revenir vers l’incident spécifique dans Datadog directement depuis le ticket ServiceNow.

Automatiser le workflow de résolution des tickets d’assistance

Une fois que l’état normal du monitor est rétabli, le ticket d’assistance associé est automatiquement considéré comme résolu.

Envoyer des graphiques Datadog à ServiceNow

Outre l’automatisation de la création et de la résolution de tickets, vous pouvez utiliser Datadog pour créer des tickets ServiceNow ponctuels lorsque vous identifiez un problème dans Datadog nécessitant l’attention de l’équipe. Cliquez sur l’icône en forme d’appareil photo pour partager un snapshot de n’importe quel graphique de timeboard, ajoutez du contexte dans la zone de commentaires et mentionnez @servicenow pour envoyer le graphique et vos commentaires à ServiceNow.

Définir des mappages personnalisés

Cliquez sur Datadog Incident Tables (par exemple) et accédez au lien vers la transform map associée en bas de la page :

Comprendre le mappage

Cliquez sur le nom de la transform map pour en afficher les détails :

Deux champs importants se trouvent en haut de la page : Source table et Target table.

Remarques :

  • La source désigne la table Import Set que vous avez sélectionnée (tables Datadog Incident), tandis que la cible (target) correspond à la table Incident (ou la table Event) dans laquelle les événements sont réellement stockés.
  • Les mappages de champ se trouvent en bas de la page. Certains mappages de base sont compris. C’est à cet endroit que vous pouvez sélectionner les champs à inclure, définir le format et sélectionner les champs cibles dans votre instance ServiceNow.

Ajouter un nouveau mappage de champ

Cliquez sur New :

Sélectionnez les champs source et cible pour les mappages un à un :

Sinon, cochez la case Use source script et définissez les transformations :

Définir plusieurs mappages

Utilisez Mapping Assist (sous Related Links) pour mapper plusieurs champs source et cible :

Validation

Pour vérifier que l’intégration est correctement configurée, ajoutez @servicenow dans une notification de monitor ou d’événement. Les données brutes remplissent les lignes dans la table temporaire et sont transmises à la table ServiceNow spécifiée dans les mappages et les transformations que vous avez créés.

Pour aller plus loin

Documentation, liens et articles supplémentaires utiles: