Actualizado el Aug 4, 2026

Monitoreo de Ejecución

Lo que aprenderás

• Cómo acceder al historial de ejecución del workflow desde el icono de historial (reloj)
• Cómo leer los registros de ejecución y verificar el estado de éxito o fallo
• Cómo la configuración del nivel de registro afecta los logs de ejecución de la empresa (vista Logs)
• Cómo solucionar problemas en ejecuciones de workflow fallidas

El monitoreo de ejecución te permite rastrear cada vez que un workflow se ejecuta y ver si tuvo éxito o falló. Úsalo para verificar que tus workflows están funcionando y para diagnosticar problemas cuando algo sale mal.

Acceder al historial de ejecución

Para ver el historial de ejecución de tus workflows:

1. Navega a Automatizaciones > Workflows en la barra lateral para abrir la página de lista de workflows.
2. Haz clic en el icono de historial (reloj) en la parte superior de la página de lista.

Esto abre la vista de historial de ejecución, que muestra un registro de todas las ejecuciones pasadas de los workflows. Cada entrada del historial incluye cuándo se ejecutó el workflow, cuál fue y si la ejecución fue exitosa.

Qué muestran los registros de ejecución

Cada registro de ejecución resume una ejecución:

• Timestamp -- La fecha y hora en que se ejecutó el workflow
• Nombre del workflow -- Qué workflow se ejecutó
• Estado -- running, success, error o skipped
• Metadatos del trigger -- El tipo de trigger y, para los triggers hook, el model y la operación que lo dispararon
• Resultado -- El campo ok más el mensaje error o skipReason cuando la ejecución falló o se omitió

El registro no almacena el resultado de cada paso individual; captura el resultado general de la ejecución. Para ver el resultado de cada paso individual -- estado por paso, timestamps y safeError -- abre la vista Logs del workflow (ver más abajo) o el panel de depuración; ese detalle vive en los logs de ejecución de la empresa (log_entries), no en el registro del historial de ejecución.

Cómo el nivel de registro afecta los logs de ejecución

La configuración de Nivel de registro en cada workflow controla cuánto detalle se escribe en los logs de ejecución de la empresa (log_entries) -- los registros verbosos, paso a paso, que abres desde el botón Logs del workflow. No cambia los registros del historial de ejecución que muestra el icono de historial (reloj): esos solo llevan un estado agregado y se escriben igual, sin importar el nivel de registro.

• Los niveles de registro más altos escriben información más detallada, paso a paso, en la vista Logs, incluyendo valores de entrada, valores de salida y datos intermedios. Esto es muy útil durante el desarrollo y las pruebas.
• Los niveles de registro más bajos escriben solo información esencial, como el estado de éxito/fallo. Esto reduce el ruido y el almacenamiento una vez que el workflow está estable y en producción.

tip

Establece el nivel de registro en una configuración más alta (más verbosa) mientras construyes y pruebas un nuevo workflow, y luego redúcelo una vez que el workflow se ejecute de manera confiable, para mantener la vista Logs limpia y manejable.

Solucionar problemas en ejecuciones fallidas

Cuando la ejecución de un workflow falla, sigue estos pasos para identificar y corregir el problema:

1. Abre el historial de ejecución desde el icono de historial (reloj) en la página de lista de workflows.
2. Encuentra la ejecución fallida en la lista. Las ejecuciones fallidas están marcadas con un estado de error.
3. Abre la vista Logs para encontrar qué paso falló. El registro del historial de ejecución solo muestra el estado general y un único mensaje error -- no tiene un desglose por paso. Para identificar el paso que falló, abre la vista Logs del workflow (o el panel de depuración), que lista los log_entries por paso (estado, timestamps y executionContext.safeError) de la ejecución.
4. Revisa los detalles del error. Según el nivel de registro, el registro puede incluir mensajes de error, los datos que se pasaron al paso y metadatos compartidos de ejecución como executionContext.status, timestamps y executionContext.safeError.
5. Corrige el problema en el workflow. Algunos problemas comunes son:
   • Expresiones CEL en los campos de un paso que referencian datos no disponibles (por ejemplo, un campo contact vacío en esta ejecución)
   • Campos obligatorios faltantes en la configuración de un paso
   • Servicios externos (webhooks) que no están disponibles o que devuelven errores
   • Formatos de datos inválidos pasados entre pasos
6. Vuelve a probar el workflow después de aplicar tu corrección (el workflow debe estar habilitado para las ejecuciones bajo demanda). Para los workflows manuales y temporales, usa el botón Ejecutar. Para los workflows hook, activa de nuevo el evento relevante. Para los workflows temporales no tienes que esperar a la próxima ejecución programada -- el mismo botón Ejecutar funciona bajo demanda -- aunque también puedes esperarla o ajustar el cronograma.

Mejores prácticas para el monitoreo

• Revisa el historial de ejecución con regularidad durante los primeros días después de activar un nuevo workflow. La detección temprana de problemas evita que se acumulen.
• Usa el botón Iniciar depuración en la sección Pasos del formulario del workflow para probar tu workflow antes de activarlo. Ten en cuenta que ejecuta cada paso de forma real (se realizan llamadas HTTP, escrituras y mensajes) -- no es una simulación -- así que apúntalo a objetivos seguros o de prueba mientras depuras.
• Ajusta los niveles de registro según sea necesario. Aumenta la verbosidad al solucionar un problema específico y luego redúcela una vez que el problema esté resuelto.
• Revisa la lista de workflows periódicamente para asegurarte de que todos los workflows habilitados se ejecutan como se espera, usando las herramientas de filtro e historial de la página de lista.

Los metadatos de ejecución que se muestran en la interfaz están sanitizados para una depuración segura. Están pensados para ayudarte a entender qué falló sin exponer stack traces crudos, secretos o payloads de proveedores.

info

El icono de historial (reloj) en la página de lista de workflows muestra las ejecuciones de todos los workflows en un solo lugar. Esto facilita detectar patrones, como un workflow que falla cada vez que se ejecuta, o uno que no se ha ejecutado en mucho tiempo.

Próximos pasos

• Crear un workflow
• Tipos de trigger
• Entradas del workflow