Saltar al contenido principal

OpenObserve

Inicio rápido para configurar OpenObserve en Floutic.

Paso 1: Verificar que OpenObserve esté corriendo​

docker compose ps openobserve
docker compose logs openobserve | tail -20

Paso 2: Crear los Streams​

Los streams se crean automáticamente cuando se envía el primer log, pero puedes crearlos manualmente:

Opción A: Crear desde la UI (Recomendado)​

  1. Accede a OpenObserve: https://oo.haorp.es (o http://localhost:5080 en desarrollo)
  2. Inicia sesión con las credenciales de tu .env:
    • Email: El valor de OPENOBSERVE_USER
    • Password: El valor de OPENOBSERVE_PASSWORD
  3. Los streams se crearán automáticamente cuando llegue el primer log

Opción B: Diagnóstico completo (Recomendado)​

# Ejecutar diagnóstico completo desde Docker
docker compose exec backend python scripts/diagnose_openobserve.py

Este script verifica:

  • ✅ Conexión con OpenObserve
  • ✅ Autenticación (user/password o API key)
  • ✅ Envío de logs directo
  • ✅ Uso del módulo de observabilidad

Opción C: Test simple​

# Test simple de conexión
docker compose exec backend python scripts/test_openobserve.py

Paso 3: Generar datos de prueba​

Backend​

Para generar un error de prueba que se envíe a OpenObserve:

# Hacer una petición que cause un error (ej: endpoint inexistente)
curl http://localhost:18080/api/test-error-endpoint

O simplemente usa la aplicación normalmente - cualquier error se enviará automáticamente.

Frontend​

  1. Configurar SDK oficial de OpenObserve (recomendado):

    • Obtener el Client Token desde OpenObserve: Settings → API Keys → RUM Token
    • Añadir VITE_OPENOBSERVE_CLIENT_TOKEN al .env del frontend
    • Ver CONFIGURAR_SDK_OFICIAL.md para instrucciones detalladas

  2. Reconstruir el frontend:

    docker compose restart frontend

  3. Abre la aplicación en el navegador

  4. Abre la consola del navegador (F12)

  5. Verifica que veas estos mensajes:

    [OpenObserve SDK] ✅ SDK inicializado correctamente
    [OpenObserve SDK] 📊 Datos RUM se enviarán a: https://oo.haorp.es

  6. Los errores JavaScript, métricas RUM y logs se enviarán automáticamente

Paso 4: Verificar que los datos lleguen​

  1. Accede a OpenObserve: https://oo.haorp.es
  2. Ve a "Logs" o "Search"
  3. Selecciona el stream correspondiente:
    • backend-stream - Errores del backend
    • frontend-stream - Errores y métricas del frontend
    • jobs-stream - Logs de workers (si los usas)

Troubleshooting​

No veo datos en OpenObserve​

  1. Verifica la conexión (con autenticación):

    # Obtener credenciales del .env
    source .env 2>/dev/null || true

    # Probar con autenticación Basic
    docker compose exec backend bash -c 'curl -v http://openobserve:5080/api/default/health \
      -H "Authorization: Basic $(echo -n "${OPENOBSERVE_USER:-root@example.com}:${OPENOBSERVE_PASSWORD:-openobserve_pass123}" | base64)"'

    # O mejor, usa el script de diagnóstico:
    docker compose exec backend python scripts/diagnose_openobserve.py

  2. Verifica las credenciales:

    # Revisa que las variables estén en el .env
    grep OPENOBSERVE .env

  3. Revisa los logs del backend:

    docker compose logs backend | grep -i openobserve

  4. Prueba el script de test:

    docker compose exec backend python scripts/test_openobserve.py

Los streams no aparecen​

  • Los streams se crean automáticamente al recibir el primer log
  • Si no aparecen, verifica que:
    • El backend pueda alcanzar OpenObserve
    • Las credenciales sean correctas
    • No haya errores en los logs del backend

Errores de autenticación​

  • Verifica que OPENOBSERVE_USER y OPENOBSERVE_PASSWORD en tu .env coincidan con las credenciales de OpenObserve
  • Si cambiaste las credenciales después de iniciar OpenObserve, puede que necesites recrear el contenedor: 
    docker compose down openobserve
    rm -rf docker-volumes/openobserve/data
    docker compose up -d openobserve