Configurer Connecteur du graphe de services pour Microsoft Azure à l’aide de la configuration guidée

Configurez des sources de données et des tâches d’importation planifiée pour extraire les données de Azure votre CMDB.

Avant de commencer

Important :

À moins de problèmes, utilisez la vue, car la méthode de configuration guidée va être déconseillée SGC Central . Si une connexion est configurée à l’aide de la configuration guidée, la connexion peut ne pas apparaître dans la SGC Central vue.

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 Découverte Core (com.snc.discovery.core), qui est automatiquement installé par Découverte.
• Le module d’extension Datastream Action (com.glide.hub.action_type.datastream), qui est automatiquement installé.
• 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.

Important :

Après l’importation initiale des Azure données, l’application effectue une importation delta des données. Toutefois, vous pouvez effectuer une extraction complète des données à tout moment ultérieurement en désactivant la synchronisation delta et en définissant la sn_sg_azure_integ.is_delta_sync_enabled propriété sur false. Pour plus d'informations, consultez Configuration de la synchronisation des données dans Connecteur du graphe de services pour Microsoft Azure.

Rôle requis : admin

Pourquoi et quand exécuter cette tâche

Le connecteur utilise les API Azure Management pour l’extraction complète des données à partir de Azure. Toutefois, pour extraire les changements delta de Azure, les API Azure Resource Graph sont utilisées. Le système de noms de domaine (DNS) est Microsoft Azure Management, mais le chemin d’accès est un graphe de ressources.

Pour en savoir plus sur les Azure instructions de configuration, consultez l’article Connecteur du graphe de services pour Azure : vue d’ensemble sur le ServiceNow Community site.

Procédure

1. Accédez à la Tout > Connecteurs du graphe de services > Azure > Configuration.
2. Sur la page Mise en route, sélectionnez Mise en route.
3. Créez des sources de données et des importations planifiées pour la nouvelle connexion.
   1. Sur la page Connecteur du graphe de services pour Microsoft Azure , dans Mettre à jour l’accès aux sources de données et aux importations planifiées, sélectionnez la tâche Mettre à jour l’accès à Importation de données planifiée.
   2. Dans la section Mettre à jour l’accès à Importation de données planifiée, sélectionnez Configurer et effectuez les actions suivantes :
      1. Pour la tâche d’accès à Mettre à jour Importation de données planifiée, sélectionnez Configurer.
      2. Sélectionnez le périmètre de l’application global à l’aide du sélecteur d’application.
      3. Dans la liste connexe Accès à l’application, cochez les cases Peut créer, Peut mettre à jour et Peut supprimer , si ce n’est pas déjà fait.
      4. Sélectionnez Mettre à jour pour fermer l’onglet et revenir à la configuration guidée.
      5. Modifiez à nouveau le périmètre de l’application en Connecteur du graphe de services pour Microsoft Azure à l’aide du sélecteur d’application.
      6. Définissez la tâche Mettre à jour l’accès à Importation de données planifiée comme terminée en sélectionnant Marquer comme terminé.
      7. Répétez les étapes 3.b.ii3.b.v pour la tâche Mettre à jour l’accès à la source de données avec la table Source de données [sys_data_source] et définissez la tâche comme terminée en sélectionnant Marquer comme terminé.
   3. Effacez le cache pour la nouvelle connexion.
      1. Dans la section Effacer le cache pour la source de données et le jeu d’importation, sélectionnez Configurer.
      2. Basculez vers Global dans le menu Portée.
      3. Entrez le script suivant.

         GlideTableManager.invalidateTable("sys_data_source");
               GlideCacheManager.flushTable("sys_data_source");
         
               GlideTableManager.invalidateTable("scheduled_import_set");
               GlideCacheManager.flushTable("scheduled_import_set");
         
               GlideTableManager.invalidateTable("sys_db_object");
               GlideCacheManager.flushTable("sys_db_object");

      4. Sélectionnez Exécuter le script.
      5. Dans le menu Champ d’application, sélectionnez Connecteur du graphe de services pour Microsoft Azure.
      6. Cliquez sur Marquer comme terminé.
4. Créez une connexion pour importer des éléments de configuration (CI) matériels à partir de l’application Azure cliente.
   Remarque :

   Assurez-vous de disposer de l’autorisation User.Read sur le Graph API de Microsoft pour l’importation de matériel. Assurez-vous également que la politique IAM de l’abonnement Azure dispose du rôle de lecteur. Consultez Affecter un utilisateur en tant qu’administrateur d’un abonnement Azure avec des conditions sur le site de documentation Microsoft Azure .
   1. Obtenez les informations d’identification OAuth auprès de votre Azure administrateur.
      Notez les détails suivants :

      • ID (client) de l'application
      • Secret client
      • ID (locataire) du répertoire
      • URL de connexion

      Remarque :

      Après avoir obtenu les informations d’identification OAuth, dans la configuration guidée pour Connecteur du graphe de services pour Microsoft Azure, accédez à la section Créer une connexion pour l’importation de matériel de la page Connecteur du graphe de services pour Microsoft Azure et définissez la tâche Obtenir les informations d’identification OAuth comme terminée en cliquant sur Marquer comme terminé.
   2. Configurez votre connexion matérielle et vos informations d’identification Azure.
      1. Dans la section Créer une connexion pour l’importation de matériel de la page Connecteur du graphe de services pour Microsoft Azure, sélectionnez Continuer.
      2. Pour la tâche Créer ou modifier une connexion, sélectionnez Configurer.
      3. Sur la page Connexions du Studio de workflow, sélectionnez Configurer pour la connexion matérielle SG-Azure disponible par défaut pour l’importation de matériel.

         Vous pouvez créer plusieurs connexions en cliquant sur Ajouter une connexion.

      4. Sur le formulaire, examinez et modifiez les champs.

         Tableau 1. Formulaire Configurer la connexion

         Champ	Description
         Information de connexion
         Nom de la connexion	Nom permettant d’identifier de manière unique l’enregistrement de connexion matérielle. Par exemple, Connexion matérielle SG-Azure.
         URL de connexion	URL de base à connecter à votre Azure application cliente. Remarque : Ce champ est automatiquement défini sur l’URL pour se connecter à l’application. Laissez la valeur du champ telle quelle.
         Informations d'identification
         ID client OAuth	ID (client) de votre Azure application cliente comme décrit à l’étape 4.a.
         Secret client OAuth	Secret client de votre Azure application cliente comme décrit à l’étape 4.a.
         URL du jeton OAuth	URL de jeton de votre Azure application cliente. En fonction de la région de votre Azure application cliente, entrez l’URL du jeton dans l’un des formats suivants : Global https://login.microsoftonline.com/<tenantid>/oauth2/v2.0/token Gouvernement des États-Unis https://login.microsoftonline.us/<tenantid>/oauth2/v2.0/token Chine https://login.partner.microsoftonline.cn/<tenantid>/oauth2/v2.0/token Allemagne https://login.microsoftonline.de/<tenantid>/oauth2/v2.0/token Où <tenantid> est l’ID de locataire de votre Azure application cliente, comme décrit à l’étape 4.a.

      5. Sélectionnez Configurer et obtenir le jeton OAuth.
      6. Une fois le flux de jetons OAuth terminé, revenez à la page Créer une connexion pour la tâche d’importation de matériel à l’aide du bouton de retour de votre navigateur.
      7. Définissez la tâche Créer ou modifier une connexion comme terminée en cliquant sur Marquer comme terminé.
   3. Testez la connexion Microsoft Graph API pour importer des données matérielles à partir de l’application Azure cliente.
      1. Pour la tâche Test de la connexion, sélectionnez Configurer.
      2. Sélectionnez la source de données associée à la connexion nouvellement créée dans la colonne Nom de la liste Sources de données.
      3. Cliquez sur le lien connexe Tester le chargement de 20 enregistrements .
      4. Lorsque l’état devient Terminé, revenez à la configuration en cliquant sur Retour à la configuration guidée dans le panneau d’aide.
      5. Définissez la tâche Test de la connexion comme terminée en cliquant sur Marquer comme terminé.
   4. Vérifiez la configuration des importations de données planifiées.
      1. Pour la tâche Configurer des tâches d’importation planifiée, sélectionnez Configurer.
      2. Sélectionnez la SG-Azure Subscriptions tâche planifiée.
      3. Dans le formulaire Importation de données 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.

      4. Cliquez sur Mettre à jour.
      5. Configurez la tâche Configurer des tâches d’importation planifiée à terminer en cliquant sur Marquer comme terminé dans le panneau d’aide.
5. Créez une connexion pour importer des informations logicielles à partir de l’application Azure cliente.
   Remarque :

   Assurez-vous de disposer de l’autorisation Data.Read sur l’API Log Analytics pour l’importation de logiciel.
   1. Obtenez les informations d’identification OAuth et configurez l’espace de travail Analyse de journaux dans le Azure.
      1. Assurez-vous de disposer des informations d’identification OAuth de l’étape 4.a.
      2. Configurez l’espace de travail Analyse de journaux dans l’application Azure cliente.
         • Utilisez un espace de travail existant, si disponible.
         • Créez un autre espace de travail.

           Pour plus d’informations, voir Créer un espace de travail d’analyse de journaux dans la Azure documentation.

         Remarque :

         Notez l’ID de l’espace de travail.
      3. Déployez Azure Monitoring Agent (AMA), puis activez le suivi des changements et l’inventaire à l’aide d’AMA.

         Pour plus d’informations, consultez Activer le suivi des changements et l’inventaire à l’aide d’Azure Monitoring Agent dans la Azure documentation.

      4. Déployez Agent de dépendance dans le cadre d’Analyse des coûts de VM pour collecter les données détectées sur les processus de VM et leurs connexions.

         Pour plus d’informations, consultez Activer la vue d’ensemble d’Aperçus VM dans la Azure documentation.

      Remarque :

      Après avoir obtenu les informations d’identification OAuth, dans la configuration guidée pour Connecteur du graphe de services pour Microsoft Azure, accédez à la section Créer une connexion pour l’importation de logiciel de la page Connecteur du graphe de services pour Microsoft Azure et définissez la tâche Obtenir les informations d’identification OAuth pour terminer en cliquant sur Marquer comme terminé.
   2. Configurez votre connexion logicielle Azure et vos informations d’identification.
      1. Dans la section Créer une connexion pour l’importation de logiciel de la page Connecteur du graphe de services pour Microsoft Azure, sélectionnez Continuer.
      2. Pour la tâche Créer ou modifier une connexion, sélectionnez Configurer.
      3. Sur la page Connexions du Studio de workflow, sélectionnez Configurer pour la connexion d’analyse de journaux SG-Azure disponible par défaut pour l’importation de logiciel.

         Vous pouvez créer plusieurs connexions en cliquant sur Ajouter une connexion.

      4. Sur le formulaire, examinez et modifiez les champs.

         Tableau 2. Formulaire Configurer la connexion

         Champ	Description
         Information de connexion
         Nom de la connexion logicielle	Nom permettant d’identifier de façon unique l’enregistrement de connexion logicielle. Par exemple, connexion à l’analyse de journaux Service Graph Azure.
         Nom de la connexion matérielle	Nom de la connexion matérielle associée au logiciel, tel que décrit à l’étape 4.b.iv. Vous ajoutez un nom de connexion matérielle pour associer la connexion logicielle au matériel respectif.
         URL de connexion	URL de base pour se connecter à l’espace de travail d’analyse de journaux au format suivant : https://api.loganalytics.io/v1/workspaces/<workspace_id> Où <workspace_id> est l’ID de l’espace de travail d’analyse de journaux tel que décrit à l’étape 5.a.ii. Remarque : Ce champ est automatiquement défini sur l’URL pour se connecter à l’espace de travail d’analyse de journaux. Remplacez la variable <workspace_id> de l’URL générée automatiquement par l’ID de l’espace de travail de votre espace de travail d’analyse de journaux.
         Informations d'identification
         ID client OAuth	ID (client) de votre Azure application cliente comme décrit à l’étape 4.a.
         Secret client OAuth	Secret client de votre Azure application cliente comme décrit à l’étape 4.a.
         URL du jeton OAuth	URL de jeton de votre Azure application cliente. En fonction de la région de votre Azure application cliente, entrez l’URL du jeton dans l’un des formats suivants : Global https://login.microsoftonline.com/<tenantid>/oauth2/v2.0/token Gouvernement des États-Unis https://login.microsoftonline.us/<tenantid>/oauth2/v2.0/token Chine https://login.partner.microsoftonline.cn/<tenantid>/oauth2/v2.0/token Allemagne https://login.microsoftonline.de/<tenantid>/oauth2/v2.0/token Où <tenantid> est l’ID de locataire de votre Azure application cliente, comme décrit à l’étape 4.a.

      5. Sélectionnez Configurer et obtenir le jeton OAuth.
      6. Lorsque le flux de jetons OAuth est terminé, revenez à la page Créer une connexion pour la tâche d’importation de logiciel à l’aide du bouton Retour de votre navigateur.
      7. Définissez la tâche Créer ou modifier une connexion comme terminée en cliquant sur Marquer comme terminé.
   3. Testez la connexion de l’API Log Analytics pour importer des données logicielles à partir de l’application Azure cliente.
      1. Pour la tâche Test de la connexion, sélectionnez Configurer.
      2. Sélectionnez la source de données associée à la connexion nouvellement créée dans la colonne Nom de la liste Sources de données.
      3. Cliquez sur le lien connexe Tester le chargement de 20 enregistrements .
      4. Lorsque l’état devient Terminé, revenez à la configuration en cliquant sur Retour à la configuration guidée dans le panneau d’aide.
      5. Définissez la tâche Test de la connexion comme terminée en cliquant sur Marquer comme terminé.
   4. Vérifiez la configuration des importations de données planifiées.
      1. Pour la tâche Configurer des tâches d’importation planifiée, sélectionnez Configurer.
      2. Sélectionnez l’importation de SG-Azure Software données planifiée.
      3. Dans le formulaire Importation de données 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.

      4. Cliquez sur Mettre à jour.
      5. Configurez la tâche Configurer des tâches d’importation planifiée à terminer en cliquant sur Marquer comme terminé dans le panneau d’aide.

Résultats

Les données de Azure sont extraites vers votre CMDBfichier .