In che modo Step Functions associa le esecuzioni a una versione o a un alias - AWS Step Functions

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

In che modo Step Functions associa le esecuzioni a una versione o a un alias

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

È possibile avviare l'esecuzione di una macchina a stati utilizzando una macchina a stati qualificata o non qualificataARN.

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

    Il seguente ARN esempio 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 ARN esempio qualificato si riferisce a un alias denominato PROD di una macchina a stati denominatamyStateMachine.

    arn:aws:states:us-east-1:123456789012:stateMachine:myStateMachine:PROD
  • Non qualificata ARN: si riferisce a una macchina a stati ARN senza un numero di versione o un suffisso del nome alias.

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

Ad esempio, se il nome qualificato ARN 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 il tuo qualificato ARN si riferisce a un alias, Step Functions associa l'esecuzione a quell'alias e alla versione a cui punta l'alias. Un'esecuzione può essere associata a un solo alias.

Nota

Se si avvia un'esecuzione con un valore non qualificatoARN, Step Functions non associa tale esecuzione a una versione anche se la versione utilizza la stessa macchina revision a stati. Ad esempio, se la versione 3 utilizza la revisione più recente, ma si avvia un'esecuzione con un valore non qualificatoARN, 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

È possibile visualizzare tutte le esecuzioni associate a una versione o a un alias richiamando le DescribeExecutionazioni and. ListExecutionsAPI Queste API azioni restituiscono ARN la versione o l'alias utilizzati per avviare l'esecuzione. Queste azioni restituiscono anche altri dettagli, tra cui lo stato e ARN l'esecuzione.

È inoltre possibile fornire un alias ARN o una versione della macchina a stati ARN per elencare le esecuzioni associate a un alias o a una versione specifici.

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

Il italicized il testo nel seguente frammento di codice rappresenta informazioni specifiche della 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.

Schermata illustrativa della pagina della console con i dettagli della versione della macchina a stati.

Utilizzo delle metriche 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 iniziato l'esecuzione con una versioneARN, Step Functions pubblica la metrica con StateMachineArn e una seconda metrica con StateMachineArn e dimensioni. Version

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

  • Due metriche per la versione non qualificata e. ARN

  • Una metrica con le dimensioni eStateMachineArn. Alias