使用 Grafana 实现可观测性

演示

参考实现

Grafana 可观测性的参考实现位于 otel/grafana/ 目录中：包括 OpenTelemetry Collector 配置（otel-config.yml）、Prometheus 抓取配置（prometheus.yml）、Tempo 追踪存储配置（tempo.yml）以及 Grafana 数据源配置（datasources.yml）。

这些设置由 compose-grafana.yml 文件使用，它会连同完整的技术栈一起启动应用——OpenTelemetry Collector（OTLP 端口为 :4317/:4318）、Prometheus、Tempo、Loki 和 Grafana。

运行它并打开仪表盘（参见运行应用）：

docker compose -f compose-grafana.yml up --build

• Grafana UI：http://localhost:3000——默认凭据为 admin / admin
• 应用的 API：http://localhost:18000/docs

重点关注：每个请求的 HTTP span、嵌套的 LangChain LLM 调用及其 token 用量、SQLAlchemy 语句，以及 Loki 中的应用日志。哪些内容会被插桩以及为什么，请参阅可观测性指南。

注意：此实现仅作参考。在真实的生产场景中，请考虑隐私与安全设置——认证、授权和加密。