Génération et simulation de l’exécution de la charge utile à l’aide de la simulation d’identification

La simulation d’identification est un emplacement central pour construire automatiquement une charge utile dont l’achèvement et la validité sont garantis. Vous pouvez ensuite simuler le traitement de la charge utile par le moteur IRE (Identification et rapprochement) et examiner les résultats avant de la soumettre pour exécution par IRE.

Utilisez la simulation d’identification pour construire une charge utile d’entrée et simuler le traitement de la charge utile par IRE. Vous pouvez ensuite examiner les résultats, ajuster les règles d’identification si nécessaire et relancer la simulation de la charge utile mise à jour.

Utilisez la simulation d’identification pour :

• Construire automatiquement la charge utile en entrée basée sur les règles d’identification, d’hébergement et d’imbrication existantes.
• Simulez l’exécution d’une charge utile (construite automatiquement par simulation d’identification ou créée manuellement).
• Parcourez la sortie de la charge utile et les messages du journal d’exécution pour une exécution simulée.

Remarque :

• La simulation d’identification n’engage aucune mise à jour dans la CMDB.
• La simulation d’identification prend en charge la simulation du traitement des charges utiles fournies qui contiennent des tables non CMDB, mais ne prend pas en charge la génération de telles charges utiles.

Générer automatiquement la charge utile à l’aide de la simulation d’identification

Utilisez la simulation d’identification pour construire automatiquement une charge utile d’entrée pour une classe spécifiée. La charge utile construite est complète avec tous les CI dépendants requis, correctement structurée et syntaxiquement valide pour le traitement par le moteur IRE (Identification et rapprochement).

Avant de commencer

Rôle requis : admin

Pourquoi et quand exécuter cette tâche

La charge utile construite lors de la simulation d’identification correspond à la classe spécifiée. Pour une classe CI dépendante, vous serez invité à fournir des informations sur toutes les dépendances. Une fois que vous avez fourni les détails requis, la simulation d’identification construit la charge utile en fonction de votre entrée.

Remarque :

La génération automatique de charges utiles contenant des tables non CMDB n’est pas prise en charge.

Procédure

1. Accédez à la Tout > Configuration > Identification/Rapprochement, puis cliquez sur Simulation d’identification.
2. Dans la zone Démarrer avec la classe CI , cliquez sur Démarrer.
3. Dans le formulaire Informations sur la charge utile , dans le champ Source de données , sélectionnez la source de données associée à cette mise à jour de classe.
   Pour la source de données Découverte ServiceNow, sélectionnez ServiceNow.
4. Sélectionnez la classe dans la charge utile.
   1. Dans la zone Attributs de critère , sélectionnez les attributs d’identificateur de CI, puis spécifiez les valeurs qui identifient un CI de façon unique.
   2. Dans la zone Attributs supplémentaires , spécifiez les attributs et les valeurs avec lesquels les CI correspondants seront mis à jour.
5. Pour les CI dépendants associés à des règles d’identification dépendantes, remplissez les sections Attributs de critères et Attributs supplémentaires dans toutes les sections Niveau de conteneur qui s’affichent.
6. Cliquez sur Générer le script.
7. Si des erreurs indiquent qu’il manque des champs, renseignez les champs manquants, puis cliquez à nouveau sur Générer le script .

Que faire ensuite

• Cliquez sur Exécuter la simulation pour simuler le traitement de la charge utile par IRE.
• Examinez les résultats de la simulation, affinez la charge utile selon vos besoins et combinez-la avec d’autres charges utiles pour d’autres classes si vous le souhaitez. Après avoir finalisé la charge utile, utilisez l’API createOrUpdateCI() pour exécuter la charge utile par IRE, ce qui entraînera des mises à jour réelles de la CMDB.
• Cliquez sur Copier le script pour copier le script JSON dans le presse-papiers. Vous pouvez ensuite coller ce script dans un logiciel tiers ou sur un autre écran de la simulation d’identification.

Simuler le traitement de la charge utile à l’aide de la simulation d’identification

Utilisez la simulation d’identification pour simuler le processus IRE (moteur Identification et rapprochement) de l’identification des CI pour une charge utile en entrée. Fournissez une charge utile valide, qui a été construite à l’aide de la simulation d’identification ou qui a été créée manuellement.

Avant de commencer

Rôle requis : admin

Procédure

1. Accédez à la Tout > Configuration > Identification/Rapprochement, puis cliquez sur Simulation d’identification.
2. Facultatif : Pour exécuter une simulation d’une charge utile existante :
   1. Cliquez sur Démarrer dans la tuile Démarrer avec la charge utile existante .
   2. Sur la page Insérer une charge utile JSON, sélectionnez la source de données associée à cette mise à jour de classe.
   3. Facultatif : Sélectionnez Utiliser l’identification améliorée pour appliquer l’API identifyCIEnenhanced pour l’identification améliorée des CI, au lieu d’utiliser l’API identifyCI.
   4. Collez la charge utile JSON dans le canevas vide.
3. Facultatif : Pour construire une nouvelle charge utile, cliquez sur Démarrer dans la tuile Démarrer avec une classe CI .
   Consultez Générer automatiquement la charge utile à l’aide de la simulation d’identification pour plus d'informations.
4. Cliquez sur Exécuter la simulation pour simuler le traitement de la charge utile par IRE.

Que faire ensuite

1. Examinez les résultats de la simulation dans le volet des résultats et affinez la charge utile si nécessaire :
   1. Cliquez sur Exécution #1 pour afficher l’ID de contexte et l’ID d’exécution de l’exécution simulée.
   2. Cliquez sur la flèche déroulante à côté de Run #1 pour afficher des détails supplémentaires.
      • Entrée : affiche la charge utile de la simulation.
      • Journaux : affiche tous les messages journalisés générés par IRE lors de la simulation du traitement de la charge utile, en fonction du niveau de journalisation spécifié.
      • Sortie : affiche la charge utile de sortie renvoyée par IRE.
2. Après avoir finalisé la charge utile, utilisez l’API createOrUpdateCI() pour exécuter la charge utile par IRE, ce qui entraînera des mises à jour réelles de la CMDB.

Définir le niveau de journalisation pour la simulation d’identification

La simulation d’identification consigne chaque étape d’un traitement de charge utile simulée. Vous pouvez ensuite examiner ces journaux d’exécution pour déterminer si une charge utile a été traitée comme prévu et si les règles d’identification sont efficaces. Vous pouvez ajuster le niveau de journalisation pour qu’il soit utile et que la quantité de messages ne soit pas excessive ou insuffisante.

Avant de commencer

Rôle requis : admin

Procédure

1. Accédez à la Tout > Configuration > Identification/Rapprochement, puis cliquez sur Simulation d’identification.
2. Cliquez sur l’icône Paramètres .
3. Sélectionnez le niveau de journalisation pour le moteur IRE (Identification et rapprochement) sous Niveau de journalisation IE et pour le cache de service sous Niveau de journalisation du cache de service.
   Les niveaux de journalisation sont affichés par ordre croissant, du niveau minimum au niveau maximum de journalisation.
4. Cliquez à nouveau sur l’icône Paramètres pour fermer la boîte de dialogue Paramètres .

Examiner les journaux d’exécution

La simulation d’identification fournit des journaux d’exécution générés par le moteur Identification et rapprochement (IRE). Vous pouvez accéder à ces journaux d’exécution pour l’exécution de charge utile, pour examiner les résultats et à des fins de débogage. Les journaux de sortie de la charge utile IRE s’affichent dans un format convivial sur une page centrale.

Avant de commencer

Rôle requis : admin

Pourquoi et quand exécuter cette tâche

En outre, les applications internes qui utilisent IRE (telles que Découverte) peuvent appeler une API interne pour fournir une URL permettant d’afficher les journaux d’exécution IRE.

La journalisation s’effectue dans le contexte d’une exécution spécifique du moteur d’identification, et vous pouvez filtrer la liste de journaux par une source de données et une plage horaire spécifiques. Jusqu’à 1 000 journaux d’exécution vieux de moins de 2 mois sont répertoriés, regroupés par ID de contexte et heures d’exécution. Vous pouvez utiliser la propriété glide.identification_logs.max_run_ids pour modifier la limite de 1 000.

Vous pouvez contrôler le niveau de journalisation à l’aide de la glide.discovery.identification.log_level propriété système Détection et en définissant la valeur sur l’une des valeurs suivantes :

• Info
• Avertir
• Erreur
• Déboguer
• DebugVerbose
• DebugObnoxious

Remarque :

IRE effectue une vérification initiale d’une charge utile avant de traiter les règles d’identification. Si IRE détecte des CI en double en fonction d’identificateurs de classe, la charge utile est rejetée et le traitement s’arrête.

Procédure

1. Accédez à la Tout > Configuration > Identification/Rapprochement > Journaux d'identification.
2. Filtrez la liste des exécutions comme suit :
   1. Source : sélectionnez la source de données pour laquelle afficher les journaux d’exécution.
   2. Plage horaire : spécifiez une plage horaire pour laquelle afficher les journaux d’exécution.
   La liste Exécutions affiche toutes les exécutions pour la source de données spécifiée, pendant la plage horaire spécifiée.
3. Dans la liste Exécutions , cliquez sur une exécution # pour afficher son ID de contexte et son ID d’exécution.
   Un ID de contexte unique est associé à chaque charge utile spécifique exécutée. Chaque exécution de cette charge utile est associée à un ID d’exécution unique. Un seul ID de contexte pour une charge utile exécutée plusieurs fois est associé à plusieurs ID d’exécution.
4. Cliquez sur la flèche déroulante d’une exécution # pour afficher des détails supplémentaires.
   • Entrée : affiche la charge utile de l’exécution.
   • Journaux : affiche tous les messages journalisés générés par le moteur d’identification lors de l’exécution de la charge utile, en fonction du niveau de journalisation spécifié.
   • Sortie : affiche la charge utile de sortie retournée par le moteur d’identification.