Ir al contenido

Logs de ejecución

Cada ejecución genera logs: un registro cronológico de lo que el bot fue haciendo. Son tu principal herramienta para entender una ejecución y, sobre todo, para diagnosticar por qué algo falló. Como el bot suele ejecutarse desatendido y sin que nadie lo mire, los logs son tu ventana a lo que ocurrió.

Hay dos fuentes:

  • Mensajes que tú emites con la actividad Log en el playbook. Son los más valiosos para diagnosticar, porque tú decides qué contar (“10 facturas leídas”, “cliente sin correo, se omite”). Ver Depuración › Niveles de log.
  • Mensajes del sistema: inicio y fin de la ejecución, errores no controlados y la actividad/playbook en curso.

Cada línea identifica el playbook y el momento, de modo que puedes seguir el hilo aunque la automatización invoque sub-playbooks.

  1. Entra al entorno y abre la pestaña Ejecuciones.
  2. Haz clic en la ejecución que quieres revisar (o en su ícono de logs).
  3. Los logs aparecen ordenados cronológicamente, del primero al último.

detalle de una ejecución con la lista de logs coloreados por nivel.

Cada mensaje tiene un nivel que indica su importancia. En el portal se distinguen por color:

NivelColorPara qué
debugGrisDetalle fino para diagnóstico
infoBlancoEventos normales del proceso
warningNaranjaSituaciones inesperadas que no detienen el proceso
errorRojoErrores que afectan el resultado

Si la ejecución está en estado running, los logs se muestran en vivo, a medida que el agente los envía, sin que tengas que refrescar la página. Así puedes seguir una ejecución larga paso a paso mientras ocurre.

La calidad de tus logs depende de cuánto los cuides al diseñar. Un playbook que solo registra el error final es difícil de diagnosticar; uno que deja huellas en los puntos clave se depura en minutos:

  • Un info después de leer datos: “15 registros cargados desde el Excel”.
  • Un info antes de una acción crítica: “Enviando formulario de la factura FAC-021”.
  • Un warn en los caminos alternativos: “El cliente 304 no tiene correo; se omite el envío”.
  • Un error dentro de un catch: “No se pudo abrir el ERP: ” + error (la variable de error de un Try / Catch contiene el mensaje como texto).

Estos mismos mensajes los ves primero en el panel de depuración del Designer cuando pruebas localmente, y luego aquí, en producción.