Détails d'exécution du flux

Affichez les informations d’exécution sur une action ou un flux directement à partir de l’environnement de conception, telles que l’état actuel, les éléments exécutés et les valeurs produites. Ouvrez les enregistrements connexes à partir d’éditeurs incorporés Now Platform ou dans un nouvel onglet.

Chaque fois que vous testez un flux, le système génère des informations sur les valeurs de configuration et d’exécution produites en tant que détails d’exécution du flux. Vous pouvez afficher les détails d’exécution du flux à partir de l’onglet Opérations de Studio de workflow. Sélectionnez une exécution de flux pour ouvrir la page des détails de l’exécution associée.

Figure 1. Exemple de détails d’exécution de flux pour les exécutions d’aujourd’hui

Chaque page de détails d’exécution affiche des informations d’exécution sur le flux.

• Nom du flux
• Actualiser les données de flux
• État du flux
• Options d’enregistrement connexe
• Statistiques de flux

Figure 2. Exemple de détails d’exécution

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 au cours des 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 toujours des détails d’exécution de flux 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 un impact plus important sur les performances de votre instance.

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

Désactivé

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

Remarque :

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

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

Le système génère des détails d’exécution pour chaque flux, flux secondaire et exécution d’action. Les détails de l’exécution contiennent l’état d’exécution et la durée de chaque exécution de l’action et de la logique de flux. Les détails de l’exécution affichent également 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 des détails de configuration et d’exécution pour chaque flux, flux secondaire et exécution d’action. Les détails de l’exécution contiennent l’état d’exécution, la durée, les valeurs d’entrée et les valeurs de sortie de tous les éléments exécutés. Pour les actions personnalisées, les détails de l’exécution contiennent l’état d’exécution, la durée, les valeurs d’entrée et les valeurs de sortie de ses étapes. Les détails de l’exécution affichent également les valeurs de configuration et d’exécution des déclencheurs de flux, des flux secondaires, des actions et des étapes qui font partie d’une action personnalisée.

Important :

Seuls les utilisateurs disposant du rôle fd_read_operations_all peuvent voir les 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 des détails de configuration et d’exécution pour chaque flux, flux secondaire, action et exécution d’étape. Les détails de l’exécution contiennent l’état d’exécution, la durée, les valeurs d’entrée et les valeurs de sortie de tous les éléments exécutés. Les détails de l’exécution contiennent également les valeurs de configuration et d’exécution 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 les 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 des détails d’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 alors que la génération de rapports est activée, les détails de l’exécution de ce flux sont toujours 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 reporting par défaut utilisé par le système 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 la génération de rapports 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 se trouvent dans l’un de ces états.

Terminé

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

En attente

Le flux s’est mis en pause sur 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 terminées, ainsi que toutes les actions en attente qu’une condition soit remplie. Les flux dans 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 permettre un arrêt approprié du nœud. Les statistiques de flux affichent des détails de configuration et d’exécution pour les actions terminé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 est en cours d’exécution 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 et 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 de l’exécution, vous pouvez accéder aux enregistrements relatifs 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 principales fournies par ServiceNow.

Statistiques de flux

Utilisez les statistiques de flux pour afficher les détails de la configuration et les valeurs d’exécution pour 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.

Figure 3. Exemples de statistiques de flux

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 Hub d'intégration . Pour plus d’informations, consultez É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 possède 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 pilules. 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 avec 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 possède 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 toujours l’heure au format UTC, car les journaux doivent être enregistrés sous forme de chaînes afin que l’instance puisse partager les données du journal entre ses multiples nœuds. Étant donné que chaque nœud peut résider dans un fuseau horaire différent, le format UTC est utilisé comme format commun pour préserver les valeurs d’heure 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 com.snc.process_flow.reporting.serialized.val_size_limit propriété système pour tronquer les 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 éventuels problèmes de traitement ou de performances. La durée d’exécution est mesurée en millisecondes. À partir de la Washington DC mise en production, la durée d’exécution répertorie le temps total d’exécution d’un élément. Le temps total inclut le temps passé dans la file d’attente de l’événement, le temps passé dans la file d’attente ECC, le temps de traitement de l’événement, le temps d’exécution dans le moteur de flux et le temps de communication avec un MID Server.

Informations sur le nouvel essai

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

Source de l'appel

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

Source	Description
Studio de workflow Test	Le flux a démarré car quelqu’un a sélectionné l’option Test dans l’interface Studio de workflow . Les conditions de déclenchement du flux ont été ignorées.
Déclencheur CRUD	Le flux a démarré lorsque les conditions de déclenchement basées sur l’enregistrement étaient remplies.
Déclencheur de date	Le flux a démarré lorsque les conditions de déclenchement basées sur la planification étaient remplies.
Déclencheur de mesure	Le flux a démarré lorsque les conditions de déclenchement MetricBase d’un MetricBase ont été respectées.
Catalogue de services Répétition	Le flux a démarré lorsqu’un Catalogue de services élément a été demandé.
Script	Le flux a démarré à partir d’un appel de méthode dans un script, tel qu’une règle métier.
Script en arrière-plan	Le flux a démarré à partir d’un appel de méthode dans le module Scripts - Arrière-plan .

Visionneuse de texte incorporée

Studio de workflow affiche des enregistrements de configuration et de sortie d’exécution volumineux basés sur du texte, 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 au format HTML, texte brut ou JavaScript à code couleur. Pour les étapes de script, la visionneuse de texte met en surbrillance les lignes de code contenant des erreurs.

Figure 4. Exemple de vue de texte d’une étape de script

Affichage des résultats pour chaque élément dans la logique de flux

Studio de workflow Affiche un contrôle de sélecteur pour afficher les résultats de configuration et d’exécution pour 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.

Figure 5. Exemples de statistiques de flux pour chaque élément de la logique de flux

Détails de l’exécution du flux secondaire

Les analystes de processus peuvent afficher les détails de l’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 de l’exécution du flux secondaire directement à partir de la liste des exécutions de flux.