Cómo Step Functions asocia las ejecuciones a una versión o un alias - AWS Step Functions

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Cómo Step Functions asocia las ejecuciones a una versión o un alias

Step Functions asocia una ejecución a una versión o alias en función del nombre de recurso de Amazon (ARN) que se utiliza para invocar la StartExecutionAPIacción. Step Functions realiza esta acción en el momento en que comienza la ejecución.

Puede iniciar la ejecución de una máquina de estados utilizando un código cualificado o no ARN cualificado.

  • Calificada ARN: hace referencia a una máquina de estados con un ARN sufijo con un número de versión o un alias.

    El siguiente ARN ejemplo cualificado hace referencia a la versión 3 de una máquina de estado denominadamyStateMachine.

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

    El siguiente ARN ejemplo cualificado hace referencia al nombre PROD de un alias de una máquina de estado denominadamyStateMachine.

    arn:aws:states:us-east-1:123456789012:stateMachine:myStateMachine:PROD
  • No cualificado ARN: hace referencia a una máquina de estado ARN sin un número de versión ni un sufijo de nombre de alias.

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

Por ejemplo, si su calificación ARN se refiere a la versión3, Step Functions asocia la ejecución a esta versión. No asocia la ejecución a ningún alias que apunte a la versión 3.

Si su cualificado ARN hace referencia a un alias, Step Functions asocia la ejecución a ese alias y a la versión a la que apunta el alias. Una ejecución solo puede asociarse a un alias.

nota

Si inicias una ejecución con una no cualificadaARN, Step Functions no asociará esa ejecución a una versión aunque la versión utilice la misma máquina revision de estados. Por ejemplo, si la versión 3 usa la última revisión, pero se inicia una ejecución con una versión no calificadaARN, Step Functions no asocia esa ejecución a la versión 3.

Ver las ejecuciones iniciadas con una versión o un alias

Step Functions ofrece las siguientes formas de ver las ejecuciones iniciadas con una versión o un alias:

Uso de acciones API

Puede ver todas las ejecuciones asociadas a una versión o un alias invocando ListExecutionsAPIlas acciones DescribeExecutiony. Estas API acciones devuelven ARN la versión o el alias que se utilizó para iniciar la ejecución. Estas acciones también devuelven otros detalles, como el estado y ARN la ejecución.

También puede proporcionar un alias ARN o una versión de la máquina de estados ARN para enumerar las ejecuciones asociadas a un alias o versión específicos.

En el siguiente ejemplo de respuesta de la ListExecutionsAPIacción se muestra el ARN alias utilizado para iniciar una ejecución en una máquina de estados denominada myFirstExecution.

La italicized el texto del siguiente fragmento de código representa información específica del 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" } ] }

Uso de la consola de Step Functions

También puede ver las ejecuciones iniciadas por una versión o un alias desde la consola de Step Functions. En el siguiente procedimiento se muestra cómo ver las ejecuciones iniciadas con una versión específica:

  1. Abra la consola de Step Functions y, a continuación, seleccione una máquina de estado existente para la que haya publicado una versión o creado un alias. En este ejemplo se muestra cómo ver las ejecuciones iniciadas con una versión específica de la máquina de estado.

  2. Seleccione la pestaña Versiones y, a continuación, elija una versión de la lista de versiones.

    sugerencia

    Filtre por propiedad o cuadro de valores para buscar una versión específica.

  3. En la página Detalles de la versión, puede ver una lista de todas las ejecuciones de máquinas de estado en curso y pasadas que se hayan iniciado con la versión seleccionada.

En la siguiente imagen se muestra la página Detalles de la versión de la consola. Esta página muestra las ejecuciones iniciadas por la versión 4 de una máquina de estado denominada MathAddDemo. Esta lista también muestra una ejecución que se inició con un alias denominado PROD. Este alias enrutaba el tráfico de ejecución a la versión 4.

Captura de pantalla ilustrativa de la página de la consola de detalles de la versión de State Machine.

Uso de métricas CloudWatch

Para cada ejecución de una máquina de estado que se inicie con un Qualified ARN, Step Functions emite métricas adicionales con el mismo nombre y valor que las métricas emitidas actualmente. Estas métricas adicionales contienen dimensiones para cada identificador de la versión y nombre de alias con los que se inicia una ejecución. Con estas métricas, puede supervisar las ejecuciones de la máquinas de estado en el nivel de versión y determinar cuándo podría ser necesaria una reversión. También puedes crear CloudWatch alarmas de Amazon en función de estas métricas.

Step Functions emite las siguientes métricas para las ejecuciones que se inician con un alias o una versión:

  • ExecutionTime

  • ExecutionsAborted

  • ExecutionsFailed

  • ExecutionsStarted

  • ExecutionsSucceeded

  • ExecutionsTimedOut

Si ha iniciado la ejecución con una versiónARN, Step Functions publica la métrica con las dimensiones StateMachineArn y una segunda métrica con Version las dimensiones StateMachineArn y.

Si ha iniciado la ejecución con un aliasARN, Step Functions emite las siguientes métricas:

  • Dos métricas para la versión no cualificada ARN y la versión.

  • Una métrica con las dimensiones StateMachineArn y Alias.