Niveau de génération de rapports

Le niveau de génération de rapports détermine les détails d’exécution qu’un flux, un flux secondaire ou une action génère pendant les opérations normales. Par défaut, Studio de workflow ne génère pas de détails d’exécution pendant les opérations normales. Studio de workflow Génère les détails d’exécution du flux complet lorsque vous testez un flux, un flux secondaire ou une action individuel. Lorsque votre instance génère et stocke plus de détails d’exécution, la génération de rapports a plus d’impact sur les performances de votre instance.

Chaque niveau de génération de rapports génère progressivement plus de détails sur l’exécution du flux.

Désactivé

Le système ne génère pas les détails de l’exécution des flux. Le système ne génère les détails de l’exécution que lorsque vous exécutez un test.

Remarque :

Le test d’une action ou d’un flux génère les détails de l’exécution au niveau de la trace.

De base : états et durées d'exécution uniquement

Le système génère les détails de l’exécution de chaque flux, flux secondaire et action. Vous pouvez voir l’état et la durée d’exécution de ces éléments de base. Vous pouvez également consulter les valeurs de configuration et d’exécution des déclencheurs de flux, des entrées de flux secondaire et des sorties de flux secondaire.

Complet : valeurs de configuration et d’exécution (pour le débogage uniquement)

Le système génère les détails de la configuration et de l’exécution de chaque flux, flux secondaire et action. Vous pouvez voir l’état d’exécution, la durée, les valeurs d’entrée et les valeurs de sortie de tous les éléments. Pour les actions personnalisées, vous pouvez également voir l’état d’exécution, la durée, les valeurs d’entrée et les valeurs de sortie de ses étapes. Vous pouvez également voir les valeurs de configuration des déclencheurs de flux, des flux secondaires, des actions et des étapes qui font partie d’une action personnalisée. Ce niveau de génération de rapports est valide uniquement sur les instances de non-production. Les instances de production vous empêchent de définir le niveau de génération de rapports complet et rétablissent plutôt le niveau de génération de rapports à l’option de base.

Important :

Seuls les utilisateurs disposant du rôle fd_read_operations_all peuvent voir des informations de configuration et d’exécution telles que les valeurs d’enregistrement dans les détails d’exécution du flux. Les utilisateurs sans ce rôle ne verront que les détails de base sur l’état et la durée.

Trace : toutes les valeurs (à des fins de test et de support uniquement)

Le système génère les détails de la configuration et de l’exécution de chaque flux, flux secondaire, action et étape. Vous pouvez voir l’état d’exécution, la durée, les valeurs d’entrée et les valeurs de sortie de tous les éléments. Vous pouvez également voir les valeurs de configuration des déclencheurs de flux, des flux secondaires, des actions et des étapes.

Important :

Seuls les utilisateurs disposant du rôle fd_read_operations_all peuvent voir des informations de configuration et d’exécution telles que les valeurs d’enregistrement dans les détails d’exécution du flux. Les utilisateurs sans ce rôle ne verront que les détails de base sur l’état et la durée. Le test d’une action ou d’un flux génère les détails de l’exécution au niveau de la trace.

Si un flux s’exécute alors que la génération de rapports est désactivée, les détails de l’exécution passée ne sont jamais disponibles pour le flux, même si le niveau de génération de rapports change ultérieurement. Si un flux s’exécute pendant que la génération de rapports est activée, les détails d’exécution de ce flux sont disponibles, même si le niveau de génération de rapports change. Le niveau de génération de rapports n’a aucun effet sur les enregistrements de contexte et de journal.

Vous pouvez configurer le niveau de génération de rapports par défaut que le système utilise pour générer les détails de l’exécution chaque fois qu’un flux est exécuté. Pour plus d'informations, consultez Activer le reporting de flux.

Actualiser les données de flux

Mettez à jour les données d’exécution du flux selon les besoins. Définissez une préférence de flux pour actualiser automatiquement les données de flux lorsque vous exécutez un test. Consultez Préférences utilisateur pour les flux.

État du flux

Tous les flux actifs sont dans l’un de ces états.

Terminé

Le flux a exécuté avec succès toutes les actions. Les statistiques de flux affichent les détails de configuration et d’exécution de chaque action.

Annulée

Le flux a été arrêté parce que la durée d’exécution du flux a dépassé la valeur du délai d’expiration du flux ou quelqu’un a annulé manuellement le flux.

En attente

Le flux a mis en pause une action qui attend qu’une condition soit remplie avant de continuer. Les statistiques de flux affichent les détails de configuration et d’exécution des actions effectuées ainsi que de toutes les actions en attente qu’une condition soit remplie. Les flux à l’état En attente affichent une action d’interface utilisateur « Annuler le flux » dans l’en-tête.

En pause

Flux mis en pause pour permettre l’exécution de flux de priorité plus élevée ou pour activer un arrêt de nœud approprié. Les statistiques de flux affichent les détails de configuration et d’exécution des actions effectuées.

Présomption d'interruption

Le flux est en cours d’exécution depuis plus de 15 minutes et n’a plus d’ID de transaction valide pour le nœud actuel. Sinon, le flux s’exécute depuis plus de huit heures sur un autre nœud. Le flux peut s’être arrêté en raison d’une interruption inattendue telle que l’arrêt de sa transaction ou le redémarrage de son nœud.

Erreur

Le flux s’est arrêté avec une erreur. Les statistiques de flux affichent les détails de configuration et d’exécution des actions terminées, ainsi que les détails de configuration de l’action qui a produit l’erreur. Les flux à l’état Erreur affichent une action d’interface utilisateur « Accéder à l’erreur » dans l’en-tête.

Remarque :

Lorsqu’une action entraîne une erreur, le flux cesse de s’exécuter à ce moment-là et entraîne un état d’erreur.

Options d’enregistrement connexe

À partir de la page Détails d’exécution, vous pouvez accéder aux enregistrements associés au flux actuel.

Ouvrir le flux

Utilisez cette option pour effectuer des changements de configuration et publier une nouvelle instance du flux. La modification de la configuration du flux ne modifie aucun flux actuellement actif.

Ouvrir l'enregistrement de contexte

Utilisez cette option pour afficher l’état du flux, la durée d’exécution et les entrées de journal connexes à partir d’une vue de formulaire standard. Cette option ouvre l’enregistrement de contexte dans un nouvel onglet.

Ouvrir les journaux de flux

Utilisez ce lien pour afficher des informations de journal détaillées sur chaque action. Ce lien ouvre la liste des entrées de journal dans un nouvel onglet.

Ouvrir l'enregistrement actuel

Pour les flux qui ont un déclencheur basé sur les enregistrements, utilisez ce lien pour afficher l’enregistrement de déclenchement dans une fenêtre contextuelle.

Ouvrir l'action

Utilisez ce lien pour effectuer des changements de configuration et publier une nouvelle instance de l’action. La modification de la configuration de l’action ne modifie aucun flux actuellement actif. Ce lien n’est pas disponible pour les actions de base fournies par ServiceNow.

Statistiques de flux

Utilisez les statistiques de flux pour afficher les détails de configuration et les valeurs d’exécution de chaque composant de flux. La sélection d’un déclencheur ou d’une action développe la ligne et affiche les détails de configuration et d’exécution correspondants.

Les types de détails d’exécution suivants sont disponibles.

Source de l’appel

Affichez la source d’appel qui a démarré un flux, un flux secondaire ou une action.

Exécuter en tant que

Identifiez si le flux a été exécuté en tant que système ou en tant qu’utilisateur qui l’a déclenché.

Exécuter avec des rôles

Identifiez les rôles accordés à l’utilisateur qui a déclenché le flux.

Métadonnées d'intégration

Affichez les données de transaction telles que la connexion et les informations d’identification utilisées, le serveur MID utilisé, l’hôte cible et la taille de la charge utile. Les métadonnées d’intégration ne s’affichent que pour les étapes d’intégration et nécessitent un abonnement distinct Centre d'intégration . Pour plus d’informations, consultez la section Étapes d’intégration.

Détails de la configuration

Affichez la liste des variables d’entrée pour identifier toute erreur de configuration avec l’action. Chaque variable a sa propre ligne affichant son nom, son type de données, ses paramètres de configuration et sa valeur d’exécution. Les paramètres de configuration affichent les valeurs dynamiques sous forme de pastilles. Les valeurs d’exécution affichent les enregistrements générés sous forme de lien.

Remarque :

Les variables qui ont des fonctions de transformation n’affichent qu’une seule valeur d’exécution, qui est le résultat de toutes les transformations.

Données de sortie

Affichez la liste des variables de sortie pour identifier toute erreur de configuration dans l’action.

Journaux

Utilisez les entrées de journal pour identifier les problèmes potentiels de traitement ou de performances. Chaque entrée de journal a sa propre ligne affichant la date de création, le niveau de journal et le message du journal. Si l’action ne génère aucun journal, les statistiques affichent la chaîne Aucun journal.

Remarque :

Les journaux affichent l’heure au format UTC, car les journaux doivent être enregistrés en tant que chaînes pour que l’instance puisse partager les données du journal entre ses multiples nœuds. Étant donné que chaque nœud peut se trouver dans un fuseau horaire différent, le format UTC est utilisé comme format commun pour préserver les valeurs horaires correctes.

Étapes

Utilisez la liste des étapes pour identifier toute erreur de configuration avec l’action. Chaque étape possède sa propre ligne affichant le nom de la variable, le type de données, les paramètres de configuration et la valeur d’exécution. Les actions de base n’affichent pas les étapes, car vous ne pouvez pas modifier leur configuration.

Modifiez la propriété système pour tronquer les com.snc.process_flow.reporting.serialized.val_size_limit valeurs d’exécution dans la configuration de l’étape des détails d’exécution du flux. Pour en savoir plus, consultez Studio de workflow Propriétés système du flux.

Heure de début

Affichez l’heure locale à laquelle une action a débuté.

Durée d’exécution

Utilisez la durée d’exécution pour identifier les problèmes potentiels de traitement ou de performances. La durée d’exécution est mesurée en millisecondes. À partir de la Washington DC version, la durée d’exécution répertorie le temps total d’exécution d’un élément. Le temps total inclut ces éléments.

• Temps dans la file d’attente de l’événement
• Temps dans la file d’attente ECC
• Heure de traitement de l’événement
• Temps d’exécution dans le moteur de flux
• Temps de communication avec un serveur MID

Informations sur le nouvel essai

Utilisez la section Informations sur les nouveaux essais pour afficher les détails de la politique des nouveaux essais. Le type de stratégie de nouvelle tentative, le temps écoulé et la prochaine demande de nouvelle tentative planifiée sont plus détaillés. La section Informations sur les nouveaux essais s’affiche uniquement lorsque la politique des nouveaux essais est activée dans l’étape. Pour plus d'informations, consultez Politique des nouveaux essais.

Source de l’appel

La source de l’appel répertorie ce qui a démarré un flux, un flux secondaire ou une action.

Visionneuse de texte incorporé

Studio de workflow affiche des enregistrements de configuration et de sortie d’exécution basés sur du texte volumineux, tels que la sortie d’e-mail, les charges utiles XML ou les étapes de script à l’aide d’une visionneuse de texte incorporée. La visionneuse de texte incorporé peut formater le texte en HTML, en texte brut ou en JavaScript à code couleur. Pour les étapes de script, la visionneuse de texte met en évidence les lignes de code contenant des erreurs.

Afficher les résultats de chaque élément dans la logique de flux

Studio de workflow Affiche un contrôle de sélection pour afficher les résultats de configuration et d’exécution de chaque élément traité par la logique de flux. Sélectionnez un numéro d’enregistrement pour afficher les détails de sa configuration et de son exécution.

Détails d’exécution du flux secondaire

Les analystes de processus peuvent afficher les détails d’exécution du flux secondaire à partir de plusieurs emplacements.

Flux parent

Un flux parent répertorie les détails d’exécution de chaque flux secondaire qu’il appelle en tant qu’éléments en ligne. Développez l’étape du flux secondaire pour afficher les détails de l’exécution du flux secondaire.

Flux secondaire

Le système génère les détails d’exécution du flux pour chaque exécution de flux secondaire. Affichez les détails d’exécution du flux secondaire directement à partir de la liste des exécutions de flux.

Prise en charge du rôle d’utilisateur

Vous pouvez contrôler l’accès aux détails d’exécution du flux en accordant des rôles d’utilisateur. Pour plus d’informations sur les rôles d’utilisateur disponibles Studio de workflow , reportez-vous à la section Accès de l’utilisateur aux Studio de workflow flux.

Exécuter avec la prise en charge des rôles

Lorsqu’un flux s’exécute avec un ou plusieurs rôles privilégiés, un utilisateur doit également disposer de ces rôles privilégiés pour voir les détails de l’exécution du flux. Par exemple, si un flux s’exécute en tant que système, un utilisateur doit disposer du rôle d’administrateur pour afficher les détails de son exécution. En outre, si un flux s’exécute avec un rôle qui peut accéder au chiffrement de champ, un utilisateur doit également disposer de ce rôle afin d’afficher les détails de son exécution de flux. Pour plus d’informations sur le chiffrement de champ et les rôles, reportez-vous à la section Field Encryption.