Consola
Visualiza los logs del engine y de la aplicación en tiempo real, con filtros, categorías con código de color y opciones de exportación.
Esta es la página de “Logs”
En el sidebar del proyecto, esta vista aparece etiquetada como Logs (dentro del grupo Observe) y vive en la ruta /console. Para el seguimiento de errores a nivel de app en concreto, mira la página dedicada de Errores.
Visión General
La Consola te da una vista en vivo de los logs del engine de tu proyecto. Cada acción en tu proyecto — llamadas a endpoints, consultas a base de datos, eventos de auth, operaciones de IA — genera entradas de log que aparecen aquí en tiempo real.
La consola soporta streaming en vivo, varios modos de filtrado y opciones de exportación para ayudarte a depurar problemas y monitorizar tu aplicación en producción.
Modo en Vivo
Activa el Modo en vivo para habilitar el polling automático de logs. Cuando está activo, la consola hace auto-scroll para mostrar las últimas entradas según van llegando.
Puedes configurar el intervalo de polling según tus necesidades:
| Intervalo | Caso de uso |
|---|---|
2s | Depuración activa — máxima frecuencia de refresco |
4s | Por defecto — equilibrio entre rendimiento y frescura |
10s | Monitorización moderada — menor uso de recursos |
30s | Monitorización en segundo plano — overhead mínimo |
Pausa el modo en vivo para inspeccionar entradas concretas sin que la vista se desplace. Aparece un botón "ir al final" cuando haces scroll hacia arriba.
Filtrado
La consola ofrece dos dimensiones de filtrado que se pueden combinar:
Por Alcance
| Alcance | Muestra |
|---|---|
| User | Solo actividad disparada por usuarios (llamadas a endpoints, eventos de auth, operaciones de storage) |
| All | Salida de depuración completa, incluidos logs internos del engine, health checks y eventos del sistema |
Por Nivel de Log
| Filtro | Niveles mostrados |
|---|---|
| All | DEBUG, INFO, WARN, ERROR |
| Warnings + Errors | WARN, ERROR |
| Errors only | ERROR |
Categorías de Log
Cada entrada de log lleva una categoría y un código de color para identificarla visualmente al vuelo. Esto facilita escanear grandes volúmenes de logs y encontrar las entradas relevantes:
| Tag | Color | Fuente |
|---|---|---|
[ERROR] | Rojo | Errores de la aplicación y excepciones no controladas |
[WARN] | Amarillo | Avisos de deprecación, advertencias de cercanía a límites |
[ENDPOINT] | Azul | Ejecución de endpoints de API (método, ruta, estado) |
[WORKFLOW] | Morado | Pasos de ejecución de nodos del editor de flujos |
[AUTH] | Naranja | Login, logout, refresco de token, eventos de proveedores |
[AI] | Esmeralda | Llamadas a LLM, ejecución de agentes, uso de tools MCP |
[DATABASE] | Cielo | Consultas SQL, operaciones de tablas, migraciones |
[STORAGE] | Ámbar | Subidas, descargas y operaciones de buckets de archivos |
[HTTP] | Cian | Peticiones HTTP salientes (nodo HTTP Request, nodos de integración) |
[RATE_LIMIT] | Rojo | Eventos de rate limiting y peticiones limitadas |
[INFO] | Azul | Mensajes informativos generales |
[DEBUG] | Gris | Salida de depuración verbosa (solo en alcance All) |
Leer Entradas de Log
Cada entrada de log sigue un formato consistente:
[2024-03-15 14:32:01] [ENDPOINT] POST /api/users → 201 (45ms)
[2024-03-15 14:32:01] [DATABASE] INSERT INTO users (email, name) VALUES ($1, $2)
[2024-03-15 14:32:02] [AUTH] Token issued for user_id=abc123
[2024-03-15 14:32:05] [ERROR] Code node timeout after 30000ms
El formato incluye un timestamp, el tag de categoría y un mensaje descriptivo. Los logs de endpoint también incluyen el método HTTP, la ruta, el código de estado y el tiempo de ejecución.
Opciones de Exportación
La barra de herramientas de la consola ofrece varias acciones para trabajar con los logs:
| Acción | Descripción |
|---|---|
| Copy | Copia todos los logs visibles al portapapeles como texto plano |
| Download | Exporta los logs como archivo .txt con timestamps |
| Clear | Limpia todos los logs de la vista actual |
| Refresh | Trae manualmente los últimos logs del servidor |
Limpiar los logs solo los quita de tu vista actual. No borra el historial de logs del lado del servidor.
Múltiples Contenedores
Si tu proyecto corre en varios contenedores (p. ej. en un despliegue escalado), puedes elegir de qué contenedor ver los logs usando el selector de contenedor en la barra de herramientas. Esto es útil para depurar problemas que solo ocurren en instancias concretas.