Visualización de los detalles de ejecución en la consola Step Functions - 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.

Visualización de los detalles de ejecución en la consola Step Functions

Puede ver las ejecuciones en curso y pasadas de los flujos de trabajo en la sección Ejecuciones de la consola Step Functions.

En los detalles de las ejecuciones, puede ver la definición de la máquina de estados, el estado de ejecuciónARN, el número de transiciones de estado y las entradas y salidas de los estados individuales del flujo de trabajo.

Captura de pantalla ilustrativa que muestra una lista de ejecuciones.

Los detalles de la ejecución del flujo de trabajo estándar se registran en Step Functions, pero no el historial de las ejecuciones del flujo de trabajo de Express. Para registrar las ejecuciones del flujo de trabajo de Express, debes configurar tus máquinas de estado de Express para que envíen los registros a Amazon CloudWatch. Consulte Iniciar sesión en CloudWatch los registros para configurar el registro de Step Functions.

La experiencia de la consola para ver ambos tipos de ejecuciones de flujos de trabajo es similar, pero los flujos de trabajo de Express presentan algunas limitaciones. Consulte Las consolas Standard y Express experimentan diferencias.

nota

Como los datos de ejecución de los flujos de trabajo de Express se muestran mediante CloudWatch Logs Insights, el escaneo de los registros conllevará gastos. De forma predeterminada, el grupo de registros solo muestra las ejecuciones completadas en las últimas tres horas. Si se especifica un intervalo de tiempo mayor que incluya más eventos de ejecución, los costos aumentarán. Para obtener más información, consulte los registros vendidos en la pestaña Registros de la página de CloudWatch precios.

Descripción general de los detalles de ejecución

El enlace de detalles de la ejecución y el título de la página utilizan el identificador de ejecución único generado por Step Functions o el identificador personalizado que proporcionaste al iniciar el flujo de trabajo. La página de detalles de la ejecución incluye métricas y las siguientes opciones para administrar su máquina de estados:

  • Detener la ejecución: detiene una ejecución en curso. (No disponible para las ejecuciones completadas).

  • Iniciar una nueva ejecución: inicie una nueva ejecución de su máquina de estados

  • Redrive – Redrive ejecuciones de flujos de trabajo estándar que no se completaron correctamente en los últimos 14 días, incluidas las ejecuciones fallidas, abortadas o agotadas. Para obtener más información, consulte Redriving máquinas de estado.

  • Exportar: exporte los detalles de la ejecución en un JSON formato para compartirlos o realizar análisis sin conexión.

Visualización de las ejecuciones iniciadas con una versión o alias

También puede ver las ejecuciones iniciadas con una versión o un alias en la consola de Step Functions. Para obtener más información, consulte Listado de ejecuciones por versiones y alias.

La página de la consola Detalles de ejecución contiene las siguientes secciones:

Resumen ejecutivo

El resumen de la ejecución proporciona una visión general de los detalles de ejecución del flujo de trabajo en las siguientes pestañas:

Detalles

Muestra información, como el estado de la ejecución y las marcas ARN horarias de la hora de inicio y finalización de la ejecución. También puede ver el recuento total de las Transiciones de estado que se produjeron durante la ejecución de la máquina de estado. También puede ver los enlaces al mapa de rastreo de X-Ray y a los registros de Amazon CloudWatch Execution si ha activado el rastreo o los registros para su máquina de estados.

Si la ejecución de su máquina de estado la inició otra máquina de estado, puede ver el enlace de la máquina de estado principal en esta pestaña.

Si la ejecución de su máquina de estado fue redriven, se muestra esta pestaña redrive información relacionada, por ejemplo Redrive contar.

Entrada y salida de ejecución

Muestra la entrada y la salida de la ejecución de la máquina de estado side-by-side.

Definición

La definición de Amazon States Language de la máquina de estado.

Mensaje de error

Si la ejecución de la máquina de estado ha producido un error, la página Detalles de ejecución muestra un mensaje de error. Elija Causa o Ver detalles del paso en el mensaje de error para ver el motivo del error de ejecución o el paso que lo provocó.

Si se selecciona Ver detalles del paso, Step Functions resalta el paso que provocó el error en las pestañas Detalles del paso, Vista de gráfico y Vista de tabla. Si el paso es un estado Tarea, Map o Parallel para el que se hayan definido reintentos, el panel Detalles del paso muestra la pestaña Reintentar del paso. Además, si tienes redriven la ejecución, puedes ver los reintentos y redrive detalles de ejecución en los reintentos y redrivespestaña del panel de detalles del paso.

Desde el botón desplegable Recuperar de este mensaje de error, puede hacer lo siguiente: redrive sus ejecuciones fallidas o iniciar una nueva ejecución. Para obtener más información, consulte Redriving máquinas de estado.

El mensaje de error correspondiente a una ejecución fallida de una máquina de estado aparecerá en la página de detalles de la ejecución. El mensaje de error también incluirá un enlace al paso que provocó el error de ejecución.

Modo de visualización

La sección Modo de visualización contiene dos visualizaciones diferentes para la máquina de estado. Puede elegir ver una representación gráfica del flujo de trabajo, una tabla con los estados del flujo de trabajo o una lista de los eventos asociados a la ejecución de la máquina de estado:

Vista gráfica

El modo de Vista de gráfico muestra una representación gráfica del flujo de trabajo. En la parte inferior se incluye una leyenda que indica el estado de ejecución de la máquina de estado. También contiene botones que permiten acercar, alejar, centrar y alinear todo el flujo de trabajo o ver el flujo de trabajo en modo de pantalla completa.

En la vista gráfica, puede elegir cualquier paso del flujo de trabajo para ver los detalles sobre su ejecución en el componente de detalles del paso. Al elegir un paso en la Vista de gráfico, la Vista de tabla también muestra ese paso. Esto también es cierto a la inversa. Si elige un paso en la Vista de tabla, la Vista de gráfico también muestra el mismo paso.

Si la máquina de estado contiene un estado Map, un estado Parallel o ambos, puede ver sus nombres en el flujo de trabajo de la Vista de gráfico. Además, para el estado Map, la Vista de gráfico permite desplazarse por diferentes iteraciones de los datos de ejecución del estado Map. Por ejemplo, si el estado Map tiene cinco iteraciones y desea ver los datos de ejecución de la tercera y la cuarta iteraciones, haga lo siguiente:

  1. Elija el estado Map cuyos datos de iteración desee ver.

  2. En el visor de iteraciones de Map, elija #2 en la lista desplegable para la tercera iteración. Esto se debe a que las iteraciones se cuentan desde cero. Del mismo modo, elija #3 en la lista desplegable para la cuarta iteración del estado Map.

    Como alternativa, utilice los controles del icono de flecha arriba y del icono de flecha abajo para moverse entre diferentes iteraciones del estado del mapa.

    nota

    Si su máquina de estados contiene Map estados anidados, se mostrarán las listas desplegables de las iteraciones de Map estado principales y secundarias para representar los datos de la iteración.

  3. (Opcional) Si una o más de las iteraciones de estado de Map no se ejecutaron o la ejecución se detuvo, puede seleccionar esos números de iteración en Con error o Anulada en la lista desplegable.

Por último, puede utilizar los botones Exportar y Maquetar para exportar el gráfico del flujo de trabajo como una imagen O. SVG PNG También puede cambiar entre las vistas horizontal y vertical del flujo de trabajo.

Vista de tabla

El modo Vista de tabla muestra una representación tabular de los estados del flujo de trabajo. En este modo de visualización, puede ver los detalles de cada estado que se ejecutó en su flujo de trabajo, incluidos su nombre y el nombre de cualquier recurso que haya utilizado (como un AWS Lambda función) y si el estado se ejecutó correctamente.

Desde esta vista, puede elegir cualquier estado del flujo de trabajo para ver los detalles relativos a su ejecución en el componente Detalles del paso. Al elegir un paso en la Vista de tabla, la Vista de gráfico también muestra ese paso. Esto también es cierto a la inversa. Si elige un paso de en Vista de gráfico, la Vista de tabla muestra el mismo paso.

También puede limitar la cantidad de datos que se muestran en el modo de Vista de tabla mediante la aplicación de filtros a la vista. Puede crear un filtro para una propiedad específica, como Status o Redrive intento. Para obtener más información, consulte Examine las ejecuciones.

De forma predeterminada, este modo muestra las columnas Nombre, Tipo, Estado, Recurso e Iniciado después de. Puede configurar las columnas que desee ver mediante el cuadro de diálogo Preferencias. Las selecciones que realice en este cuadro de diálogo se conservarán para futuras ejecuciones de máquinas de estado hasta que se vuelvan a cambiar.

Si agrega la columna Plazo, la duración de la ejecución de cada estado se muestra con respecto al tiempo de ejecución de toda la ejecución. Se muestra como una línea de tiempo lineal codificada por colores. Esto puede ayudar a identificar cualquier problema de rendimiento relacionado con la ejecución de un estado específico. Los segmentos codificados por colores para cada estado en el cronograma ayudan a identificar el estado de la ejecución, por ejemplo si está en curso, con error o anulada.

Por ejemplo, si ha definido los reintentos de ejecución para un estado de su máquina de estados, estos reintentos se muestran en la línea de tiempo. Los segmentos rojos representan los intentos de Retry con error mientras que los segmentos gris claro representan el valor de BackoffRate entre intentos de Retry.

Captura de pantalla de la vista de tabla con segmentos codificados por colores en la línea temporal.

Si la máquina de estado contiene un estado Map, un estado Parallel o ambos, puede ver sus nombres en el flujo de trabajo en la Vista de tabla. Para estados Map y Parallel, el modo Vista de tabla muestra los datos de ejecución de sus iteraciones y ramas paralelas como nodos dentro de una vista de árbol. Puede elegir cada nodo de estos estados para ver sus detalles individuales en la sección Detalles del paso. Por ejemplo, puede revisar los datos de una iteración del estado Map específica que provocó el error del estado. Expanda el nodo del estado Map y, a continuación, consulte el estado de cada iteración en la columna Estado.

Detalles del paso

La sección Detalles del paso se abre a la derecha al elegir un estado en la Vista de gráfico o la Vista de tabla. Esta sección contiene las siguientes pestañas, que proporcionan información detallada sobre el estado seleccionado:

Entrada

Muestra los detalles de la entrada del estado seleccionado. Si hay un error en la entrada, se indica con un icono de error en el encabezado de la pestaña. Además, en esta pestaña se puede ver el motivo del error.

También puede elegir el botón de alternar Vista avanzada para ver la ruta de transferencia de los datos de entrada a medida que los datos pasan por el estado seleccionado. Esto permite identificar cómo se procesó la entrada a medida que se aplicaron a los datos uno o más campos, como InputPath, Parameters ResultSelector, OutputPath y ResultPath.

Salida

Muestra la salida del estado seleccionado. Si hay un error en la salida, se indica con un icono de error en el encabezado de la pestaña. Además, en esta pestaña puede ver el motivo del error.

También puede pulsar el botón de alternar Vista avanzada para ver la ruta de transferencia de datos de salida a medida que los datos pasan por el estado seleccionado. Esto permite identificar cómo se procesó la entrada a medida que se aplicaron a los datos uno o más campos, como InputPath, Parameters ResultSelector, OutputPath y ResultPath.

Detalles

Muestra información, como el tipo de estado, su estado de ejecución y la duración de la ejecución.

Para Task los estados que utilizan un recurso, como AWS Lambda, esta pestaña proporciona enlaces a la página de definición de recursos y a la página de CloudWatch registros de Amazon para la invocación del recurso. También muestra los valores, si se especifican, para los campos TimeoutSeconds y HeartbeatSeconds del estado Task.

En el caso de los estados Map, esta pestaña muestra información sobre el recuento total de las iteraciones de un estado Map. Las iteraciones se clasifican como fallidas, abortadas, exitosas o. InProgress

Definición

Muestra la definición de Amazon States Language correspondiente al estado seleccionado.

Reintentar
nota

Esta pestaña aparece solo si ha definido un Retry campo en la máquina de estados Task o Parallel en el estado.

Muestra los reintentos iniciales y posteriores de un estado seleccionado en su intento de ejecución original. Para el intento fallido inicial y todos los intentos posteriores fallidos, pulse el icono de flecha situado junto a Tipo para ver el motivo del error que aparece en un cuadro desplegable. Si el reintento se ha realizado correctamente, puede ver la Salida, que aparece en un cuadro desplegable.

Si tienes redriven su ejecución, el encabezado de esta pestaña muestra el nombre Retries & redrivesy muestra los detalles del reintento de cada redrive.

Eventos

Muestra una lista filtrada de los eventos asociados al estado seleccionado en una ejecución. La información que aparece en esta pestaña es un subconjunto del historial completo de eventos de ejecución que aparece en la tabla Eventos.

Eventos

La tabla Eventos muestra el historial completo de la ejecución seleccionada como una lista de eventos que abarca varias páginas. Cada página contiene hasta 25 eventos. En esta sección también se muestra el recuento total de eventos, que puede ayudar a determinar si se ha superado el recuento máximo del historial de eventos, que es de 25 000 eventos.

Captura de pantalla de ejemplo que muestra un historial parcial de eventos de la ejecución de un flujo de trabajo.

De forma predeterminada, los resultados de la tabla Eventos se muestran en orden ascendente en función de la Marca temporal de los eventos. Puede cambiar la clasificación del historial de eventos de ejecución al orden descendente haciendo clic en el encabezado de la columna Marca temporal.

En la tabla Eventos, cada evento está codificado por colores para indicar su estado de ejecución. Por ejemplo, los eventos con error aparecen en rojo. Para ver detalles adicionales sobre un evento, selecciona el icono de flecha situado junto al ID del evento. Una vez abierto, los detalles del evento muestran la entrada, la salida y la invocación de recursos del evento.

Además, en la tabla Eventos, puede aplicar filtros para limitar los resultados del historial de eventos de ejecución que se muestran. Puede elegir propiedades como la ID o Redrive intento. Para obtener más información, consulte Examine las ejecuciones.

Las consolas Standard y Express experimentan diferencias

Flujos de trabajo estándar

Los historiales de ejecución de los flujos de trabajo estándar se encuentran siempre disponibles para las ejecuciones completadas en los últimos 90 días.

Flujos de trabajo rápidos

Para los flujos de trabajo de Express, la consola Step Functions recupera los datos de registro recopilados a través de un grupo de CloudWatch registros para mostrar el historial de ejecución. Los historiales de las ejecuciones completadas en las últimas tres horas están disponibles de forma predeterminada. Puede personalizar el intervalo de tiempo. Si especifica un intervalo de tiempo mayor que incluya más eventos de ejecución, el costo de escanear los registros aumentará. Para obtener más información, consulte Registros vendidos en la pestaña Registros de la página de CloudWatch precios yIniciar sesión en CloudWatch los registros.

Consideraciones y limitaciones para visualizar las ejecuciones de flujos de trabajo rápidos

Al ver las ejecuciones de flujos de trabajo de Express en la consola Step Functions, tenga en cuenta las siguientes consideraciones y limitaciones:

La disponibilidad de los detalles de ejecución del flujo de trabajo de Express depende de Amazon CloudWatch Logs

En el caso de los flujos de trabajo Express, su historial de ejecución y la información de ejecución detallada se recopilan a través de CloudWatch Logs Insights. Esta información se guarda en el grupo de CloudWatch registros que se especifica al crear la máquina de estados. El historial de ejecución de la máquina de estado se muestra en la pestaña Ejecuciones de la consola de Step Functions.

aviso

Si elimina los CloudWatch registros de un flujo de trabajo rápido, no aparecerán en la pestaña Ejecuciones.

Le recomendamos que utilice el nivel de registro predeterminado de ALLpara registrar todos los tipos de eventos de ejecución. Puede actualizar el nivel de registro según sea necesario para sus máquinas de estado existentes al editarlas. Para obtener más información, consulte Uso de CloudWatch registros para registrar el historial de ejecuciones en Step Functions y Niveles de registro de eventos.

Los detalles de ejecución parcial del flujo de trabajo de Express están disponibles si el nivel de registro es ERROR o FATAL

De forma predeterminada, el nivel de registro de las ejecuciones de flujos de trabajo de Express está establecido en ALL. Si se cambia el nivel de registro, los historiales de ejecución y los detalles de ejecución de las ejecuciones finalizadas no se verán afectados. No obstante, todas las ejecuciones nuevas emitirán registros según el nivel de registro actualizado. Para obtener más información, consulte Uso de CloudWatch registros para registrar el historial de ejecuciones en Step Functions y Niveles de registro de eventos.

Por ejemplo, si cambia el nivel de registro de ALLa ERRORo FATAL, la pestaña Ejecuciones de la consola Step Functions solo muestra las ejecuciones fallidas. En la pestaña Vista de eventos, la consola solo muestra los detalles del evento de la máquina de estado en los que se ha producido un error.

Se recomienda utilizar el nivel de registro predeterminado de ALLpara registrar todos los tipos de eventos de ejecución. Puede actualizar el nivel de registro según sea necesario para sus máquinas de estado existentes al editar la máquina de estado.

La definición de máquina de estados de una ejecución anterior no se puede ver después de modificar la máquina de estados

Las definiciones de máquinas de estados para ejecuciones anteriores no se almacenan para los flujos de trabajo de Express. Si cambia la definición de la máquina de estados, solo podrá ver la definición de la máquina de estados para las ejecuciones que utilicen la definición más reciente.

Por ejemplo, si elimina uno o varios pasos de la definición de la máquina de estado, Step Functions detecta una discrepancia entre la definición y los eventos de ejecución anteriores. Puesto que las definiciones anteriores no se almacenan para los flujos de trabajo rápidos, Step Functions no puede mostrar la definición de la máquina de estado para las ejecuciones que se realicen en una versión anterior de la definición de la máquina de estado. Como resultado, las pestañas Definición, Vista de gráfico y Vista de tabla no están disponibles para las ejecuciones ejecutadas en versiones anteriores de una definición de máquina de estados.