Examinando a execução do mapa de uma execução de estado de mapa distribuído

Ao executar um estado Map no modo distribuído, o Step Functions cria um recurso de Execução de mapa. Uma Execução de mapa se refere a um conjunto de execuções de fluxo de trabalho secundário que um estado Mapa distribuído inicia e às configurações de runtime que controlam essas execuções. O Step Functions atribui um nome do recurso da Amazon (ARN) à Execução de mapa. Você pode examinar uma Execução de mapa no console do Step Functions. Você também pode invocar a ação da API DescribeMapRun. A Map Run também emite métricas para CloudWatch.

O console Step Functions fornece uma página Map Run Details que exibe todas as informações relacionadas à execução de um estado de Mapa Distribuído. Por exemplo, você pode visualizar o status da execução do estado do Mapa Distribuído, o ARN do Map Run e os status dos itens processados nas execuções do fluxo de trabalho secundário iniciadas pelo estado do Mapa Distribuído. Você também pode ver uma lista de todas as execuções do fluxo de trabalho secundário e acessar seus detalhes. Além disso, se sua Execução de Mapa foi redriven, você pode ver os redrive detalhes da Execução de Mapa na Resumo da execução do Map Run seção. Por exemplo, Última redrive vez. O console exibe essas informações em formato de painel.

A página Detalhes da Execução do Mapa contém as seguintes seções:

Conteúdo

• Resumo da execução do Map Run
• Mensagem de erro
• Status de processamento do item
• Lista de execuções
• Redriving execuções de mapa
  • Elegibilidade de Redrive para fluxos de trabalho secundários em uma Execução de mapa
  • Comportamento do redrive de uma execução de fluxo de trabalho secundário
  • Cenários de entrada utilizados no redrive de uma Execução de mapa
  • Permissão do IAM para redrive uma Execução de mapa
  • Redriving uma Execução de mapa no console
  • Redriving Execução de mapa usando a API

Resumo da execução do Map Run

A seção Resumo da Execução da Execução do Mapa aparece na parte superior da página Detalhes da Execução do Mapa. Esta seção fornece uma visão geral dos detalhes de execução do estado do Mapa Distribuído. Essas informações são divididas entre as seguintes guias:

Detalhes

Mostra informações, como o status de execução do estado do Mapa Distribuído, o ARN de Execução do Mapa e o tipo das execuções do fluxo de trabalho secundário iniciadas pelo estado do Mapa Distribuído. Você pode visualizar configurações adicionais, como o limite de falha tolerado para o Map Run e a simultaneidade máxima especificada para execuções de fluxo de trabalho secundário. Você também pode editar essas configurações.

Entrada e saída

Mostra a entrada recebida pelo estado do Mapa Distribuído e a saída correspondente que ele gera. Por exemplo, você pode visualizar o conjunto de dados de entrada e sua localização e os filtros de entrada aplicados aos itens de dados individuais nesse conjunto de dados. Se você exportar a saída da execução do estado do Mapa Distribuído, essa guia mostra o caminho para o bucket do Amazon S3 que contém os resultados da execução. Caso contrário, ele direciona você para a página Detalhes da Execução do fluxo de trabalho principal para visualizar a saída da execução.

Mensagem de erro

Se sua Execução de Mapa falhar, a página Detalhes da Execução de Mapa exibirá uma mensagem de erro com o motivo da falha.

No botão suspenso Recuperar dessa mensagem de erro, você pode executar redrive o fluxo de trabalho secundário malsucedido iniciado por essa Execução de Mapa ou iniciar uma nova execução do fluxo de trabalho principal. Para ter mais informações, consulte Redriving execuções de mapa.

Status de processamento do item

A seção Status de processamento do item exibe o status dos itens processados em uma Execução de Mapa. Por exemplo, Pendente indica que a execução de um fluxo de trabalho secundário ainda não começou a processar o item.

Os status dos itens dependem do status das execuções do fluxo de trabalho secundário que processam os itens. Se a execução de um fluxo de trabalho secundário falhar, atingir o tempo limite ou se um usuário cancelar a execução, o Step Functions não receberá nenhuma informação sobre o resultado do processamento dos itens dentro da execução desse fluxo de trabalho secundário. Todos os itens processados por essa execução compartilham o status da execução do fluxo de trabalho secundário.

Por exemplo, digamos que você queira processar 100 itens em duas execuções secundárias de fluxo de trabalho, em que cada execução processa um lote de 50 itens. Se uma das execuções falhar e a outra for bem-sucedida, você terá 50 itens bem-sucedidos e 50 itens fracassados.

A tabela a seguir explica os tipos de status de processamento disponíveis para todos os itens:

Status	Descrição
Pendente	Indica um item que a execução do fluxo de trabalho secundário não iniciou o processamento. Se uma execução de mapa parar, falhar ou um usuário cancelar a execução antes do início do processamento de um item, o item permanecerá no status Pendente. Por exemplo, se uma execução de mapa falhar com 10 itens pendentes para serem processados, esses 10 itens permanecerão no status Pendente.
Running	Indica um item atualmente sendo processado pela execução do fluxo de trabalho secundário.
Sucedido	Indica que a execução do fluxo de trabalho secundário processou o item com êxito. Uma execução bem-sucedida do fluxo de trabalho secundário não pode ter nenhum item com defeito. Se um item no conjunto de dados falhar durante a execução, a execução de todo o fluxo de trabalho secundário falhará.
Com falha	Indica que a execução do fluxo de trabalho secundário falhou ao processar o item ou a execução atingiu o tempo limite. Se qualquer item processado pela execução de um fluxo de trabalho secundário falhar, toda a execução do fluxo de trabalho secundário falhará. Por exemplo, considere a execução de um fluxo de trabalho secundário que processou 1000 itens. Se algum item desse conjunto de dados falhar durante a execução, o Step Functions considerará que toda a execução do fluxo de trabalho secundário falhou. Quando você executa redriveum mapa, a contagem de itens com esse status é redefinida para 0.
Abortado	Indica que a execução do fluxo de trabalho secundário começou a processar o item, mas o usuário cancelou a execução ou o Step Functions interrompeu a execução porque o Map Run falhou. Por exemplo, considere a execução de um fluxo de trabalho secundário em execução que esteja processando 50 itens. Se a execução do mapa parar devido a uma falha ou porque um usuário cancelou a execução, a execução do fluxo de trabalho secundário e o status de todos os 50 itens serão alterados para Abortado. Se você usar uma execução secundária de fluxo de trabalho do tipo Express, não poderá interromper a execução. Quando você usa redriveum Map Run que inicia execuções de fluxo de trabalho secundário do tipo Express, a contagem de itens com esse status é redefinida para 0. Isso ocorre porque os fluxos de trabalho secundários do Express são reiniciados usando a ação da StartExecutionAPI em vez de serem. redriven

Lista de execuções

A seção Execuções lista todas as execuções do fluxo de trabalho secundário para uma execução de mapa específica. Use o campo Pesquisar pelo nome exato da execução para pesquisar a execução de um fluxo de trabalho secundário específico. Você também pode usar o menu suspenso Qualquer status para filtrar os históricos de execução do fluxo de trabalho secundário por status. Para ver detalhes sobre uma execução específica, selecione a execução de um fluxo de trabalho secundário na lista e escolha o botão Exibir detalhes para abrir a página Detalhes da execução.

Importante

A política de retenção para execuções de fluxo de trabalho infantil é de 90 dias. As execuções concluídas de fluxos de trabalho secundários anteriores a esse período de retenção não são exibidas na tabela Execuções. Isso é verdade mesmo se o estado do Mapa Distribuído ou o fluxo de trabalho principal continuar sendo executado por mais tempo do que o período de retenção. Você pode visualizar os detalhes da execução, incluindo os resultados, dessas execuções secundárias do fluxo de trabalho se exportar a saída do estado do Mapa Distribuído para um bucket do Amazon S3 usando. ResultWriter

dica

Escolha o botão Atualizar para ver a lista mais atual de todas as execuções de fluxo de trabalho secundário.