Como o Step Functions associa execuções a uma versão ou alias

Step Functions associa uma execução a uma versão ou alias com base no Amazon Resource Name (ARN) que você usa para invocar a ação. StartExecutionAPI O Step Functions executa essa ação no horário de início da execução.

Você pode iniciar a execução de uma máquina de estado usando um qualificado ou um não qualificadoARN.

• Qualificado ARN — Refere-se a uma máquina de estado com o ARN sufixo de um número de versão ou nome de alias.

  O ARN exemplo qualificado a seguir se refere à versão 3 de uma máquina de estado chamadamyStateMachine.

  arn:aws:states:us-east-1:123456789012:stateMachine:myStateMachine:3

  O ARN exemplo qualificado a seguir se refere a um alias chamado PROD de uma máquina de estado chamadamyStateMachine.

  arn:aws:states:us-east-1:123456789012:stateMachine:myStateMachine:PROD

• Não qualificado ARN — Refere-se a uma máquina de estado ARN sem um número de versão ou um sufixo de nome de alias.

  arn:aws:states:us-east-1:123456789012:stateMachine:myStateMachine

Por exemplo, se seu qualificado se ARN refere à versão3, o Step Functions associa a execução a essa versão. Ele não associa a execução a nenhum alias que aponte para a versão 3.

Se seu qualificado ARN se referir a um alias, Step Functions associará a execução a esse alias e à versão para a qual o alias aponta. Uma execução só pode ser associada a um alias.

nota

Se você iniciar uma execução com um código não qualificadoARN, o Step Functions não associará essa execução a uma versão, mesmo que a versão use a mesma máquina de revision estado. Por exemplo, se a versão 3 usa a revisão mais recente, mas você inicia uma execução com uma versão não qualificadaARN, o Step Functions não associa essa execução à versão 3.

Como visualizar execuções iniciadas com uma versão ou um alias

O Step Functions fornece as seguintes maneiras pelas quais você pode visualizar as execuções iniciadas com uma versão ou um alias:

Usando API ações

Você pode visualizar todas as execuções associadas a uma versão ou a um alias invocando as DescribeExecutionações e. ListExecutionsAPI Essas API ações retornam ARN a versão ou o alias usado para iniciar a execução. Essas ações também retornam outros detalhes, incluindo o status e ARN a execução.

Você também pode fornecer um alias ARN ou versão da máquina de estado ARN para listar as execuções associadas a um alias ou versão específica.

O exemplo de resposta da ListExecutionsAPIação a seguir mostra o ARN alias usado para iniciar uma execução de máquina de estado chamada myFirstExecution.

A ferramenta italicized o texto no trecho de código a seguir representa informações específicas do recurso.

{
    "executions": [
        {
            "executionArn": "arn:aws:states:us-east-1:123456789012:execution:myStateMachine:myFirstExecution",
            "stateMachineArn": "arn:aws:states:us-east-1:123456789012:stateMachine:myStateMachine",
            "stateMachineAliasArn": "arn:aws:states:us-east-1:123456789012:stateMachine:myStateMachine:PROD",
            "name": "myFirstExecution",
            "status": "SUCCEEDED",
            "startDate": "2023-04-20T23:07:09.477000+00:00",
            "stopDate": "2023-04-20T23:07:09.732000+00:00"
        }
    ]
}

Como usar o console do Step Functions

Você também pode ver as execuções iniciadas por uma versão ou um alias no console do Step Functions. O seguinte procedimento mostra como você pode visualizar as execuções iniciadas com uma versão específica:

1. Abra o console do Step Functions e, em seguida, escolha uma máquina de estado existente para a qual você publicou uma versão ou criou um alias. Este exemplo mostra como visualizar as execuções iniciadas com uma versão específica da máquina de estado.

2. Escolha a guia Versões e, em seguida, escolha uma versão na lista Versões.

   dica

   Filtre por propriedade ou caixa de valor para pesquisar uma versão específica.

3. Na página de detalhes da versão, você pode ver uma lista de todas as execuções de máquina de estado em andamento e anteriores iniciadas com a versão selecionada.

A seguinte imagem mostra a página do console Detalhes da versão. Essa página lista as execuções iniciadas pela versão 4 de uma máquina de estado chamada MathAddDemo. Essa lista também exibe uma execução que foi iniciada por um alias chamado PROD. Esse alias roteou o tráfego de execução para a versão 4.

Usando CloudWatch métricas

Para cada execução de máquina de estado que você inicia com um Qualified ARN, o Step Functions emite métricas adicionais com o mesmo nome e valor das métricas emitidas atualmente. Essas métricas adicionais contêm dimensões para cada identificador de versão e nome de alias com os quais você inicia uma execução. Com essas métricas, você pode monitorar as execuções da máquina de estado no nível da versão e determinar quando um cenário de reversão pode ser necessário. Você também pode criar CloudWatch alarmes da Amazon com base nessas métricas.

O Step Functions emite as seguintes métricas para execuções que você inicia com um alias ou uma versão:

• ExecutionTime

• ExecutionsAborted

• ExecutionsFailed

• ExecutionsStarted

• ExecutionsSucceeded

• ExecutionsTimedOut

Se você iniciou a execução com uma versãoARN, o Step Functions publica a métrica com StateMachineArn e uma segunda métrica com StateMachineArn e Version dimensões.

Se você iniciou a execução com um aliasARN, o Step Functions emite as seguintes métricas:

• Duas métricas para o não qualificado ARN e a versão.

• Uma métrica com as dimensões StateMachineArn e Alias.