Visualizando detalhes da execução do fluxo de trabalho em Step Functions - AWS Step Functions

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á.

Visualizando detalhes da execução do fluxo de trabalho em Step Functions

Para fluxos de trabalho padrão e expresso, você define a máquina de estado usando a Usando a Amazon States Language para definir fluxos de trabalho do Step Functions. Suas execuções de máquina de estado se comportarão de forma diferente, dependendo de qual Tipo você selecionar.

Importante

O tipo de fluxo de trabalho escolhido não pode ser alterado após a criação da máquina de estado.

Para obter mais informações sobre as diferenças entre fluxos de trabalho Padrão e Expresso, consulte Escolhendo o tipo de fluxo de trabalho em Step Functions.

O histórico das execuções do fluxo de trabalho Padrão é registrado no Step Functions, enquanto o histórico das execuções do fluxo de trabalho expressoo não é registrado no Step Functions. Para registrar o histórico da execução de um fluxo de trabalho do Express, você deve configurá-lo para enviar registros para a Amazon CloudWatch. Para obter mais informações, consulte Usando CloudWatch Logs para registrar o histórico de execução em Step Functions.

Depois que o registro em log estiver configurado em um fluxo de trabalho expressoo, você poderá visualizar execuções no console do Step Functions. A experiência do console para visualizar as execuções do fluxo de trabalho expressoo e as execuções do fluxo de trabalho Padrão é semelhante, exceto pelas diferenças e limitações a seguir.

nota

Como os dados de execução dos fluxos de trabalho do Express são exibidos usando o CloudWatch Logs Insights, a digitalização dos registros incorrerá em cobranças. Por padrão, o grupo de logs lista apenas as execuções concluídas nas últimas três horas. Se você especificar um intervalo de tempo maior que inclua mais eventos de execução, os custos aumentarão. Para obter mais informações, consulte Vended Logs na guia Logs na página CloudWatch de preços e. Usando CloudWatch Logs para registrar o histórico de execução em Step Functions

Diferenças na experiência do console

Para todos os fluxos de trabalho Standard e Express, você pode visualizar detalhes, como a máquina de estado e sua IAM função ARN, na página de detalhes da máquina de estado no console Step Functions.

Na página Detalhes da máquina de estado, você também pode ver uma lista dos históricos de execução da máquina de estado na guia Execuções. Use a caixa Filtrar execuções por propriedade ou valor para pesquisar uma execução, versão ou alias específico da máquina de estado escolhida. Use o menu suspenso Todos para filtrar os históricos de execução por status. Você também pode escolher um histórico de execução e selecionar o botão Exibir detalhes para abrir a página Detalhes da execução.

Fluxos de trabalho Padrão

Os históricos de execução dos fluxos de trabalho padrão estão sempre disponíveis para execuções concluídas nos últimos 90 dias.

Página de detalhes da máquina de estado para um fluxo de trabalho padrão com função ARN e uma lista de históricos de execução.
Fluxos de trabalho expressos

Para exibir o histórico de execução dos fluxos de trabalho do Express, o console Step Functions recupera os dados de registro coletados por meio de um grupo de registros de CloudWatch registros.

Você também deve ativar a nova experiência do console para visualizar as execuções do fluxo de trabalho expressoo. Para fazer isso, escolha o botão Ativar exibido dentro do banner na guia Execuções. Depois de escolher esse botão, ele não aparecerá novamente.

dica

Para alternar entre ativar ou desativar a experiência do console, use o botão de alternância Ativar histórico de execução expressa.

Os históricos de execuções concluídas nas últimas três horas estão disponíveis por padrão. Você pode ajustar esse intervalo de tempo ou especificar um intervalo personalizado. Se você especificar um intervalo de tempo maior que inclua mais eventos de execução, o custo para verificar os logs aumentará. Para obter mais informações, consulte Vended Logs na guia Logs na página CloudWatch de preços e. Usando CloudWatch Logs para registrar o histórico de execução em Step Functions

Página de detalhes da máquina de estado para um fluxo de trabalho Express com função ARN e uma lista de históricos de execução.

Considerações e limitações da visualização de execuções do fluxo de trabalho expressoo

Ao visualizar execuções do fluxo de trabalho expressoo no console do Step Functions, tenha em mente as considerações e limitações a seguir.

A disponibilidade dos detalhes da execução do fluxo de trabalho Express depende do Amazon CloudWatch Logs

nota

Se você não ativar a nova experiência do console para visualizar as execuções do fluxo de trabalho expressoo, os históricos de execução e os detalhes de execução correspondentes não estarão disponíveis no console do Step Functions. Para ativar a nova experiência do console, escolha o botão Ativar exibido dentro do banner na guia Execuções.

Para fluxos de trabalho do Express, seu histórico de execução e informações detalhadas de execução são coletados por meio do CloudWatch Logs Insights. Essas informações são mantidas no grupo de CloudWatch registros de registros que você especifica ao criar a máquina de estado. O histórico de execução da máquina de estado é mostrado na guia Execuções no console do Step Functions. Informações detalhadas sobre cada execução da máquina de estado são exibidas na página Detalhes da execução da execução escolhida.

Atenção

Se você excluir os CloudWatch registros de um fluxo de trabalho do Express, eles não serão listados na guia Execuções.

Recomendamos que você use o nível de log padrão de ALLpara registrar todos os tipos de eventos de execução. Você pode atualizar o nível de log conforme necessário para as máquinas de estado existentes ao editá-las. Para ter mais informações, consulte Usando CloudWatch Logs para registrar o histórico de execução em Step Functions e Níveis de log para eventos de execução do Step Functions.

Os detalhes da execução parcial do fluxo de trabalho Express estão disponíveis se o nível de registro for ERROR ou FATAL

Por padrão, o nível de registro para execuções de fluxo de trabalho do Express é definido como. ALL Se você alterar o nível do log, os históricos e os detalhes de execução das execuções concluídas não serão afetados. No entanto, todas as novas execuções emitirão logs com base no nível de log atualizado. Para ter mais informações, consulte Usando CloudWatch Logs para registrar o histórico de execução em Step Functions e Níveis de log para eventos de execução do Step Functions.

Por exemplo, se você alterar o nível do log de ALLpara um ERRORou FATAL, a guia Execuções no console Step Functions listará somente execuções com falha. Na guia Visualização de eventos, o console mostra somente os detalhes do evento para as etapas da máquina de estado que falharam.

Recomendamos que você use o nível de log padrão de ALLpara registrar todos os tipos de eventos de execução. Você pode atualizar o nível de log conforme necessário para as máquinas de estado existentes ao editar a máquina de estado.

A definição da máquina de estado de uma execução mais antiga não pode ser visualizada depois de atualizada

As definições da máquina de estado para execuções passadas não são armazenadas para fluxos de trabalho expressoo. Se você alterar a definição da máquina de estado, só poderá visualizar a definição da máquina de estado para execuções usando a definição mais atual.

Por exemplo, se você remover uma ou mais etapas da definição da máquina de estado, o Step Functions detectará uma incompatibilidade entre a definição e os eventos de execução anteriores. Como as definições anteriores não são armazenadas para fluxos de trabalho expressoo, o Step Functions não pode exibir a definição da máquina de estado para execuções realizadas em uma versão anterior da definição da máquina de estado. Como resultado, as guias de Entrada e saída da execução, Definição, Exibição em gráfico e Visualização em tabela não estão disponíveis para execuções realizadas em versões anteriores de uma definição de máquina de estado.