Asociar ejecuciones de máquinas de estado a una versión o 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 acción de la StartExecutionAPI. 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 estado mediante un ARN completo o incompleto.

• ARN completo: hace referencia al ARN de una máquina de estado que tiene sufijo con un número de versión o un nombre de alias.

  El siguiente ejemplo de ARN completo hace referencia a la versión 3 de una máquina de estado denominada myStateMachine.

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

  El siguiente ejemplo de ARN completo hace referencia a un alias denominado PROD de una máquina de estado llamada myStateMachine.

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

• ARN incompleto: hace referencia al ARN de una máquina de estado sin número de versión ni sufijo de nombre de alias.

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

Por ejemplo, si su ARN incompleto hace referencia a la versión 3, 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 ARN completo 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 inicia una ejecución con un ARN incompleto, Step Functions no asocia esa ejecución a una versión aunque la versión utilice la misma revision de la máquina de estado. Por ejemplo, si la versión 3 utiliza la última revisión, pero inicia una ejecución con un ARN incompleto, 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 de la API

Puede ver todas las ejecuciones asociadas a una versión o un alias invocando las acciones de la API DescribeExecutiony ListExecutions. Estas acciones de la API devuelven el ARN de 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 el ARN de la ejecución.

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

El siguiente ejemplo de respuesta de la acción de la ListExecutionsAPI muestra el ARN del alias utilizado para iniciar una ejecución de máquina de estado denominada. myFirstExecution

El texto en cursiva 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.

Uso de las métricas de 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 un ARN de versión, Step Functions publica la métrica con StateMachineArn y una segunda métrica con las dimensiones StateMachineArn yVersion.

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

• Dos métricas para el ARN incompleto y la versión.

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