Monitoreo y registro de ejecución
Lista de ejecuciones, flujo de eventos en tiempo real, registros / costos / tokens y localización de errores: para ver con claridad el estado de la ejecución.
Una vez que un workflow está en marcha, poder entender «qué hizo exactamente y cuánto costó» decide si se atreve a ponerlo en producción. Esta página trata la lista de ejecuciones, el detalle de la ejecución, los eventos en tiempo real, el registro de tokens y costes, la exportación y el panel de datos.
Página de lista de ejecución
En la navegación de la izquierda, «Historial de ejecuciones». Admite dos vistas, tarjeta y tabla, y la lista se actualiza automáticamente cuando hay ejecuciones en marcha (se puede pausar). Filtros y ordenación:
- Búsqueda por palabra clave — por ID de ejecución o nombre del workflow
- Filtro por estado — PENDING / RUNNING / COMPLETED / FAILED / CANCELLED / INTERRUPTED
- Filtrado de flujo de trabajo: vea solo el historial de un determinado flujo de trabajo
- Ordenación — hora de inicio / hora de fin / duración / workflow / estado / progreso
En la parte superior de la lista hay además una fila de filtros rápidos con contador (En ejecución / Fallidas / Completadas / Interrumpidas); un clic para alternar.
Información mostrada para cada registro.
- Insignia de estado + ID de ejecución + nombre del workflow
- Barra de progreso y número de pasos completados (ej.: 5/7)
- Hora de inicio (tiempo relativo) y duración
- Los registros en RUNNING muestran además el paso que se está ejecutando en ese momento
- Los registros ya finalizados se pueden exportar como JSON / YAML directamente en la fila
Tras seleccionar varios, se pueden cancelar en lote las ejecuciones en marcha o borrar en lote los registros ya finalizados.
PENDING— Creada, aún no ha empezado a correr. Las ejecuciones que superan el límite de concurrencia se ponen primero en cola en este estado y pasan automáticamente a RUNNING cuando terminan las anteriores.RUNNING— Al menos un paso en ejecución.COMPLETED— Todos los pasos han terminado (incluidos los pasos SKIPPED por no cumplirse la condition).FAILED— Un paso ha dado error y la ejecución termina en fallo.CANCELLED— Cancelada manualmente por el usuario.INTERRUPTED— Interrumpida por causas del sistema, como un reinicio del servicio. Sobre si se reanuda automáticamente, ver la página de reanudación automática en «Siguiente paso» más abajo.
Página de detalles de ejecución
Pulse cualquier ejecución para entrar en la página de detalle. De arriba abajo:
- Barra superior — cancelar, refrescar, exportar (JSON / YAML), saltar al editor del workflow correspondiente
- Tarjeta de estado — estado, progreso, duración, y una vista rápida de tokens (enviados / recibidos / total)
- Pestañas del área principal (ver la tabla siguiente)
- Flujo «Registro de ejecución» en la parte inferior — un registro desplazable de todos los eventos, que se puede filtrar por nivel (debug / info / warn / error), buscar por palabra clave y pausar el desplazamiento automático
| Pestaña | contenido |
|---|---|
| pasos | Línea de tiempo vertical: el estado, la duración y el progreso de iteración de cada paso. Al pulsar se abre el panel lateral de detalle del paso; tras terminar la ejecución, se puede reejecutar desde un paso indicado. |
| dialogo | Combina las intervenciones del Agent, la salida del LLM, las llamadas a herramientas y los mensajes del sistema en un único flujo de chat por orden temporal. |
| Mensajes externos | Ver solo el registro de envíos y recepciones de los canales de IM (Slack / Telegram, etc.). |
| DAG | El grafo de pasos dibujado según las dependencias, con coloreado del estado de ejecución en tiempo real. |
| Reproducción | Reproduce el proceso de esta ejecución a lo largo de la línea de tiempo. |
| cadena de razonamiento | El contenido de razonamiento intermedio del Agent. |
| Artefacto | Todos los archivos de artefactos: vista previa, descarga, compartir un archivo único, o generar un enlace público para todo el directorio. |
| Rendimiento | El análisis de duración tras terminar la ejecución. |
| Depuración | Aparece cuando se han fijado puntos de interrupción o hay una sesión de depuración. |
Panel lateral de detalle del paso
Al pulsar un paso de la línea de tiempo, por la derecha se despliega toda la información de ese paso: salida, eventos, razonamiento, artefactos y conversación en varias pestañas (los pasos de tipo iteración / interacción / orquestación tienen sus pestañas adicionales correspondientes), además de las horas de inicio y fin y el botón «Reejecutar desde este paso». La información de error y el número de reintentos de un paso fallido también se ven aquí.
Actualización en tiempo real (WebSocket)
Cuando la ejecución está en estado RUNNING, la página de detalle recibe actualizaciones incrementales por WebSocket, sin necesidad de refrescar manualmente. Si la conexión se cae, se reconecta automáticamente (retroceso exponencial, hasta 5 veces); si aun así falla, degrada automáticamente a sondeo cada 2 segundos y lo avisa.
Tipos de mensaje enviado
| Tipo | significado |
|---|---|
full_status | Instantánea completa del estado de la ejecución |
status_change | Cambio de estado / progreso de la ejecución |
step_update | Actualización de estado de un paso concreto |
new_event | Nuevo evento de ejecución (ver los tipos de evento más abajo) |
artifact_found | Generación de un nuevo archivo de artefacto |
user_interaction_request | Un paso solicita entrada manual; en la página de conversación aparecerá un cuadro de respuesta |
Lista de tipos de eventos
El flujo de eventos de cada paso distingue el tipo de evento con el campo type. Los tipos habituales, listados por familia:
| tipo de evento | significado |
|---|---|
agent_starting / agent_completed / agent_failed | El ciclo de vida de un paso de Agent |
llm_call_starting / llm_call_completed | Una llamada al LLM; el evento completed lleva el recuento de tokens de esa llamada |
llm_streaming_starting / llm_streaming_completed / llm_streaming_failed | Salida en streaming del LLM |
tool_call_starting / tool_call_completed / tool_call_failed | Llamada a herramienta del Agent, con los parámetros y el resumen del resultado |
external_message / im_message / telegram_message | Envío y recepción de mensajes en los canales de IM |
group_chat_started / group_chat_message / group_chat_summarizing / group_chat_completed | El proceso de debate multi-Agent del paso group_chat |
state_machine_started / state_machine_transition / state_machine_state_completed | La transición de estados del paso state_machine |
agent_based_started / agent_based_completed | El proceso de delegación del paso de orquestación agent_based |
user_interaction_request / user_interaction_message / user_interaction_timeout | Preguntar al usuario durante la ejecución, recibir la respuesta, esperar con timeout |
claude_code_* | Eventos de progreso en streaming del runtime de Claude Code |
El evento lleva además un campo category (agent / llm / tool / message / strategy / user_interaction), y el filtro por categoría de la página de conversación se agrupa por él.
Filtros de la vista de conversación
- Búsqueda por palabra clave — busca en el contenido del mensaje y en el emisor
- Filtrar por Agent — ver solo los mensajes de un Agent o paso concreto
- Filtro por categoría — Agent / LLM / herramienta / mensaje externo / estrategia / interacción
- Interruptor de desplazamiento automático — si se sigue hasta el final cuando llega un mensaje nuevo
Tokens y coste
- Los eventos relacionados con el LLM registran los tokens de input / output por cada uno, y la tarjeta de estado acumula y muestra en tiempo real los enviados / recibidos / total.
- Tras terminar la ejecución,
GET /api/executions/{executionId}/costestima el coste de esta ejecución según el precio del modelo utilizado, y devuelve el total y el detalle de cada paso. - El coste se estima a posteriori según el consumo de tokens; la plataforma no ofrece cotización previa a la ejecución.
Proceso de ejecución de exportación
El botón «Exportar» de la barra superior de la página de detalle o de la fila de la lista exporta una ejecución como un archivo JSON o YAML, cuyo contenido incluye el estado de la ejecución, el resultado, los indicadores de rendimiento, además de una instantánea de la definición del workflow y el código fuente YAML en el momento de la exportación. Los campos sensibles como contraseñas, API Key, direcciones de webhook, etc., se sustituyen automáticamente por [REDACTED]. El nombre del archivo tiene la forma execution-process-79621f70-completed.json.
La definición de workflow del export es la versión actual obtenida en el momento de exportar; si el workflow se ha modificado después de esta ejecución, puede diferir de la definición que había en el momento de la ejecución.
Panel de datos
La vista agregada entre ejecuciones está en Analíticas Panel: número total de ejecuciones, tasa de éxito, duración media, consumo total de tokens, más la tendencia de ejecuciones, la distribución de estados y el ranking de Top workflows, con rango de tiempo seleccionable de 24 horas / 7 días / 30 días.
Ubicación del error
Cuando una ejecución está FAILED, busque primero el paso rojo en la línea de tiempo y abra el detalle del paso: la información de error está en la pestaña «Salida» y los detalles del proceso en la pestaña «Eventos» (el stderr de los pasos de code también está aquí). Los pasos que se hayan reintentado muestran el número de reintentos.
La forma de tratar los errores habituales está en Solución de problemas.
Periodo de retención
Los registros de ejecución (estado, resultado, eventos, datos de rendimiento) y los archivos de artefactos se conservan por defecto 90 días, y al vencer los limpia la plataforma periódicamente; el plazo concreto depende de su plan o de la configuración del despliegue, y no se limpia mientras la ejecución siga en marcha.
Siguiente paso
- Depuración de puntos de interrupción — Úselo cuando "no pueda entender por qué corre así"
- Solución de problemas — Errores habituales y su forma de reparación
- Reanudación automática — Cómo tratar las ejecuciones en estado INTERRUPTED