Saltar al contenido principal

Monitoreo de Ejecucion

Lo que aprenderas
  • Como acceder al historial de ejecucion del workflow usando el boton workflow_history
  • Como leer los logs de ejecucion y verificar el estado de exito o fallo
  • Como la configuracion de nivel de log afecta el detalle de los registros de ejecucion
  • Como solucionar problemas en ejecuciones de workflow fallidas

El monitoreo de ejecucion te permite rastrear cada vez que un workflow se ejecuta, ver si tuvo exito o fallo, e inspeccionar los detalles de cada paso. Esto es esencial para verificar que tus workflows estan funcionando correctamente y para diagnosticar problemas cuando algo sale mal.

Acceder al historial de ejecucion​

Para ver el historial de ejecucion de tus workflows:

  1. Navega a Automatizaciones > Workflows en la barra lateral para abrir la pagina de lista de workflows.
  2. Haz clic en el boton workflow_history en la parte superior de la pagina de lista.

Esto abre la vista de historial de ejecucion, que muestra un registro de todas las ejecuciones pasadas de workflows. Cada entrada en el historial incluye informacion sobre cuando se ejecuto el workflow, cual workflow fue y si la ejecucion fue exitosa.

Que muestran los registros de ejecucion​

Cada registro de ejecucion en el historial tipicamente incluye:

  • Timestamp -- La fecha y hora exacta en que se ejecuto el workflow
  • Nombre del workflow -- Que workflow se ejecuto
  • Estado -- Si la ejecucion se completo exitosamente, fallo o aun esta en progreso
  • Datos del trigger -- Que evento o condicion inicio el workflow
  • Resultados paso a paso -- El resultado de cada paso individual en el workflow, incluyendo estado de ejecucion, timestamps y detalles de error sanitizados cuando estan disponibles

Como el nivel de log afecta el detalle de la ejecucion​

La configuracion de Log Level en cada workflow controla cuanta informacion se captura en los registros de ejecucion. Esto se configura en el formulario del workflow cuando creas o editas un workflow.

  • Niveles de log mas altos capturan informacion mas detallada sobre cada paso, incluyendo valores de entrada, valores de salida y datos intermedios. Esto es muy util durante el desarrollo y las pruebas.
  • Niveles de log mas bajos capturan solo informacion esencial como estado de exito/fallo. Esto reduce el ruido y el almacenamiento cuando el workflow esta estable y en produccion.
tip

Establece el nivel de log en una configuracion mas alta (mas verbosa) mientras construyes y pruebas un nuevo workflow. Una vez que el workflow se ejecute de manera confiable, reduce el nivel de log para mantener tu historial de ejecucion limpio y manejable.

Solucionar problemas en ejecuciones fallidas​

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

  1. Abre el historial de ejecucion haciendo clic en el boton workflow_history en la pagina de lista de workflows.
  2. Encuentra la ejecucion fallida en la lista. Las ejecuciones fallidas tipicamente estan marcadas con un indicador de estado de fallo.
  3. Inspecciona los resultados de los pasos para encontrar que paso fallo. El registro de ejecucion muestra el resultado de cada paso en secuencia, para que puedas identificar exactamente donde ocurrio el fallo.
  4. Revisa los detalles del error. Dependiendo del nivel de log, el registro puede incluir mensajes de error, los datos que se pasaron al paso y metadatos compartidos de ejecucion como executionContext.status, timestamps y executionContext.safeError.
  5. Corrige el problema en el workflow. Problemas comunes incluyen:
    • Nombres de placeholder {{variable}} incorrectos que no coinciden con los datos disponibles
    • Campos obligatorios faltantes en la configuracion de un paso
    • Servicios externos (webhooks) que estan no disponibles o devolviendo errores
    • Formatos de datos invalidos pasados entre pasos
  6. Vuelve a probar el workflow despues de hacer la correccion. Para workflows manuales, usa el boton executeManual. Para workflows hook, activa el evento relevante de nuevo. Para workflows temporales, espera a la proxima ejecucion programada o ajusta el cronograma.

Mejores practicas para monitoreo​

  • Revisa el historial de ejecucion regularmente durante los primeros dias despues de activar un nuevo workflow. La deteccion temprana de problemas evita que se acumulen.
  • Usa el boton Debug all en la seccion Pasos del formulario del workflow para probar tu workflow antes de activarlo. Esto detecta muchos problemas antes de que aparezcan en produccion.
  • Ajusta los niveles de log segun sea necesario. Aumenta la verbosidad al solucionar un problema especifico, luego reducela una vez que el problema este resuelto.
  • Revisa la lista de workflows periodicamente para asegurar que todos los workflows habilitados se ejecutan como se espera, usando las herramientas de filtro e historial en la pagina de lista.

Los metadatos de ejecucion mostrados en la interfaz estan sanitizados para depuracion segura. Estan destinados a ayudarte a entender que fallo sin exponer stack traces crudos, secretos o payloads de proveedores.

info

El boton workflow_history en la pagina de lista de workflows proporciona una vista centralizada de todas las ejecuciones de todos los workflows. Esto facilita detectar patrones, como un workflow que falla cada vez que se ejecuta, o uno que no se ha ejecutado en mucho tiempo.

Proximos pasos​