Configurer Connecteur du graphe de service pour OpenTelemetry

  • Rversion finale: Xanadu
  • Mis à jour 1 août 2024
  • 9 minutes de lecture

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

    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 Visibilité (ITOM) 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 des unités d’abonnement ServiceNow pour votre abonnement, pour les ressources informatiques gérées qui sont créées ou modifiées dans le CMDB , Connecteur du graphe de servicesmais qui ne sont pas encore gérées par Visibilité ITOM ou Détection ITOM, 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 Visibilité ITOM ou Détection ITOM pour vous assurer de la capacité disponible.

    Dépendances et besoins :
    • L’application Integration Commons for CMDB Store, qui est automatiquement installée.
    • L’application de stockage Modèles de classe CI CMDB, 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 Gestion des licences ITOM (com.snc.itom.license). Pour plus d’informations, consultez Demander la détection.
    • Le module d’extension Datastream Action (com.glide.hub.action_type.datastream), qui est automatiquement installé.
    • Observability Commons for CMDB (sn_observability), qui est uniquement requis pour l’ingestion d’événements. Pour que la gestion des événements 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 : administrateur

    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, reportez-vous à la section 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 Démarrer.
    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] dans la base de Now Support connaissances.
        Important :
        Notez les détails de vos projets, de votre organisation et de votre 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 à la configuration guidée et marquez la tâche Utiliser OpenTelemetry à terminer en sélectionnant Marquer comme terminé.
      3. Entrez les détails de votre Cloud Observability organisation à partir de l’emplacement où vous souhaitez récupérer les projets, les ressources et les informations de mappage de 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, 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é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. Définissez la tâche Configurer la clé API pour qu’elle soit terminée en sélectionnant Marquer comme terminé.
      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 présente des erreurs, suivez les suggestions pour y remédier.

        4. Définissez la tâche Tester la connexion pour qu’elle soit 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 des 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é.
    5. Facultatif : Configurez des configurations supplémentaires pour configurer la durée 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 la durée de vérification à partir du moment où vous souhaitez récupérer des ressources des projets.

        La durée de vérification est utilisée pour calculer les heures 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 l’heure actuelle moins 12 heures et jusqu’à l’heure de fin qui est l’heure actuelle.

        1. Pour la tâche Configurer le délai de rétrospection , sélectionnez Configurer.
        2. Dans le champ Valeur du formulaire Propriétés de connexion du graphe de services, entrez la durée de vérification en heures.
        3. Sélectionnez Mettre à jour.
        4. Définissez la tâche Configurer le temps de vérification sur Terminé 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 sur 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 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 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 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 pour le 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. Définissez l’option Configurer les propriétés système 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ées 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 des données. Cependant, 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 d’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. Définissez la tâche planifiée de configuration pour la tâche d’importation complète sur Terminer 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 de différentiel.

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

        Remarque :
        L’extraction de données de différentiel 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 d’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. Définissez la tâche Configurer la tâche planifiée pour la tâche d’importation de différentiel sur Terminer 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 et de les CMDB renseigner avec précision.
    7. Gérer 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 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 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 tâche Créer un webhook sur Terminé 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é pour les CI sans correspondance sur Terminer en sélectionnant Marquer comme terminé dans la configuration guidée.