Configurer Connecteur du graphe de service pour OpenTelemetry

  • Rversion finale: Yokohama
  • Mis à jour 30 janv. 2025
  • 9 minutes de lecture

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

    Avant de commencer

    Pour utiliser cette optionConnecteur du graphe de services, vous avez besoin d’un abonnement à une unité d’abonnement basée sur l’application Gestion des opérations ITITOM() Visibility ou sur 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 CMDBConnecteur du graphe de servicesressources informatiques gérées qui sont créées ou modifiées par cet 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 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 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 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 n’est requis que pour l’ingestion d’événements. Pour que la gestion des événements fonctionne, Observability Commons for CMDB app doit être installé avant d’installer le connecteur. Pour plus d’informations, consultez Observability Commons for CMDB sur la .ServiceNow Store
    Remarque :
    Si vous disposez d’une version antérieure de , Connecteur du graphe de service pour OpenTelemetryne 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 service pour OpenTelemetry à l’aide du sélecteur d’application.
      Pour plus d’informations, voir Sélecteur d’application.
    2. Accédez à la Tout > 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 Cloud Observability 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 Cloud Observability répond aux conditions décrites dans l’article Configuration de l’observabilité du cloud ServiceNow [KB1527588] de la Now Support base de connaissances.
        Important :
        Notez les détails de vos projets, de votre organisation et de vos clés d’API de l’application Cloud Observability à utiliser ultérieurement lors de l’installation du connecteur.
        Une fois que vous avez configuré l’environnement dans l’application OpenTelemetryCloud Observability, revenez à la configuration guidée et marquez la tâche Utiliser OpenTelemetry comme terminée en sélectionnant Marquer comme terminé.
      3. Entrez les détails de votre Cloud Observability organisation à partir de l’endroit où vous souhaitez récupérer les informations de mappage des projets, des ressources et 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 à Graphe de services, entrez le nom de votre Cloud Observability 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é API associés à l’application Cloud Observability .
        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 Cloud Observability4.b.
        3. Sélectionnez Mettre à jour.
        4. Configurez la tâche Configurer la clé API à terminer en sélectionnant Marquer comme terminé.
      5. Testez la connexion d’API Cloud Observability pour importer des données à partir de l’application Cloud Observability .
        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 de 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 Tester la connexion comme terminée en sélectionnant Marquer comme terminé.
      6. Récupérez tous les projets compris dans votre Cloud Observability 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 le délai de vérification lorsque 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 qui est 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 comme terminée 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 comme terminée 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 des diagnostics est défini sur Réussite, sélectionnez X pour fermer la boîte de dialogue Exécuter les diagnostics de 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.ii5.d.iv pour 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 les propriétés système Configurer de la tâche de connecteur , sélectionnez Configurer.
        2. Vérifiez les valeurs par défaut des propriétés ou renseignez les valeurs pour une configuration personnalisée.
        3. Sélectionnez Enregistrer.
        4. Définissez les propriétés système Configurer pour que la tâche de 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 Cloud Observability .
      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 OpenTelemetry Resources complète de données. Toutefois, vous devez activer la tâche.

        1. Pour la tâche Configurer la tâche planifiée pour la tâche d’importation complète , sélectionnez Configurer.
        2. Dans le formulaire Importation de données planifiée de 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 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 des 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 des données Delta est supérieure à 3 jours.
        1. Pour la tâche Configurer la tâche planifiée pour l’importation delta , sélectionnez Configurer.
        2. Dans le formulaire Importation de données planifiée de 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 la tâche d’importation delta comme terminée en sélectionnant 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 CMDB et de les renseigner avec précision.
    7. Gérez les alertes et les événements en envoyant des événements de l’application Cloud Observability à 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 Cloud Observability , 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 de webhook dans l’application Cloud Observability .
        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 de 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.ii pour 7.b.iv chaque projet pour lequel vous souhaitez créer un webhook.
        6. Définissez la création d’une tâche de webhook comme terminée 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é des 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 pour terminer en sélectionnant Marquer comme terminé dans la configuration guidée.