Visualización y depuración de ejecuciones 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 y depuración de ejecuciones en la consola Step Functions

La página Detalles de ejecución de la consola de Step Functions presenta información sobre las ejecuciones de máquinas de estado pasadas y en curso para los flujos de trabajo estándar y rápido. Esta información se muestra en formato de panel. Por ejemplo, puede encontrar la definición de Amazon States Language de la máquina de estados, su estado de ejecución y el número total de transiciones de estado. ARN También puede ver los detalles de ejecución de cualquier estado individual en la máquina de estado.

Página de detalles de ejecución: información general de la interfaz

Puede encontrar los detalles de todas las ejecuciones de máquinas de estado en curso y pasadas, tanto para los flujos de trabajo estándar como para los rápidos, en la página Detalles de ejecución. Si especificó un identificador de ejecución al iniciar la ejecución, esta página se titulará con ese identificador de ejecución. De lo contrario, se titulará con el identificador de ejecución único que Step Functions genera automáticamente.

Además de las métricas de ejecución, la página Detalles de ejecución proporciona las siguientes opciones para gestionar la máquina de estado y su ejecución:

Button Elija este botón para:
Editar máquina de estado Editar la definición de Amazon States Language de la máquina de estado.
Nueva ejecución Comenzar una nueva ejecución de la máquina de estado.
Acciones

Ofrece las siguientes opciones entre las que elegir:

  • Detener la ejecución: detiene una ejecución en curso. Esta opción no está disponible para las ejecuciones finalizadas.

  • Redrive: utilizar Redrive con ejecuciones de flujos de trabajo estándar que no se hayan completado correctamente en los últimos 14 días. Estas incluyen las ejecuciones con error, anuladas o que hayan agotado su tiempo de espera. Para obtener más información, consulte Redrivingejecuciones de máquinas de estado en Step Functions.

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

  • Enviar comentarios: compartir comentarios sobre la interfaz.

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

La sección Resumen de ejecución aparece en la parte superior de la página Detalles de ejecución. Esta sección proporciona información general de los detalles de ejecución del flujo de trabajo. Esta información se divide en las tres pestañas siguientes:

Detalles

Muestra información, como el estado de la ejecuciónARN, y las marcas 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 con la ejecución de la máquina de estado se utilizó redriven, en esta pestaña se muestra información relacionada con redrive, por ejemplo, el recuento de Redrive.

Entrada y salida de ejecución

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

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 ha utilizado redriven con la ejecución, puede ver los reintentos y los detalles de ejecución de redrive en la pestaña Reintentos y redrives del Panel de detalles del paso.

Desde el botón desplegable Recuperar de este mensaje de error, puede utilizar redrive con las ejecuciones fallidas o iniciar una nueva ejecución. Para obtener más información, consulte Redrivingejecuciones de máquinas de estado en Step Functions.

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 el flujo de trabajo, incluidos su nombre, el nombre de cualquier recurso que haya utilizado (como una 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 estado o intento de Redrive. Para obtener más información, consulte Tutorial: Examen de las ejecuciones de máquinas de estado en Step Functions.

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 reintentos de ejecución para un estado en su máquina de estado, estos reintentos se mostrarán en la línea temporal. 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, por ejemplo AWS Lambda, esta pestaña proporciona enlaces a la página de definición del recurso 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 campo Retry en el estado Task o Parallel de la máquina de 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 ha utilizado redriven con la ejecución, el encabezado de esta pestaña muestra el nombre Reintentos y redrives y muestra los detalles de reintento para 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 ID o Intento de Redrive. Para obtener más información, consulte Tutorial: Examen de las ejecuciones de máquinas de estado en Step Functions.