Configurer Connecteur du graphe de services pour OpenTelemetry

  • Rversion finale: Australia
  • Mis à jour 12 mars 2026
  • 9 minutes de lecture

    • Configurez des tâches d’importation planifiées pour extraire des données de ServiceNow Observabilité du cloud (anciennement Lightstep) vers votre Base de données de gestion des configurations (CMDB).

    Avant de commencer

    Important :
    À partir de la version Australia, Connecteur du graphe de services pour OpenTelemetry ne sera plus disponible. L'application sera masquée et ne sera plus installée sur les nouvelles instances, mais continuera d'être prise en charge. Pour en savoir plus, consultez l'article Processus de retrait [KB0867184] dans la base de connaissances Now Support.

    Pour utiliser cette optionConnecteur du graphe de services, vous devez être abonné à une unité d’abonnement basée sur l’application Gestion des opérations ITITOM() Visibility () Visibility ( Visibilité ou l’application ITOM Découverte). Comme défini dans la section intitulée « Types de ressources informatiques gérées » dans la vue d’ensemble de l’unité d’abonnement ServiceNow pour votre abonnement, pour les ressources informatiques gérées qui sont créées ou modifiées dans le CMDB cadre de cet Connecteur du graphe de services abonnement, mais qui ne sont pas encore gérées par Visibilité ITOM ou Découverte ITOM, ces ressources augmenteront la consommation d’unités d’abonnement à partir de cette application. Vérifiez votre consommation actuelle d’unités d’abonnement dans Visibilité ITOM ou Découverte ITOM pour vous assurer de la capacité disponible.

    Dépendances et exigences :
    • L’application du magasin Integration Commons for CMDB, qui est automatiquement installée.
    • L’application de stockage des modèles de classe CI CMDB, qui est automatiquement installée. Consultez Application Modèles de classe CI CMDB.
    • Le module d’extension ITOM Découverte License (com.snc.itom.discovery.license). Vous devez activer ce module d’extension.
    • Module d’extension Gestion des licences ITOM (com.snc.itom.license). Pour plus d’informations, consultez la section Demander la découverte.
    • Le module d’extension Datastream Action (com.glide.hub.action_type.datastream), qui est automatiquement installé.
    • Éléments communs d’observabilité pour CMDB (sn_observability), qui ne sont requis que pour l’ingestion d’événements. Pour que la gestion des événements fonctionne, Observability Commons pour l’application doit être installé avant CMDB d’installer le connecteur. Pour plus d’informations, consultez Observability Commons for CMDB sur le ServiceNow Store.
    Remarque :
    Si vous disposez d’une version antérieure de , Connecteur du graphe de services pour OpenTelemetry ne migrez pas les données à partir de l’ancien connecteur. Vous devez désinstaller la version précédente et exécuter la nouvelle intégration.

    Rôle requis : admin

    Procédure

    1. Assurez-vous que le périmètre de l’application est défini Connecteur du graphe de services pour OpenTelemetry à l’aide du sélecteur d’application.
      Pour plus d’informations, voir Sélecteur d’application.
    2. Accédez à la Tous > Connecteurs du graphe de services > OpenTelemetry > Configuration.
    3. Sur la page Mise en route, sélectionnez Mise en route.
    4. Configurez les propriétés de l’application pour configurer les informations d’identification de votre organisation et d’authentification pour l’envoi ServiceNow Observabilité du cloud de demandes aux API.
      1. Dans la section Configurer la connexion de la page Connecteur du graphe de services pour OpenTelemetry , sélectionnez Démarrer.
      2. Pour la tâche Utiliser OpenTelemetry , assurez-vous que l’application Observabilité du cloud répond aux conditions décrites dans l’article Configuration de l’observabilité du cloud ServiceNow [KB1527588] dans la Now Support base de connaissances.
        Important :
        Notez les détails de vos projets, de votre organisation et de la clé d’API de l’application Observabilité du cloud à utiliser ultérieurement lors de l’installation du connecteur.
        Une fois que vous avez configuré l’environnement OpenTelemetry dans l’application Observabilité du cloud , revenez à la configuration guidée et marquez la tâche Utiliser OpenTelemetry à terminer en sélectionnant Marquer comme terminé.
      3. Saisissez les détails de votre Observabilité du cloud organisation à partir de l’endroit où vous souhaitez récupérer les projets, les ressources et les informations de mappage des dépendances.
        1. Pour la tâche Configurer votre organisation , sélectionnez Configurer.
        2. Dans le champ Valeur du formulaire Propriétés de connexion du graphe de services, saisissez le nom de votre Observabilité du cloud organisation.
        3. Sélectionnez Mettre à jour.
        4. Marquez la tâche Configurer votre organisation à terminer en sélectionnant Marquer comme terminé.
      4. Entrez les détails de clé d’API associés à l’application Observabilité du cloud .
        1. Pour la tâche Configurer la clé API , sélectionnez Configurer.
        2. Dans le champ Clé API du formulaire Informations d’identification de clé API, entrez la clé API associée à l’application que vous avez notée à l’étape Observabilité du cloud4.b.
        3. Sélectionnez Mettre à jour.
        4. Définissez la tâche Configurer la clé API à terminer en sélectionnant Marquer comme terminé.
      5. Testez la connexion d’API Observabilité du cloud pour importer des données à partir de l’application Observabilité du cloud .
        1. Pour la tâche Tester la connexion , sélectionnez Configurer.
        2. Sélectionnez le lien connexe Test de la connexion .
        3. Lorsque le champ État est défini sur Réussite, sélectionnez X pour fermer la boîte de dialogue Tester la connexion et revenir à la page Configuration guidée.

          Si l’un des tests présente des erreurs, suivez les suggestions pour y remédier.

        4. Définissez la tâche Test de la connexion à terminer en sélectionnant Marquer comme terminé.
      6. Récupérez tous les projets compris dans votre Observabilité du cloud organisation.
        1. Pour la tâche Obtenir des projets , sélectionnez Configurer.
        2. Sélectionnez Obtenir des projets.
        3. Lorsque la liste connexe Propriétés du projet est renseignée avec tous les projets inclus dans l’organisation que vous avez spécifiée à l’étape 4.c.ii, sélectionnez X pour fermer la boîte de dialogue Obtenir des projets et revenir à la page de configuration guidée.
        4. Définissez la tâche Obtenir des projets comme terminée en sélectionnant Marquer comme terminé.
    5. Facultatif : Configurez des configurations supplémentaires pour définir le délai de vérification, ajouter des projets exclus, exécuter des diagnostics de projet et configurer les paramètres d’intégration pour les cartes de services et les éléments de configuration (CI) périmés.
      1. Dans la section Paramètres avancés de la page Connecteur du graphe de services pour OpenTelemetry , sélectionnez Continuer.
      2. Configurez l’heure de vérification à partir du moment où vous souhaitez récupérer les ressources des projets.

        La durée de vérification est utilisée pour calculer l’heure de début et de fin de récupération des ressources d’un projet d’une organisation et doit correspondre au paramètre de fréquence de la tâche planifiée. Par exemple, si la durée de vérification est définie sur 12 heures, les ressources sont récupérées à partir de l’heure de début calculée comme étant l’heure actuelle moins 12 heures et jusqu’à l’heure de fin correspondant à l’heure actuelle.

        1. Pour la tâche Configurer l’heure de vérification , sélectionnez Configurer.
        2. Dans le champ Valeur du formulaire Propriétés de connexion à Graphe de services, saisissez la durée de vérification en heures.
        3. Sélectionnez Mettre à jour.
        4. Définissez la tâche Configurer la durée de vérification à terminer en sélectionnant Marquer comme terminé.
      3. Sélectionnez les projets à partir desquels vous ne souhaitez pas récupérer de ressources.
        1. Pour la tâche Ajouter des projets exclus , sélectionnez Configurer.
        2. Sélectionnez un projet dans la colonne Projet .
        3. Cochez la case Exclure le projet .
        4. Sélectionnez Mettre à jour.
        5. Répétez les étapes de 5.c.ii à 5.c.iv pour chaque projet que vous souhaitez exclure.
        6. Sélectionnez X pour fermer la boîte de dialogue Ajouter des projets exclus et revenir à la page de configuration guidée.
        7. Définissez la tâche Ajouter des projets exclus à terminer en sélectionnant Marquer comme terminé.
      4. Exécutez des diagnostics de projet pour tester la réponse de l’API de ressource et vous assurer que l’API contient le nom de la grappe, Kubernetes l’espace de noms et Kubernetes les Kubernetes nœuds.
        1. Pour la tâche Exécuter les diagnostics de projet , sélectionnez Configurer.
        2. Sélectionnez un projet dans la colonne Projet .
        3. Sélectionnez Exécuter les diagnostics.
        4. Lorsque le champ État du diagnostic est défini sur Réussite, sélectionnez X pour fermer la boîte de dialogue Exécuter les diagnostics du projet et revenir à la page de configuration guidée.

          Si l’un des tests de diagnostic présente des erreurs, suivez les instructions du champ de message Diagnostics pour résoudre les erreurs.

        5. Répétez les étapes 5.d.ii pour 5.d.iv chaque projet sur lequel vous souhaitez exécuter des diagnostics.
        6. Définissez la tâche Exécuter les diagnostics de projet comme terminée en sélectionnant Marquer comme terminé.
      5. Configurez les propriétés système pour les cartes de services et les CI périmés.
        1. Pour la tâche Configurer les propriétés système du connecteur , sélectionnez Configurer.
        2. Vérifiez les valeurs par défaut des propriétés ou renseignez les valeurs d’une configuration personnalisée.
        3. Sélectionnez Enregistrer.
        4. Configurez les propriétés système pour que la tâche du connecteur se termine en sélectionnant Marquer comme terminé.
    6. Configurez les travaux planifiés pour importer des données complètes ou incrémentielles à partir de l’application Observabilité du cloud .
      1. Dans la section Configurer les tâches d’importation planifiée de la page Connecteur du graphe de services pour OpenTelemetry , sélectionnez Continuer.
      2. Activez la tâche planifiée pour l’importation complète des données.

        Par défaut, la tâche planifiée est disponible pour l’importation complète des OpenTelemetry Resources données. Toutefois, vous devez activer la tâche.

        1. Pour la tâche Configurer la tâche planifiée pour l’importation complète , sélectionnez Configurer.
        2. Dans le formulaire Importation de données planifiée pour la OpenTelemetry Resources tâche planifiée, vérifiez les valeurs de champ de la tâche planifiée et cochez la case Actif .

          Pour plus d'informations, consultez Schedule a data import.

        3. Sélectionnez Mettre à jour.
        4. Configurez la tâche planifiée pour que la tâche d’importation complète soit terminée en sélectionnant Mark as Complete (Marquer comme terminé) dans la configuration guidée.
      3. Facultatif : Activez la tâche planifiée pour l’importation de données delta.

        Par défaut, la tâche planifiée est disponible pour l’importation OpenTelemetry Delta Resources de données delta. Toutefois, vous devez activer la tâche.

        Remarque :
        L’extraction de données delta ne se produit pas dans les scénarios suivants :
        • L'importation complète des données est planifiée en même temps.
        • Le champ Date/heure de la dernière exécution d’une source de données est vide.
        • La dernière période d’extraction de données delta est supérieure à 3 jours.
        1. Pour la tâche Configurer la tâche planifiée pour l’importation de différentiel , sélectionnez Configurer.
        2. Dans le formulaire Importation de données planifiée pour la OpenTelemetry Delta Resources tâche planifiée, vérifiez les valeurs de champ de la tâche planifiée et cochez la case Actif .

          Pour plus d'informations, consultez Schedule a data import.

        3. Sélectionnez Mettre à jour.
        4. Configurez la tâche planifiée pour que la tâche d’importation delta se termine en sélectionnant Mark as Complete (Marquer comme terminé) dans la configuration guidée.
      Remarque :
      Lors de l’ajout d’un nouveau projet pour récupérer des ressources, assurez-vous d’effectuer une importation complète avant d’exécuter une importation delta afin d’éviter les données partielles et de renseigner les CMDB données avec précision.
    7. Gérez les alertes et les événements en envoyant des événements de l’application Observabilité du cloud à l’application ServiceNow Gestion des événements .
      Vous pouvez gérer les alertes et les événements uniquement lorsque l’application Observability Commons for CMDB est installée.
      Remarque :
      L’activation de cette fonctionnalité nécessite une licence payante Observabilité du cloud , mais la fonctionnalité est également disponible pour les comptes gratuits dans le but d’évaluer le produit dans des environnements de non-production. Vous pouvez contacter votre ServiceNow représentant de compte pour plus d’informations.
      1. Dans la section Gérer les alertes et les événements de la page Connecteur du graphe de services pour OpenTelemetry , sélectionnez Continuer.
      2. Créez une destination webhook pour un projet.
        1. Pour la tâche Créer un webhook , sélectionnez Configurer.
        2. Sélectionnez un projet qui n’est pas exclu de la colonne Projet .
        3. Sélectionnez Créer un webhook pour créer une destination webhook dans l’application Observabilité du cloud .
        4. Lorsqu’un message de réussite s’affiche, sélectionnez X pour fermer la boîte de dialogue Créer un webhook et revenir à la page Configuration guidée.

          Lorsque le webhook est créé avec succès :

          • Le système crée automatiquement un enregistrement utilisateur pour chaque destination webhook dans votre ServiceNow instance.
          • Le nom d’utilisateur de l’enregistrement utilisateur commence par ls_api_<project_name> et le rôle de evt_mgmt_integration est affecté à l’utilisateur.
        5. Répétez les étapes 7.b.ii7.b.iv pour chaque projet pour lequel vous souhaitez créer un webhook.
        6. Définissez la tâche Créer un webhook à terminer en sélectionnant Marquer comme terminé dans la configuration guidée.
      3. Configurez la propriété système d’ingestion des événements qui n’ont pas de CI correspondant dans la CMDB.
        1. Pour la tâche Configurer la propriété pour les CI sans correspondance , sélectionnez Configurer.
        2. Dans le champ Valeur, saisissez vrai.
        3. Sélectionnez Mettre à jour.
        4. Définissez la tâche Configurer la propriété des CI sans correspondance à terminer en sélectionnant Marquer comme terminé dans la configuration guidée.