Page de détails d'exécution — Vue d'ensemble de l'interface

Vous trouverez les détails de toutes vos exécutions automatiques en cours et passées pour les flux de travail standard et express sur la page Détails de l'exécution. Si vous avez spécifié un ID d'exécution au début de votre exécution, cette page est intitulée avec cet ID d'exécution. Sinon, il est intitulé avec l'ID d'exécution unique que Step Functions génère automatiquement pour vous.

Outre les métriques d'exécution, la page Détails de l'exécution fournit les options suivantes pour gérer votre machine à états et son exécution :

Button	Cliquez sur ce bouton pour :
Modifier la machine à états	Modifiez la définition du langage Amazon States Language de votre machine à états.
Nouvelle exécution	Lancez une nouvelle exécution de votre machine d'état.
Actions	Propose les options suivantes parmi lesquelles choisir : Arrêter l'exécution : arrête une exécution en cours. Cette option n'est pas disponible pour les exécutions terminées. Redrive— des Redrive exécutions de flux de travail standard qui ne se sont pas terminées correctement au cours des 14 derniers jours. Il s'agit notamment des exécutions échouées, abandonnées ou dont le délai imparti a expiré. Pour de plus amples informations, veuillez consulter Redrivingexécutions. Exporter : exportez les détails de l'exécution au format JSON pour les partager avec d'autres personnes ou effectuer une analyse hors ligne. Envoyer des commentaires : partagez des commentaires sur l'interface.

Afficher les exécutions démarrées par une version ou un alias

Vous pouvez également consulter les exécutions démarrées avec une version ou un alias dans la console Step Functions. Pour plus d'informations, consultez la section Répertorier les exécutions pour les versions et les alias.

La page de console Détails de l'exécution contient les sections suivantes :

1. Résumé de l'exécution

2. Error message (Message d’erreur)

3. Mode d'affichage

4. Détails de l'étape

5. Événements

Résumé de l'exécution

La section Résumé de l'exécution apparaît en haut de la page Détails de l'exécution. Cette section fournit une vue d'ensemble des détails d'exécution de votre flux de travail. Ces informations sont réparties entre les trois onglets suivants :

Détails

Affiche des informations, telles que l'état de l'exécution, l'ARN et les horodatages des heures de début et de fin de l'exécution. Vous pouvez également consulter le nombre total de transitions d'état survenues lors de l'exécution de l'exécution de la machine à états. Vous pouvez également consulter les liens vers X-Ray Trace Map et Amazon CloudWatch Execution Logs si vous avez activé le suivi ou les journaux pour votre machine à états.

Si l'exécution de votre machine à états a été lancée par une autre machine à états, vous pouvez consulter le lien vers la machine à états parent dans cet onglet.

Si votre machine à états a été exécutée redriven, cet onglet affiche des informations redrive connexes, par exemple le Redrivenombre.

Entrée et sortie d'exécution

Affiche l'entrée et la sortie de l'exécution de la machine à états side-by-side.

Définition

Affiche la définition du langage Amazon States de la machine à états.

Error message (Message d’erreur)

Si l'exécution de votre machine à états échoue, la page Détails de l'exécution affiche un message d'erreur. Choisissez Cause ou Afficher les détails de l'étape dans le message d'erreur pour voir la raison de l'échec de l'exécution ou l'étape à l'origine de l'erreur.

Si vous choisissez Afficher les détails de l'étape, Step Functions met en évidence l'étape à l'origine de l'erreur dans les onglets Détails de l'étape, Vue graphique et Vue sous forme de tableau. Si l'étape est une tâche, une carte ou un état parallèle pour lequel vous avez défini de nouvelles tentatives, le volet Détails de l'étape affiche l'onglet Réessayer correspondant à l'étape. De plus, si vous avez effectué redriven l'exécution, vous pouvez voir les nouvelles tentatives et les détails de redrive l'exécution dans l'redrivesonglet Rétentatives et tentatives du volet des détails de l'étape.

À partir du bouton déroulant Restaurer de ce message d'erreur, vous pouvez soit effectuer redrive vos exécutions infructueuses, soit démarrer une nouvelle exécution. Pour de plus amples informations, veuillez consulter Redrivingexécutions.

Mode d'affichage

La section Mode d'affichage contient deux visualisations différentes pour votre machine à états. Vous pouvez choisir d'afficher une représentation graphique du flux de travail, un tableau décrivant les états de votre flux de travail ou une liste des événements associés à l'exécution de votre machine à états :

Note

Choisissez un onglet pour afficher son contenu.

Graph view

Le mode d'affichage graphique affiche une représentation graphique de votre flux de travail. Une légende est incluse en bas qui indique l'état d'exécution de la machine à états. Il contient également des boutons qui vous permettent de zoomer, de dézoomer, d'aligner l'ensemble du flux de travail au centre ou d'afficher le flux de travail en mode plein écran.

Dans cette vue, vous pouvez choisir n'importe quelle étape de votre flux de travail pour afficher les détails de son exécution dans le composant Détails de l'étape. Lorsque vous avez choisi une étape dans la vue graphique, la vue Tableau affiche également cette étape. Cela est également vrai dans le sens inverse. Si vous choisissez une étape dans la vue Tableau, la vue Graphique montre la même étape.

Si votre machine d'états contient un Map état, un Parallel état ou les deux, vous pouvez afficher leurs noms dans le flux de travail dans la vue graphique. En outre, pour l'Mapétat, la vue graphique vous permet de passer d'une itération à une autre des données d'exécution de l'état de la carte. Par exemple, si l'état de votre carte comporte cinq itérations et que vous souhaitez afficher les données d'exécution pour les troisième et quatrième itérations, procédez comme suit :

1. Choisissez l'état de la carte dont vous souhaitez afficher les données d'itération.

2. Dans la visionneuse d'itérations cartographiques, choisissez #2 dans la liste déroulante pour la troisième itération. Cela est dû au fait que les itérations sont comptées à partir de zéro. De même, choisissez #3 dans la liste déroulante pour la quatrième itération de l'état de la carte.

   Vous pouvez également utiliser les commandes et pour passer d'une itération à une autre de l'état de la carte.

   Note

   Si votre machine à états contient des Map états imbriqués, les listes déroulantes pour les itérations d'Mapétats parent et enfant seront affichées comme indiqué dans l'exemple suivant :

   

3. (Facultatif) Si une ou plusieurs itérations de votre état de carte ont échoué ou si l'exécution a été arrêtée, vous pouvez consulter ses données en choisissant les numéros d'itération sous Echec ou Abandonné dans la liste déroulante.

Enfin, vous pouvez utiliser les boutons Exporter et Disposition pour exporter le graphique du flux de travail sous forme d'image SVG ou PNG. Vous pouvez également passer d'une vue horizontale à une vue verticale de votre flux de travail.

Table view

Le mode d'affichage sous forme de tableau affiche une représentation tabulaire des états de votre flux de travail. Dans ce mode d'affichage, vous pouvez voir les détails de chaque état exécuté dans votre flux de travail, y compris son nom, le nom de toute ressource utilisée (telle qu'une AWS Lambda fonction) et si l'état a été exécuté correctement.

Dans cette vue, vous pouvez choisir n'importe quel état de votre flux de travail pour afficher les détails de son exécution dans le composant Détails de l'étape. Lorsque vous avez choisi une étape dans la vue Tableau, la vue Graphique affiche également cette étape. Cela est également vrai dans le sens inverse. Si vous choisissez une étape dans la vue graphique, la vue Tableau affiche la même étape.

Vous pouvez également limiter la quantité de données affichées en mode d'affichage sous forme de tableau en appliquant des filtres à l'affichage. Vous pouvez créer un filtre pour une propriété spécifique, telle que Status ou RedriveTentative. Pour de plus amples informations, veuillez consulter Tutoriel : Examen des exécutions par des machines à états à l'aide de la console Step Functions.

Par défaut, ce mode affiche les colonnes Nom, Type, État, Ressource et Commencé après. Vous pouvez configurer les colonnes que vous souhaitez afficher à l'aide de la boîte de dialogue Préférences. Les sélections que vous effectuez dans cette boîte de dialogue sont conservées pour les futures exécutions par State Machine jusqu'à ce qu'elles soient à nouveau modifiées.

Si vous ajoutez la colonne Chronologie, la durée d'exécution de chaque état est affichée par rapport au temps d'exécution pour l'ensemble de l'exécution. Ceci est affiché sous la forme d'une chronologie linéaire codée par couleur. Cela peut vous aider à identifier les problèmes liés aux performances liés à l'exécution d'un état spécifique. Les segments codés par couleur pour chaque état de la chronologie vous aident à identifier le statut d'exécution de l'état, par exemple en cours, en échec ou abandonné.

Par exemple, si vous avez défini des tentatives d'exécution pour un état dans votre machine à états, ces tentatives sont affichées dans la chronologie. Les segments rouges représentent les Retry tentatives infructueuses, tandis que les segments gris clair représentent les BackoffRate intervalles entre chaque Retry tentative.

Si votre machine à états contient un Map état, un Parallel état ou les deux, vous pouvez afficher leurs noms dans le flux de travail en mode Tableau. Pour les Parallel états Map et, le mode d'affichage sous forme de tableau affiche les données d'exécution de leurs itérations et de leurs branches parallèles sous forme de nœuds dans une vue arborescente. Vous pouvez choisir chaque nœud dans ces états pour afficher ses détails individuels dans la section Détails de l'étape. Par exemple, vous pouvez consulter les données d'une itération d'état de carte spécifique à l'origine de l'échec de l'état. Développez le nœud pour l'état de la carte, puis visualisez le statut de chaque itération dans la colonne État.

Détails de l'étape

La section Détails de l'étape s'ouvre sur la droite lorsque vous choisissez un état dans la vue graphique ou dans la vue Tableau. Cette section contient les onglets suivants, qui fournissent des informations détaillées sur l'état sélectionné :

Entrée

Affiche les détails d'entrée de l'état sélectionné. S'il y a une erreur dans la saisie, elle est indiquée par un en-tête dans l' onglet. De plus, vous pouvez voir la raison de l'erreur dans cet onglet.

Vous pouvez également cliquer sur le bouton d'affichage avancé pour voir le chemin de transfert des données d'entrée au fur et à mesure que les données passent par l'état sélectionné. Cela vous permet d'identifier la manière dont votre saisie a été traitée lorsqu'un ou plusieurs champs, tels que InputPathParameters,ResultSelector,OutputPath, etResultPath, ont été appliqués aux données.

Sortie

Affiche le résultat de l'état sélectionné. S'il y a une erreur dans le résultat, elle est indiquée par un en-tête dans l' onglet. De plus, vous pouvez voir la raison de l'erreur dans cet onglet.

Vous pouvez également cliquer sur le bouton d'affichage avancé pour voir le chemin de transfert des données de sortie au fur et à mesure que les données passent par l'état sélectionné. Cela vous permet d'identifier la manière dont votre saisie a été traitée lorsqu'un ou plusieurs champs, tels que InputPathParameters,ResultSelector,OutputPath, etResultPath, ont été appliqués aux données.

Détails

Affiche des informations, telles que le type d'état, son statut d'exécution et sa durée d'exécution.

Pour Task les États qui utilisent une ressource, par exemple AWS Lambda, cet onglet fournit des liens vers la page de définition de la ressource et la page Amazon CloudWatch Logs pour l'invocation de la ressource. Il affiche également les valeurs, si elles sont spécifiées, pour l'Taskétat TimeoutSeconds et HeartbeatSeconds les champs.

Pour Map les états, cet onglet affiche des informations concernant le nombre total d'itérations d'un Map état. Les itérations sont classées dans les catégories suivantes : échec, abandon, réussite ou. InProgress

Définition

Affiche la définition de la langue Amazon States correspondant à l'état sélectionné.

Réessayer

Note

Cet onglet apparaît uniquement si vous avez défini un Retry champ dans votre machine à états Task ou dans votre Parallel état.

Affiche les tentatives de nouvelle tentative initiale et suivantes pour un état sélectionné lors de sa tentative d'exécution initiale. Pour la tentative initiale et toutes les tentatives infructueuses suivantes, cliquez à côté de Type pour afficher la raison de l'échec qui apparaît dans une liste déroulante. Si la nouvelle tentative réussit, vous pouvez afficher le résultat qui apparaît dans une liste déroulante.

Si redriven votre exécution est terminée, cet en-tête d'onglet affiche le nom Rétentatives redrives et affiche les détails des tentatives pour chacune d'elles. redrive

Evénements

Affiche une liste filtrée des événements associés à l'état sélectionné dans une exécution. Les informations affichées dans cet onglet sont un sous-ensemble de l'historique complet des événements d'exécution que vous pouvez consulter dans le tableau Événements.

Événements

Le tableau Événements affiche l'historique complet de l'exécution sélectionnée sous la forme d'une liste d'événements s'étendant sur plusieurs pages. Chaque page contient jusqu'à 25 événements. Cette section affiche également le nombre total d'événements, ce qui peut vous aider à déterminer si vous avez dépassé le nombre maximum d'événements historiques de 25 000 événements.

Par défaut, les résultats du tableau Événements sont affichés par ordre croissant en fonction de l'horodatage des événements. Vous pouvez modifier le tri de l'historique des événements d'exécution par ordre décroissant en cliquant sur l'en-tête de la colonne Horodatage.

Dans le tableau Événements, chaque événement est codé par couleur pour indiquer son état d'exécution. Par exemple, les événements qui ont échoué apparaissent en rouge. Pour afficher des informations supplémentaires sur un événement, cliquez sur le bouton à côté de l'ID de l'événement. Une fois ouvert, les détails de l'événement indiquent l'entrée, la sortie et l'appel des ressources pour l'événement.

En outre, dans le tableau Événements, vous pouvez appliquer des filtres pour limiter les résultats de l'historique des événements d'exécution qui sont affichés. Vous pouvez choisir des propriétés telles que l'ID ou la Redrivetentative. Pour de plus amples informations, veuillez consulter Tutoriel : Examen des exécutions par des machines à états à l'aide de la console Step Functions.