Associazione di esecuzioni di macchine a stati con una versione o un alias

Step Functions associa un'esecuzione a una versione o alias basato sull'Amazon Resource Name (ARN) che usi per richiamare l'azione API. StartExecution Step Functions esegue questa azione all'inizio dell'esecuzione.

È possibile avviare l'esecuzione di una macchina a stati utilizzando un ARN qualificato o non qualificato.

• ARN qualificato: si riferisce a un ARN di una macchina a stati con il suffisso un numero di versione o un nome alias.

  Il seguente esempio di ARN qualificato si riferisce alla versione 3 di una macchina a stati denominata. myStateMachine

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

  Il seguente esempio di ARN qualificato si riferisce a un alias denominato PROD di una macchina a stati denominata. myStateMachine

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

• ARN non qualificato: si riferisce all'ARN di una macchina a stati senza un numero di versione o un suffisso del nome alias.

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

Ad esempio, se l'ARN qualificato si riferisce alla versione3, Step Functions associa l'esecuzione a questa versione. Non associa l'esecuzione a nessun alias che rimanda alla versione. 3

Se l'ARN qualificato fa riferimento a un alias, Step Functions associa l'esecuzione a quell'alias e alla versione a cui fa riferimento l'alias. Un'esecuzione può essere associata a un solo alias.

Nota

Se si avvia un'esecuzione con un ARN non qualificato, Step Functions non associa tale esecuzione a una versione anche se la versione utilizza la stessa macchina a stati. revision Ad esempio, se la versione 3 utilizza la revisione più recente, ma si avvia un'esecuzione con un ARN non qualificato, Step Functions non associa tale esecuzione alla versione 3.

Visualizzazione delle esecuzioni iniziate con una versione o un alias

Step Functions offre i seguenti modi in cui è possibile visualizzare le esecuzioni iniziate con una versione o un alias:

Utilizzo delle azioni API

Puoi visualizzare tutte le esecuzioni associate a una versione o a un alias richiamando le azioni DescribeExecutione ListExecutionsAPI. Queste azioni API restituiscono l'ARN della versione o dell'alias utilizzato per avviare l'esecuzione. Queste azioni restituiscono anche altri dettagli, tra cui lo stato e l'ARN dell'esecuzione.

Puoi anche fornire un alias di macchina a stati ARN o versione ARN per elencare le esecuzioni associate a un alias o a una versione specifici.

Il seguente esempio di risposta dell'azione ListExecutionsAPI mostra l'ARN dell'alias utilizzato per avviare un'esecuzione di una macchina a stati denominata. myFirstExecution

Il testo in corsivo nel seguente frammento di codice rappresenta informazioni specifiche sulla risorsa.

{
    "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"
        }
    ]
}

Utilizzo della console Step Functions

Puoi anche visualizzare le esecuzioni avviate da una versione o da un alias dalla console Step Functions. La procedura seguente mostra come visualizzare le esecuzioni avviate con una versione specifica:

1. Apri la console Step Functions, quindi scegli una macchina a stati esistente per la quale hai pubblicato una versione o creato un alias. Questo esempio mostra come visualizzare le esecuzioni iniziate con una versione specifica della macchina a stati.

2. Scegliete la scheda Versioni, quindi scegliete una versione dall'elenco Versioni.

   Suggerimento

   Filtra per proprietà o casella di valore per cercare una versione specifica.

3. Nella pagina dei dettagli della versione, è possibile visualizzare un elenco di tutte le esecuzioni in corso e passate di macchine a stati avviate con la versione selezionata.

L'immagine seguente mostra la pagina della console con i dettagli della versione. Questa pagina elenca le esecuzioni avviate dalla versione 4 di una macchina a stati denominataMathAddDemo. Questo elenco mostra anche un'esecuzione che è stata avviata da un alias denominato. PROD Questo alias ha indirizzato il traffico di esecuzione alla versione 4.

Utilizzo dei parametri CloudWatch

Per ogni esecuzione di una macchina a stati che si inizia con aQualified ARN, Step Functions emette metriche aggiuntive con lo stesso nome e valore delle metriche emesse attualmente. Queste metriche aggiuntive contengono dimensioni per ogni identificatore di versione e nome alias con cui si avvia un'esecuzione. Con queste metriche, è possibile monitorare le esecuzioni delle macchine a stati a livello di versione e determinare quando potrebbe essere necessario uno scenario di rollback. Puoi anche creare CloudWatch allarmi Amazon in base a questi parametri.

Step Functions emette le seguenti metriche per le esecuzioni che iniziano con un alias o una versione:

• ExecutionTime

• ExecutionsAborted

• ExecutionsFailed

• ExecutionsStarted

• ExecutionsSucceeded

• ExecutionsTimedOut

Se hai avviato l'esecuzione con una versione ARN, Step Functions pubblica la metrica con StateMachineArn e una seconda metrica con e dimensioni. StateMachineArn Version

Se hai avviato l'esecuzione con un alias ARN, Step Functions emette le seguenti metriche:

• Due metriche per l'ARN e la versione non qualificati.

• Una metrica con le dimensioni e. StateMachineArn Alias