Página de Detalhes da execução — Visão geral da interface

Você pode encontrar os detalhes de todas as execuções de máquina de estado, em andamento e anteriores, tanto para fluxos de trabalho padrão quanto expresso, na página de Detalhes da execução. Se você especificou um ID de execução ao iniciar uma execução, essa página será intitulada com esse ID. Caso contrário, ela será intitulada com um ID de execução exclusivo que o Step Functions gera automaticamente para você.

Além das métricas de execução, a página de Detalhes da execução fornece as seguintes opções para gerenciar a máquina de estado e sua execução:

Button	Selecione esse botão para:
Editar uma máquina de estado	Editar a definição da Amazon States Language da máquina de estado.
Nova execução	Iniciar uma nova execução da máquina de estado.
Ações	Fornece as seguintes opções de escolha: Interromper execução — pare uma execução em andamento. Essa opção não está disponível para execuções concluídas. Redrive — Redrive as execuções de Fluxos de trabalho padrão que não tenham sido concluídas com êxito nos últimos 14 dias. Isso inclui execuções com falha, abortadas ou expiradas. Para ter mais informações, consulte Redriving execuções. Exportar — exporte os detalhes da execução no formato JSON para compartilhá-los com outras pessoas ou realizar análises off-line. Enviar feedback — compartilhe comentários sobre a interface.

Visualizar execuções iniciadas com uma versão ou alias

Você também pode ver as execuções iniciadas com uma versão ou um alias no console do Step Functions. Para obter mais informações, consulte Listar execuções para versões e aliases.

A página do console de Detalhes da execução contém as seguintes seções:

1. Resumo da execução

2. Mensagem de erro

3. Modo de visualização

4. Detalhes da etapa

5. Eventos

Resumo da execução

A seção de Resumo da execução aparece na parte superior da página de Detalhes da execução. Essa seção fornece a você uma visão geral dos detalhes da execução do fluxo de trabalho. Essas informações são divididas nas três guias a seguir:

Detalhes

Mostra informações, como o status da execução, ARN e carimbos de data e hora do início e término da execução. Você também pode visualizar a contagem total de Transições de estado que ocorreram durante a execução da máquina de estado. Você também pode visualizar os links para o mapa de rastreamento X-Ray e os Amazon CloudWatch Execution Logs se tiver ativado o rastreamento ou os registros para sua máquina de estado.

Se a execução da sua máquina de estado tiver sido iniciada por outra máquina de estado, você conseguirá ver o link da máquina de estado principal nessa guia.

Se a execução da sua máquina de estado era redriven, essa guia exibirá informações relacionadas ao redrive, por exemplo, contagem de Redrive.

Entrada e saída de execução

Mostra a entrada e a saída da execução da máquina de estado side-by-side.

Definição

Mostra a definição da Amazon States Language da máquina de estado.

Mensagem de erro

Se a execução da máquina de estado falhar, a página Detalhes da execução exibirá uma mensagem de erro. Escolha Causa ou Exibir detalhes da etapa na mensagem de erro para ver o motivo da falha na execução ou a etapa que causou o erro.

Se você escolher Exibir detalhes da etapa, o Step Functions destacará a etapa que causou o erro nas guias Detalhes da etapa, Exibição em gráfico e Exibição em tabela. Se a etapa for um estado Tarefa, Mapa ou Paralelo para o qual você definiu novas tentativas, o painel de Detalhes da etapa exibirá a guia Repetir para a etapa. Além disso, se você tiver redriven a execução, será possível ver as novas tentativas e os detalhes do redrive da execução na guia Tentativas e redrives do painel de Detalhes da etapa.

No botão suspenso Recuperar dessa mensagem de erro, você pode redrive as execuções malsucedidas ou iniciar uma nova. Para ter mais informações, consulte Redriving execuções.

Modo de visualização

A seção de Modo de visualização contém duas visualizações diferentes para a máquina de estado. Você pode optar por visualizar uma representação gráfica do fluxo de trabalho, uma tabela descrevendo os estados em um fluxo de trabalho ou uma lista dos eventos associados à execução da máquina de estados:

nota

Escolha uma guia para ver o conteúdo.

Graph view

O modo de Modo de visualização exibe uma representação gráfica do fluxo de trabalho. Há uma legenda na parte inferior que indica o status de execução da máquina de estado. Ela também contém botões que permitem ampliar, reduzir o zoom, centralizar o fluxo de trabalho completo ou visualizar o fluxo de trabalho no modo de tela cheia.

Nessa exibição, você pode escolher qualquer etapa em um fluxo de trabalho para ver detalhes sobre sua execução no componente Detalhes da etapa. Quando você escolhe uma etapa na Exibição em gráfico, a Exibição em tabela também mostra essa etapa. Esse comportamento se repete na ordem inversa. Se você escolher uma etapa na Exibição em tabela, a Exibição em gráfico mostrará a mesma etapa.

Se a máquina de estado contiver um estado Map, Parallel ou ambos, você poderá visualizar seus nomes no fluxo de trabalho da Exibição em gráfico. Além disso, para o estado Map, a Exibição em gráfico permite que você se mova entre diferentes iterações dos dados de execução do estado Mapa. Por exemplo, se o estado Mapa tiver cinco iterações e você quiser visualizar os dados de execução da terceira e quarta iterações, faça o seguinte:

1. Escolha o estado Mapa cujos dados de iteração você deseja visualizar.

2. Em Visualizador de iteração do mapa, escolha 2 na lista suspensa para a terceira iteração. Isso ocorre porque as iterações são contadas a partir de zero. Da mesma forma, escolha 3 na lista suspensa se quiser ver a quarta iteração do estado Mapa.

   Como alternativa, use os controles e para se mover entre diferentes iterações do estado Mapa.

   nota

   Se sua máquina de estado contiver estados Map aninhados, as listas suspensas das iterações do estado Map principal e secundário serão exibidas como mostrado no exemplo a seguir:

   

3. (Opcional) Se uma ou mais das iterações de estado Mapa falharem quando executadas ou a execução for interrompida, você poderá visualizar seus dados escolhendo esses números de iteração em Com falha ou Abortada, na lista suspensa.

Por fim, você pode usar os botões Exportar e Layout para exportar o gráfico do fluxo de trabalho como uma imagem SVG ou PNG. Você também pode alternar entre as visualizações horizontal e vertical do seu fluxo de trabalho.

Table view

O modo de Exibição em tabela exibe uma representação tabular dos estados de um fluxo de trabalho. Nesse modo de exibição, você pode ver os detalhes de cada estado que foi executado em seu fluxo de trabalho, incluindo seu nome, o nome de qualquer recurso usado (como uma AWS Lambda função) e se o estado foi executado com êxito.

Nessa exibição, você pode escolher qualquer estado em um fluxo de trabalho para ver detalhes sobre sua execução no componente Detalhes da etapa. Quando você escolhe uma etapa na Exibição em tabela, a Exibição em gráfico também mostra essa etapa. Esse comportamento se repete na ordem inversa. Se você escolher uma etapa na Exibição em gráfico, a Exibição em tabela mostrará a mesma etapa.

Você também pode limitar a quantidade de dados exibidos no modo de Exibição em tabela aplicando filtros à exibição. Você pode criar um filtro para uma propriedade específica, como Status ou Tentativa de Redrive. Para ter mais informações, consulte Tutorial: como examinar execuções de máquinas de estado usando o console do Step Functions.

Por padrão, esse modo exibe as colunas Nome, Tipo, Status, Recurso e Iniciado depois. Você pode configurar as colunas que deseja visualizar usando a caixa de diálogo Preferências. As seleções feitas nessa caixa de diálogo persistem nas futuras execuções de máquinas de estado, até serem novamente alteradas.

Se você adicionar a coluna Cronograma, a duração da execução de cada estado será mostrada em relação ao tempo da execução inteira. Será exibido como um cronograma linear e codificado por cor. Isso pode ajudar você a identificar quaisquer problemas relacionados ao desempenho da execução de um estado específico. Os segmentos codificados por cores para cada estado no cronograma ajudam a identificar o status da execução do estado, como em andamento, com falha ou abortada.

Por exemplo, se você definiu novas tentativas de execução para um estado na máquina de estado, elas serão mostradas no cronograma. Os segmentos vermelhos representam as tentativas Retry com falha, enquanto os segmentos cinza-claro representam o BackoffRate entre cada tentativa Retry.

Se a máquina de estado contiver um estado Map, Parallel ou ambos, você poderá visualizar seus nomes no fluxo de trabalho da Exibição em tabela. Para estados Map e Parallel, o modo de Exibição em tabela exibe os dados de execução de suas iterações e ramificações paralelas como nós dentro de uma visualização em árvore. Você pode escolher cada nó nesses estados para ver os detalhes individuais, na seção de Detalhes da etapa. Por exemplo, você pode revisar os dados de uma iteração específica do estado Mapa que causou a falha do estado. Basta expandir o nó do estado Mapa e, em seguida, visualizar o status de cada iteração na coluna Status.

Detalhes da etapa

A seção Detalhes da etapa é aberta à direita quando você escolhe um estado na Exibição em gráfico ou Exibição em tabela. Essa seção contém as seguintes guias, que fornecem informações detalhadas sobre o estado selecionado:

Entrada

Mostra os detalhes de entrada do estado selecionado. Se houver um erro na entrada, ele será indicado com um no cabeçalho da guia. Além disso, também é possível ver o motivo do erro nessa guia.

Você também pode escolher o botão de alternância Advanced view para ver o caminho de transferência dos dados de entrada à medida que os dados passam pelo estado selecionado. Isso permite identificar como sua entrada foi processada quando um ou mais campos, como InputPath, Parameters, ResultSelector, OutputPath e ResultPath, foram aplicados aos dados.

Saída

Mostra a saída do estado selecionado. Se houver um erro na saída, ele será indicado com um no cabeçalho da guia. Além disso, também é possível ver o motivo do erro nessa guia.

Você também pode escolher o botão de alternância Advanced view para ver o caminho de transferência dos dados de saída à medida que os dados passam pelo estado selecionado. Isso permite identificar como sua entrada foi processada quando um ou mais campos, como InputPath, Parameters, ResultSelector, OutputPath e ResultPath, foram aplicados aos dados.

Detalhes

Mostra informações, como o tipo de estado, status e duração da execução.

Para Task estados que usam um recurso, como AWS Lambda, essa guia fornece links para a página de definição do recurso e a página de CloudWatch registros da Amazon para a invocação do recurso. Também mostra valores, se especificados, para os campos TimeoutSeconds e HeartbeatSeconds do estado Task.

Para estados Map, essa guia mostra informações sobre a contagem total das iterações de um estado Map. As iterações são categorizadas como falhadas, abortadas, bem-sucedidas ou. InProgress

Definição

Mostra a definição da Amazon States Language correspondente ao estado selecionado.

Tentar novamente

nota

Essa guia aparece somente se você tiver definido um campo Retry no estado Task ou Parallel da máquina de estado.

Mostra as tentativas de repetição iniciais e subsequentes de um estado selecionado em uma tentativa de execução original. Para a tentativa inicial e todas as tentativas subsequentes com falha, escolha a opção ao lado de Tipo para ver o Motivo da falha que aparece em uma caixa suspensa. Se a nova tentativa for bem-sucedida, você poderá ver a Saída que aparece em uma caixa suspensa.

Se você tiver redriven a execução, o cabeçalho dessa guia exibirá o nome Tentativas e redrives e os detalhes da tentativa de repetição de cada redrive.

Eventos

Mostra uma lista filtrada dos eventos associados ao estado selecionado em uma execução. As informações que você vê nessa guia são um subconjunto do histórico completo de eventos de execução como visto na tabela Eventos.

Eventos

A tabela Eventos exibe o histórico completo da execução selecionada como uma lista de eventos abrangendo várias páginas. Cada página contém até 25 eventos. Essa seção também exibe a contagem total de eventos, o que pode ajudar você a determinar se a contagem máxima de 25.000 eventos do histórico foi excedida.

Por padrão, os resultados na tabela Eventos são exibidos em ordem crescente, com base no Timestamp dos eventos. Você pode alterar a classificação do histórico de eventos de execução para ordem decrescente clicando no cabeçalho da coluna Timestamp.

Na tabela Eventos, cada evento é codificado por cores para indicar o status de execução. Por exemplo, eventos que falharam aparecem em vermelho. Para ver detalhes adicionais sobre um evento, escolha ao lado do ID do evento. Depois de aberto, os detalhes do evento mostram a entrada, saída e invocação do recurso para o evento.

Além disso, na tabela Eventos, você pode aplicar filtros para limitar os resultados do histórico de eventos de execução exibidos. Você pode escolher propriedades como ID ou Tentativa de Redrive. Para ter mais informações, consulte Tutorial: como examinar execuções de máquinas de estado usando o console do Step Functions.