Demostración
Implementación de referencia
La implementación de referencia de la observabilidad con Grafana se encuentra en el
directorio otel/grafana/: la configuración del OpenTelemetry Collector
(otel-config.yml), la configuración de scraping de Prometheus (prometheus.yml), el almacenamiento
de trazas de Tempo (tempo.yml) y las fuentes de datos de Grafana (datasources.yml).
Estos ajustes los utiliza el archivo compose-grafana.yml, que inicia la
aplicación con el stack completo: OpenTelemetry Collector (OTLP en :4317/:4318),
Prometheus, Tempo, Loki y Grafana.
Ejecútalo y abre los paneles (consulta Ejecutar la aplicación):
docker compose -f compose-grafana.yml up --build- Interfaz de Grafana: http://localhost:3000; credenciales por defecto
admin/admin - La API de la aplicación: http://localhost:18000/docs
Qué observar: spans HTTP por petición, llamadas anidadas a LLM de LangChain con el uso de tokens, sentencias de SQLAlchemy y logs de la aplicación en Loki. Qué se instrumenta y por qué: la Guía de observabilidad.
Nota: esta implementación es solo una referencia. En un escenario de producción real, ten en cuenta la configuración de privacidad y seguridad: autenticación, autorización y cifrado.