As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
O console do Step Functions tem uma página Detalhes da execução de mapa que exibe todas as informações relacionadas à execução de um estado de mapa distribuído. Por exemplo, é possível visualizar o status da execução do estado do mapa distribuído, o ARN da execução de mapa e os status dos itens processados nas execuções do fluxo de trabalho secundário iniciadas pelo estado do mapa distribuído. Também é possível ver uma lista de todas as execuções do fluxo de trabalho secundário e acessar os detalhes. Se a execução de mapa foi redriven, você também verá detalhes de redrive no resumo da execução de mapa.
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
. Uma Execução de mapa também emite métricas para o CloudWatch.
Os Detalhes da execução de mapa têm três seções: Resumo da execução de mapa, Status do processamento do Item e Lista de execuções.
Resumo da execução de mapa
O resumo da execução de mapa fornece uma visão geral dos detalhes de execução do estado do mapa distribuído.
- Detalhes
Mostra 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. É possível visualizar configurações adicionais, como o limite de falha tolerado para a execução de mapa e a simultaneidade máxima especificada para execuções de fluxo de trabalho secundário.
- Entrada e saída
Mostra a entrada recebida pelo estado do mapa distribuído e a saída correspondente gerada.
É possível visualizar o conjunto de dados de entrada e a localização, bem como 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 mostrará 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 a 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ê poderá redrive as execuções malsucedidas do fluxo de trabalho secundário iniciadas por essa execução de mapa ou iniciar uma nova execução do fluxo de trabalho principal.
Consulte Redriving execuções de mapa para saber como reiniciar o fluxo de trabalho.
Status de processamento do item
A seção Status do 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 ou 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 na 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 cem itens em duas execuções do fluxo de trabalho secundário, em que cada execução processa um lote de cinquenta itens. Se uma das execuções falhar e a outra for bem-sucedida, você terá cinquenta itens bem-sucedidos e cinquenta itens com falha.
A seguinte tabela 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 começou a processar. 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, este permanecerá no status Pendente. Por exemplo, se uma execução de mapa falhar com dez itens não processados, eles permanecerão no status Pendente. |
Em execução |
Indica um item que está sendo processado no momento pela execução do fluxo de trabalho secundário. |
Bem-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 falha. 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, pense na execução de um fluxo de trabalho secundário que processou mil 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ê redrive uma execução de mapa, a contagem de itens com esse status será redefinida como 0. |
Anulado |
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 a interrompeu porque a execução de mapa falhou. Por exemplo, pense em um fluxo de trabalho secundário em execução que esteja processando cinquenta itens. Se a execução de 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 cinquenta itens serão alterados para Anulado. Se você usar uma execução de fluxo de trabalho secundário do tipo expresso, não poderá interromper a execução. Quando você redrive uma execução de mapa que inicia execuções de fluxo de trabalho secundário do tipo expresso, a contagem de itens com esse status é redefinida como 0. Isso ocorre porque os fluxos de trabalho secundários expressos são reiniciados usando a ação de API StartExecution 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. Também é possível 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 Visualizar detalhes para abrir a página Detalhes da execução.
Importante
A política de retenção para execuções de fluxo de trabalho secundário é de noventa 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 será 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ê poderá visualizar os detalhes da execução, incluindo os resultados, dessas execuções do fluxo de trabalho secundário se exportar a saída do estado do mapa distribuído para um bucket do Amazon S3 usando ResultWriter (Mapa)
.
dica
Escolha o botão de atualização para visualizar a lista mais atualizada de todas as execuções de fluxo de trabalho secundário.