Configurer Connecteur du graphe de service pour OpenTelemetry

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

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

    Avant de commencer

    Pour l’utiliser Connecteur du graphe de services, vous avez besoin d’un abonnement à une unité d’abonnement basée sur l’application Gestion des opérations informatiques Visibility (ITOM) ou sur l’application ITOM Discovery. 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 créées ou modifiées dans le CMDB par ce, mais qui ne sont pas encore gérées par ITOMConnecteur du graphe de services Visibility ou ITOM Discovery, ces ressources augmenteront la consommation d’unités d’abonnement de cette application. Passez en revue votre consommation actuelle d’unités d’abonnement dans ITOM Visibility ou ITOM Discovery pour vous assurer de la capacité disponible.

    Dépendances et exigences :
    • L’application de stockage Integration Commons for CMDB, qui est automatiquement installée.
    • L’application de stockage CMDB CI Class Models qui est automatiquement installée. Consultez Application de stockage CMDB CI Class Models.
    • Le module d’extension ITOM Discovery License (com.snc.itom.discovery.license). Vous devez activer ce module d’extension.
    • Module d’extension ITOM Licensing (com.snc.itom.license). Pour plus d’informations, consultez Request Discovery.
    • Le module d’extension Datastream Action (com.glide.hub.action_type.datastream), qui est automatiquement installé.
    • Observability Commons for CMDB (sn_observability), qui n’est requis que pour l’ingestion d’événements. Pour que Event Management fonctionne, Observability Commons pour CMDB l’application doit être installé avant d’installer le connecteur. Pour plus d’informations, consultez Observability Commons pour CMDB sur le 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, consultez 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 Premiers pas.
    4. Configurez les propriétés de l’application pour configurer votre organisation et les informations d’identification d’authentification pour l’envoi de demandes aux ServiceNow Cloud Observability API.
      1. Dans la section Configurer la connexion de la page Connecteur du graphe de services pour OpenTelemetry , sélectionnez Premiers pas.
      2. Pour la tâche Utiliser OpenTelemetry , assurez-vous que l’application Cloud Observability répond aux conditions, comme indiqué dans l’article sur la configuration de ServiceNow Cloud Observability [KB1527588] dans la Now Support base de connaissances.
        Important :
        Notez les détails de vos projets, de votre organisation et de la clé API de l’application Cloud Observability à utiliser ultérieurement lors de l’installation du connecteur.
        Une fois que vous avez configuré l’environnement OpenTelemetry dans l’application Cloud Observability , revenez à Guided Setup et marquez la tâche l’utilisation d’OpenTelemetry à terminer en sélectionnant Marquer comme terminé.
      3. Saisissez les détails de votre Cloud Observability organisation à partir de laquelle vous souhaitez récupérer les projets, les ressources et les informations de mappage de dépendance.
        1. Pour la tâche Configurer votre organisation , sélectionnez Configurer.
        2. Dans le champ Valeur du formulaire Propriétés de connexion à Service Graph, entrez le nom de votre Cloud Observability organisation.
        3. Sélectionnez Mettre à jour.
        4. Marquez la tâche Configurer votre organisation à accomplir en sélectionnant Marquer comme terminée.
      4. Saisissez 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 comme terminée en sélectionnant Marquer comme terminée.
      5. Testez la connexion de l’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 comporte 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 inclus 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 sur Terminé en sélectionnant Marquer comme terminée.
    5. Facultatif : Configurez des configurations supplémentaires pour configurer le délai de surveillance, 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 référence à partir duquel vous souhaitez récupérer les ressources des projets.

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

        1. Pour la tâche Configurer le temps de surveillance , sélectionnez Configurer.
        2. Dans le champ Valeur du formulaire Propriétés de connexion de Service Graph, entrez le temps de la rétrospective en heures.
        3. Sélectionnez Mettre à jour.
        4. Définissez la tâche Configurer le temps de surveillance sur Terminée en sélectionnant Marquer comme terminée.
      3. Sélectionnez les projets à partir desquels vous ne souhaitez pas récupérer les 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 A 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ée.
      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 le diagnostic 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 le diagnostic 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 de diagnostic pour résoudre les erreurs.

        5. Répétez les étapes 5.d.ii pour 5.d.iv chaque projet pour lequel vous souhaitez exécuter des diagnostics.
        6. Définissez la tâche Exécuter le diagnostic de projet comme terminée en sélectionnant Marquer comme terminée.
      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 pour le 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 l’état Configurer les propriétés système pour que la tâche de connecteur soit terminée en sélectionnant Marquer comme terminé.
    6. Configurez les tâches planifiées pour importer des données à 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. Pour la tâche Configurer la tâche planifiée , sélectionnez Configurer.
      3. Sélectionnez la tâche planifiée que vous souhaitez activer.
      4. Vérifiez les valeurs de champ pour la tâche planifiée dans le formulaire Importation de données planifiée.
        Pour plus d'informations, consultez Schedule a data import.
      5. Sélectionnez Exécuter maintenant.
      6. Répétez les étapes 6.c pour chaque tâche planifiée pour l’importation 6.e de données.
      7. Sélectionnez l’icône de retour (<) pour revenir à la page de configuration guidée.
      8. Définissez la tâche Configurer la tâche planifiée comme terminée en sélectionnant Marquer comme terminée dans la configuration guidée.
    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 webhook dans l’application Cloud Observability .
        4. Une fois qu’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 de webhook dans votre ServiceNow instance.
          • Le nom d’utilisateur de l’enregistrement utilisateur commence par ls_api_<project_name> et le rôle evt_mgmt_integration est attribué à 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 tâche Créer un webhook comme terminée en sélectionnant Marquer comme terminé dans la configuration guidée.
      3. Configurez la propriété système pour ingérer les événements qui n’ont pas de CI correspondants 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é pour les CI sans correspondance comme terminée en sélectionnant Marquer comme terminé dans la configuration guidée.