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

La simulation d’identification est un emplacement central pour la construction automatique d’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 d’identification et de réconciliation (IRE) et examiner les résultats avant de la soumettre à l’exécution par IRE.

Utilisez la simulation d’identification pour construire une charge utile d’entrée et simulez 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 :

• Construisez automatiquement une charge utile d’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 les messages de journal de sortie et d’exécution de la charge utile pour une exécution simulée.

Remarque :

• La simulation d’identification ne valide aucune mise à jour de la CMDB.
• La simulation d’identification prend en charge la simulation des charges utiles de traitement fournies et 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 Identification et réconciliation (IRE).

Avant de commencer

Rôle requis : administrateur

Pourquoi et quand exécuter cette tâche

La charge utile construite au cours de la simulation d’identification est destinée à 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 une 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 ServiceNow Discovery, sélectionnez ServiceNow.
4. Sélectionnez la classe dans la charge utile.
   1. Dans la zone Attributs de critères , 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, renseignez les sections Attributs de critères et Attributs supplémentaires dans toutes les sections de niveau de conteneur qui s’affichent.
6. Cliquez sur Générer le script.
7. Si des erreurs indiquent qu’il manque des champs, remplissez-les, 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, ajustez 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 se traduira par 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 d’une simulation d’identification

Utilisez la simulation d’identification pour simuler le processus IRE (moteur Identification et rapprochement) d’identification de CI pour une charge utile d’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 : administrateur

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 vignette Démarrer avec une 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 identifyCIEnhanced pour une 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 vignette 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 selon vos besoins :
   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 Exécution #1 pour afficher des détails supplémentaires.
      • Entrée : affiche la charge utile de la simulation.
      • Journaux : affiche tous les messages consigné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 se traduira par 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 du traitement d’une 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 afin qu’il soit utile et que la quantité de messages ne soit pas excessive ou insuffisante.

Avant de commencer

Rôle requis : administrateur

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 Identification et réconciliation (IRE) sous Niveau de journal IE et pour le cache de service sous Niveau de journal du cache de service.
   Les niveaux de journalisation sont affichés par ordre croissant, du niveau minimum au niveau de journalisation maximum.
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 qui sont générés par le moteur IRE (Identification and Reconciliation Engine). Vous pouvez accéder à ces journaux d’exécution pour les exécutions 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 : administrateur

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 des journaux par une source de données et une plage horaire spécifiques. Jusqu’à 1 000 journaux d’exécution datant de moins de 2 mois sont répertoriés, regroupés par ID de contexte et temps 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 Discovery 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 sur la base 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 de temps spécifiée.
3. Dans la liste Exécutions , cliquez sur un # d’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 ID de contexte unique pour une charge utile exécutée plusieurs fois est associé à plusieurs ID d’exécution.
4. Cliquez sur la flèche du menu déroulant en regard d’un # d’exécution pour afficher des détails supplémentaires.
   • Entrée : affiche la charge utile de l’exécution.
   • Journaux : affiche tous les messages consigné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 renvoyée par le moteur d’identification.

Messages d’erreur IRE

Le moteur Identification et rapprochement (IRE) génère les messages et erreurs suivants : Selon les paramètres, ces messages s’affichent dans le volet Journalisation d’identification et dans les journaux système.

Pour plus d’informations sur l’identification de CI basée sur la recherche et les chaînes de qualificateurs, reportez-vous à la section Créer une règle d’identification de CI.

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 sur la base d’identificateurs de classe, la charge utile est rejetée et le traitement s’arrête.

Pour plus d’informations sur l’erreur de charge utile d’identification CMDB : « ÉCHEC DE LA TENTATIVE D’EXÉCUTION DE LA CONNEXION », voir Erreur de charge utile d’identification CMDB : « Échec de l’insertion avec erreur Erreur lors de l’insertion de cmdb_ci... », où les journaux de nœud affichent « ÉCHEC DE LA TENTATIVE D’EXÉCUTION DE LA CONNEXION » « Entrée en double 'XXX' pour la clé 'XXX' » article de la base de connaissances.

Erreur : IDENTIFICATION_RULE_MISSING

Message	Description et résolution
Règle d’identité manquante pour la table [xyz]	Description : La règle d’identification est manquante pour une classe. Résolution : Assurez-vous qu’il existe une règle d’identification pour la table [xyz] et que cette règle est active.

MISSING_MATCHING_ATTRIBUTES

Message

Description et résolution

Dans la charge utile, ensemble minimal de valeurs d’entrée manquant pour les attributs de critère (correspondance) de la règle d’identification pour la table [xyz]. Ajouter ces valeurs d’entrée dans l’élément de charge utile « abc »

Description : Ensemble minimal de valeurs manquant pour les attributs de critère d’une règle d’identification. Résolution : Dans la charge utile, ajoutez un ensemble minimal de valeurs pour les attributs de critères de l’identificateur de CI pour la table [xyz]. Ouvrez le Gestionnaire de classe CI, cliquez sur Hiérarchie et sélectionnez la [classe xyz . Vérifiez la règle d’identification et les entrées d’identificateur pour la table [xyz.

Erreur : NO_CLASS_NAME_FOR_INDEPENDENT_CI

Message	Description et résolution
Impossible d’avoir « sys_class_name » comme champ clé dans une règle d’identité indépendante sur « xyz »	Description : L'attribut de classe a été ajouté à l'identificateur de CI qui n'est pas pris en charge. Résolution : Supprimer l’attribut de classe de l’identificateur de CI pour la table [xyz].

Erreur : IDENTIFICATION_RULE_FOR_LOOKUP_MISSING

Message	Description et résolution
Règle d’identité pour la table [xyz] Règle de recherche manquante pour la classe [abc]	Description : La charge utile a un nom de classe de recherche, mais la règle de recherche correspondante est manquante. Résolution : Ajouter une entrée d’identificateur de recherche avec [Rechercher sur la table] comme [abc] pour l’identificateur CI pour la table [xyz].

Erreur : IDENTIFICATION_RULE_FOR_RELATED_ITEM_MISSING

Message	Description et résolution
Règle d’identité manquante pour la table [xyz] Règle connexe pour la classe [abc]	Description : La charge utile a un nom de classe connexe, mais la règle connexe correspondante est manquante. Résolution : Ajouter une entrée associée avec [Table connexe] en tant que [abc] dans l’identificateur CI pour la table [xyz].

Erreur : NO_LOOKUP_RULES_FOR_DEPENDENT_CI

Message	Description et résolution
Impossible d’avoir une règle de recherche pour une règle d’identité dépendante sur « xyz »	Description : Impossible d’avoir une règle de recherche pour une règle d’identité dépendante. Résolution : Supprimer l’entrée d’identificateur de recherche de l’identificateur de CI dépendant pour la table [xyz].

Erreur : INVALID_INPUT_DATA

Message	Description et résolution
Une sys_id non valide a été trouvée dans la charge utile. Aucun enregistrement avec sys_id [xyz] n’existe dans la table [abc] ou est un enregistrement en double avec le champ [duplicate_of] défini sur un CI principal	Description : La charge utile fait référence à un sys_id non valide. Résolution : Supprimez le sys_id référencé ou fournissez un sys_id valide.
Dans la charge utile, aucune source de données n’existe. Vous devez fournir une valeur de choix à partir du champ de choix [discovery_source] dans la table [cmdb_ci]	Description : Aucune source de données n’existe dans la charge utile. Résolution : Dans la charge utile, fournissez une valeur de choix valide à partir du champ de choix [discovery_source] à partir de la table [cmdb_ci].
Dans la charge utile, il existe une source de données non valide [xyz]. Vous devez fournir une valeur de choix valide à partir du champ [discovery_source] dans la table [cmdb_ci]	Description : La charge utile contient une source de données non valide. Résolution : Dans la charge utile, fournissez une valeur de choix valide à partir du champ de choix [discovery_source] à partir de la table [cmdb_ci].
Aucune relation de ce type avec le nom [xyz] n’existe dans la table [cmdb_rel_type]. Si la relation prête à l’emploi pour [xyz] a été supprimée ou renommée, elle doit être restaurée	Description : La charge utile référence une relation qui n'existe pas dans la table [cmdb_rel_type]. Résolution : Vérifiez que la référence à la relation est exacte. Ou, s’il s’agit d’une nouvelle relation, ajoutez-la à la table [cmdb_rel_type]. Ou, si la relation prête à l’emploi pour [xyz] a été supprimée ou renommée, restaurez-la.
Les relations de charge utile « xyz » ont un index d’enregistrement parent non valide : [0]	Description : La charge utile fait référence à des index parents non valides. Résolution : Vérifiez les index de charge utile et assurez-vous qu’ils sont tous valides.
Les relations de charge utile « xyz » ont un index d’enregistrement enfant non valide : [0]	Description : La charge utile fait référence aux index enfants non valides. Résolution : Vérifiez les index de charge utile et assurez-vous qu’ils sont tous valides.

Erreur : DUPLICATE_RELATIONSHIP_TYPES

Message	Description et résolution
Il existe des enregistrements de type relation en double avec le nom [xyz] dans la table [cmdb_rel_type] ayant sys_ids : [abc]	Description : Il existe des enregistrements en double dans la table [rel_ci_type] pour la relation. Résolution : Supprimez les enregistrements en double.

Erreur : DUPLICATE_PAYLOAD_RECORDS

Message	Description et résolution
Éléments en double trouvés dans la charge utile (index 0 et 1), à l’aide de className [xyz] et des champs [abc]. Supprimer les éléments en double de la charge utile	Description : La charge utile contient deux éléments dont les attributs de critère ont des valeurs identiques. Résolution : Supprimez l’un des éléments en double.

Erreur : LOCK_TIMEOUT

Message	Description et résolution
Impossible d’acquérir le verrou de synchronisation pour xyz	Description : Impossible d'acquérir le verrou de mutex système. Résolution : Augmentez le délai d’expiration du mutex en ajoutant la propriété système glide.identification_engine.mutex_expiration_time et définissez une valeur entière supérieure à la valeur par défaut (15 min).

Erreur : MULTIPLE_DUPLICATE_RECORDS

Message	Description et résolution
Enregistrements en double trouvés dans la table [xyz] à l’aide des champs [abc]	Description : Trouvez des enregistrements en double dans la table spécifiée. Résolution : Corrigez les enregistrements en double trouvés par le moteur d’identification. Consultez les tâches de déduplication pour obtenir des informations sur tous les doublons.

Erreur : REQUIRED_ATTRIBUTE_EMPTY

Message	Description et résolution
Champ obligatoire [xyz] manquant dans la table [abc]. Ajouter une valeur d’entrée pour le champ obligatoire dans la charge utile	Description : Un attribut obligatoire est manquant dans la charge utile. Résolution : Dans la charge utile, ajoutez une valeur d’entrée pour le champ obligatoire [xyz] dans la table [abc].

Erreur : MISSING_DEPENDENCY

Message	Description et résolution
Dans la charge utile, aucune relation n’est définie pour la classe dépendante [xyz] correspondant aux règles de confinement/d’hébergement : [abc]. Ajouter les relations appropriées dans la charge utile pour « définition »	Description : Aucune relation définie pour la classe dépendante correspondant à l’une de ses règles de métadonnées. Résolution : Dans la charge utile, ajoutez les relations appropriées pour la classe dépendante [xyz] qui correspond aux règles de confinement/d’hébergement : [abc].

Erreur : METADATA_RULE_MISSING

Message	Description et résolution
Aucune règle d’imbrication ni d’hébergement définie pour la classe dépendante [xyz]. Ajouter des règles d’imbrication/d’hébergement pour « abc »	Description : Aucune règle d’imbrication ni d’hébergement n’a été définie pour la classe dépendante. Résolution : Ajouter des règles d’imbrication ou d’hébergement pour la classe dépendante [xyz].

Erreur : MULTIPLE_DEPENDENCIES

Message	Description et résolution
Plusieurs éléments de relation dépendants [xyz] et [abc] trouvés dans la charge utile	Description : Il existe plusieurs éléments dépendants de la relation. Résolution : Supprimez l’un des multiples éléments de relation dépendants [xyz] ou [abc].
Plusieurs chemins d’accès à la même destination : xyz -> abc	Description : Plusieurs chemins d’accès à la même destination. Résolution : Supprimer les chaînes de relation/qualificateur en double qui peuvent exister entre xyz et > abc.

Erreur : ABANDONNÉ

Message	Description et résolution
Abandon du traitement de l’élément de charge utile « xyz », car il dépend de l’élément de charge utile « abc » comporte des erreurs	Description : L’élément de charge utile dépendant comporte des erreurs, le traitement est donc abandonné. Résolution : Résolvez l’erreur sur l’élément de charge utile dépendant « abc ».
Impossible de trouver l’enregistrement correspondant avec sys_id [xyz] dans la table [abc]	Description : Le sys_id correspondant n’existe pas dans la table correspondante. Résolution : Vérifier dans la table [abc] si l’enregistrement correspondant est un enregistrement valide en fonction de la charge utile entrée.
L’API du moteur d’identification a été appelée de manière récursive, abandonnant...	Description : L’API du moteur d’identification a été appelée de façon récursive. Résolution : Évitez d’appeler l’API du moteur d’identification de manière récursive.
Erreur détectée lors du traitement de la charge utile à partir de xyz	Description : Une erreur s’est produite lors du traitement de la charge utile. Résolution : Résolvez toutes les erreurs mentionnées dans la charge utile de sortie à partir de xyz.
Lors du traitement des relations, des erreurs ont été rencontrées dans l’élément de charge utile : xyz	Description : L’élément de charge utile comporte des erreurs. Résolution : Résolvez les erreurs dans l’élément de charge utile « xyz ».
Une erreur s’est produite lors de l’analyse de la charge utile JSON d’entrée : xyz	Description : Une erreur s’est produite lors de l’analyse de la charge utile JSON. Résolution : Assurez-vous que la charge utile JSON d’entrée a le format JSON correct.

Erreur : MULTI_MATCH

Message	Description et résolution
Enregistrements dépendants en double trouvés ayant une relation [xyz] avec le même CI (className :[abc], sysId :[def])	Description : CI dépendants en double trouvés. Résolution : Vérifiez les tâches de déduplication pour obtenir des informations sur tous les doublons, puis supprimez les enregistrements en double.
Plusieurs relations entre les éléments de charge utile : « xyz » et « abc » ont été trouvées.	Description : Plusieurs relations entre les éléments de la charge utile ont été trouvées. Résolution : Recherchez les chaînes de relations et les chaînes de qualificateurs en double qui pourraient exister.
Enregistrements en double trouvés dans la table de recherche [xyz] à l’aide des champs [abc] et du champ de référence [def]	Description : Trouvez des enregistrements en double dans la table de recherche. Résolution : Vérifiez les tâches de déduplication pour obtenir des informations sur tous les doublons, puis supprimez les enregistrements en double.

Erreur : QUALIFICATION_LOOP

Message	Description et résolution
La chaîne de qualification a une boucle qui contient la relation « xyz »	Description : La chaîne de qualification a une boucle. Résolution : Supprimer la boucle de la chaîne de qualification avec la relation 'xyz'.

Erreur : TYPE_CONFLICT_IN_QUALIFICATION

Message	Description et résolution
Charge utile non valide, la chaîne de qualification comporte plusieurs chemins possibles pour les éléments de charge utile : « xyz » et « abc »	Description : Plusieurs parcours de qualification trouvés. Résolution : Supprimez plusieurs chemins de qualification possibles entre les éléments « xyz » et « abc ».

Erreur : RECLASSIFICATION_NOT_ALLOWED

Message	Description et résolution
Reclassification de CI non autorisée à partir de la classe : [xyz] à [abc]	Description : Reclassification de CI non autorisée. Résolution : Consultez les tâches de reclassification pour plus d’informations sur la reclassification et vérifiez si la reclassification à partir de la classe : [xyz] vers [abc] est valide.

Erreur : DUPLICATE_RELATED_PAYLOAD

Message	Description et résolution
Éléments associés en double trouvés (0 et 1) dans l’index de charge utile 1 à l’aide des champs xyz	Description : Éléments associés en double présents. Résolution : Supprimez l’un des éléments associés en double présents dans la charge utile.

Erreur : DUPLICATE_LOOKUP_PAYLOAD

Message	Description et résolution
Rechercher des éléments en double (0 et 1) trouvés dans l’indice de charge utile 1 à l’aide des champs xyz	Description : Éléments de recherche en double présents. Résolution : Supprimez l’un des éléments de recherche en double présents dans la charge utile.

INSERT_NOT_ALLOWED_FOR_SOURCE

Message	Description et résolution
L’insertion dans [xyz] est bloquée pour la source de données [abc] par la règle de source de données IRE	Description : Une règle de source de données IRE est configurée pour empêcher la source de données [abc] d’insérer des CI de la classe [xyz]. Résolution : Supprimez ou mettez à jour la règle de source de données IRE appropriée pour permettre à la source de données [abc] d’insérer des CI de la classe [xyz]. Vous pouvez également attendre qu’une autre source de données autorisée crée le même CI.