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 usa 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 dashboards (consulta Ejecución de la aplicación):
docker compose -f compose-grafana.yml up --build- Interfaz de Grafana: http://localhost:3000; credenciales predeterminadas:
admin/admin - La API de la aplicación: http://localhost:18000/docs
Qué observar: los spans HTTP por solicitud, las llamadas anidadas a LLM de LangChain con el uso de tokens, las sentencias de SQLAlchemy y los 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. Para un escenario real de producción, ten en cuenta la configuración de privacidad y seguridad: autenticación, autorización y cifrado.