Examen de l'exécution cartographique d'une exécution de l'état d'une carte distribuée - AWS Step Functions

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Examen de l'exécution cartographique d'une exécution de l'état d'une carte distribuée

Lorsque vous exécutez un Map état en mode distribué, Step Functions crée une ressource Map Run. Une exécution de carte fait référence à un ensemble d'exécutions de flux de travail enfants lancées par un état de carte distribuée, ainsi qu'aux paramètres d'exécution qui contrôlent ces exécutions. Step Functions attribue un Amazon Resource Name (ARN) à votre Map Run. Vous pouvez examiner un Map Run dans la console Step Functions. Vous pouvez également invoquer l'action d'DescribeMapRunAPI. Un Map Run envoie également des métriques à. CloudWatch

La console Step Functions fournit une page Map Run Details qui affiche toutes les informations relatives à l'exécution d'un état de carte distribuée. Par exemple, vous pouvez consulter le statut de l'exécution de l'état de la carte distribuée, l'ARN de la carte et le statut des éléments traités dans les exécutions du flux de travail enfant lancées par l'état de la carte distribuée. Vous pouvez également consulter la liste de toutes les exécutions de flux de travail enfants et accéder à leurs détails. De plus, si c'était le cas de votre Map Run redriven, vous pouvez consulter les redrive détails de cette exécution dans la Résumé de l'exécution de Map Run section. Par exemple, La dernière redrive fois. La console affiche ces informations sous forme de tableau de bord.

La page Map Run Details contient les sections suivantes :

La page de détails de Map Run contient trois sections : le résumé de l'exécution de Map Run, l'état du traitement des objets et la liste des exécutions.

Résumé de l'exécution de Map Run

La section récapitulative de l'exécution du Map Run apparaît en haut de la page des détails du Map Run. Cette section fournit une vue d'ensemble des détails d'exécution de l'état de la carte distribuée. Ces informations sont réparties entre les onglets suivants :

Détails

Affiche des informations, telles que l'état d'exécution de l'état de la carte distribuée, l'ARN de la carte distribuée et le type des exécutions du flux de travail enfant lancées par l'état de la carte distribuée. Vous pouvez consulter des configurations supplémentaires, telles que le seuil d'échec toléré pour le Map Run et la simultanéité maximale spécifiée pour les exécutions de flux de travail enfants. Vous pouvez également modifier ces configurations.

Entrée et sortie

Affiche l'entrée reçue par l'état de la carte distribuée et la sortie correspondante qu'il génère. Par exemple, vous pouvez afficher le jeu de données en entrée et son emplacement, ainsi que les filtres d'entrée appliqués aux éléments de données individuels de ce jeu de données. Si vous exportez le résultat de l'exécution de l'état de la carte distribuée, cet onglet indique le chemin d'accès au compartiment Amazon S3 qui contient les résultats de l'exécution. Sinon, il vous dirige vers la page Détails d'exécution du flux de travail parent pour afficher le résultat de l'exécution.

Error message (Message d’erreur)

Si votre exécution de carte a échoué, la page Détails de l'exécution de la carte affiche un message d'erreur indiquant la raison de l'échec.

À partir du bouton déroulant Restaurer de ce message d'erreur, vous pouvez soit annuler redrive les exécutions infructueuses du flux de travail enfant lancées par cette exécution de carte, soit démarrer une nouvelle exécution du flux de travail parent. Pour de plus amples informations, veuillez consulter RedrivingCartes parcourues.

Message d'erreur concernant l'échec d'une exécution de carte sur la page Détails de l'exécution de carte. Le message d'erreur affiche également les options de restauration en cas d'échec.

État du traitement des articles

La section État du traitement des éléments affiche l'état des éléments traités lors d'une exécution cartographique. Par exemple, Pending indique que l'exécution d'un flux de travail enfant n'a pas encore commencé à traiter l'élément.

Le statut des éléments dépend de l'état des exécutions du flux de travail enfant traitant les éléments. Si l'exécution d'un flux de travail enfant échoue, expire ou si un utilisateur annule l'exécution, Step Functions ne reçoit aucune information sur le résultat du traitement des éléments contenus dans l'exécution de ce flux de travail enfant. Tous les éléments traités par cette exécution partagent le même statut que l'exécution du flux de travail enfant.

Supposons, par exemple, que vous souhaitiez traiter 100 éléments dans le cadre de deux exécutions de flux de travail secondaires, chaque exécution traitant un lot de 50 éléments. Si l'une des exécutions échoue et que l'autre réussit, vous aurez 50 objets réussis et 50 objets échoués.

Le tableau suivant explique les types de statuts de traitement disponibles pour tous les articles :

État Description

En suspens

Indique un élément que l'exécution du flux de travail enfant n'a pas encore commencé à traiter. Si une exécution de carte s'arrête, échoue ou si un utilisateur annule l'exécution avant le début du traitement d'un élément, l'élément reste en attente.

Par exemple, si une exécution de carte échoue alors que 10 éléments sont en attente de traitement, ces 10 éléments restent dans le statut En attente.

En cours d'exécution

Indique un élément en cours de traitement par l'exécution du flux de travail enfant.

Réussi

Indique que l'exécution du flux de travail enfant a correctement traité l'élément.

L'exécution réussie d'un flux de travail enfant ne peut entraîner aucun échec. Si un élément de l'ensemble de données échoue pendant l'exécution, l'exécution complète du flux de travail enfant échoue.

Échec

Indique que l'exécution du flux de travail enfant n'a pas réussi à traiter l'élément ou que le délai d'exécution a expiré. Si l'exécution d'un élément traité par un flux de travail enfant échoue, l'exécution complète du flux de travail enfant échoue.

Imaginons, par exemple, l'exécution d'un flux de travail enfant qui a traité 1 000 éléments. Si un élément de cet ensemble de données échoue pendant l'exécution, Step Functions considère que l'exécution complète du flux de travail enfant a échoué.

Lorsque vous lancez redriveune carte, le nombre d'objets ayant ce statut est remis à 0.

Annulé

Indique que l'exécution du flux de travail enfant a commencé à traiter l'élément, mais que soit l'utilisateur a annulé l'exécution, soit Step Functions l'a arrêtée en raison de l'échec du Map Run.

Prenons l'exemple d'une exécution de flux de travail Running Child qui traite 50 éléments. Si l'exécution de la carte s'arrête en raison d'un échec ou parce qu'un utilisateur a annulé l'exécution, l'exécution du flux de travail enfant et le statut des 50 éléments passent à Abandonné.

Si vous utilisez une exécution de flux de travail enfant de type Express, vous ne pouvez pas arrêter l'exécution.

Lorsque vous lancez redriveune exécution de flux de travail enfant de type Express sur une carte, le nombre d'éléments présentant ce statut est remis à 0. Cela est dû au fait que les flux de travail Express Child sont redémarrés à l'aide de l'action de l'StartExecutionAPI au lieu de l'êtreredriven.

Liste des exécutions

La section Exécutions répertorie toutes les exécutions de flux de travail enfants pour un Map Run spécifique. Utilisez le champ Rechercher par nom d'exécution exact pour rechercher une exécution de flux de travail enfant spécifique. Vous pouvez également utiliser le menu déroulant N'importe quel statut pour filtrer les historiques d'exécution des flux de travail des enfants en fonction de leur statut. Pour voir les détails d'une exécution spécifique, sélectionnez une exécution de flux de travail enfant dans la liste et cliquez sur le bouton Afficher les détails pour ouvrir sa page de détails d'exécution.

Important

La politique de rétention pour les exécutions de flux de travail pour enfants est de 90 jours. Les exécutions de flux de travail enfant terminées qui sont antérieures à cette période de rétention ne sont pas affichées dans le tableau Exécutions. Cela est vrai même si l'état de la carte distribuée ou le flux de travail parent continue de s'exécuter au-delà de la période de rétention. Vous pouvez consulter les détails d'exécution, y compris les résultats, de ces exécutions de flux de travail enfants si vous exportez la sortie d'état de la carte distribuée vers un compartiment Amazon S3 à l'aide deResultWriter.

Astuce

Cliquez sur le bouton bell d'actualisation pour afficher la liste la plus récente de toutes les exécutions de flux de travail enfants.