👀 可观测性

后端可观测性#

Chroma 通过 OpenTelemetry 钩子实现了可观测性。

可用的可观测性#

Chroma 目前仅导出 OpenTelemetry 的 追踪。追踪允许 Chroma 操作员理解请求如何流经系统,并快速识别瓶颈。

配置#

追踪通过四个环境变量进行配置:

  • CHROMA_OTEL_COLLECTION_ENDPOINT:发送可观测性数据的位置。示例:api.honeycomb.com
  • CHROMA_OTEL_SERVICE_NAME:OTel 追踪的服务名称。默认:chromadb
  • CHROMA_OTEL_COLLECTION_HEADERS:发送可观测性数据时使用的头信息。通常用于发送 API 和应用密钥。
  • CHROMA_OTEL_GRANULARITY:来自 OpenTelemetryGranularity 枚举 的值。指定追踪的详细程度。

本地可观测性堆栈 (🐳👀📚)#

Chroma 还附带了一个本地可观测性堆栈。该堆栈由 Chroma 服务器(你所熟知并 ❤️ 的)、OpenTelemetry CollectorZipkin 组成。

要启动堆栈,请从仓库的根目录运行:

Command Line

堆栈启动后,你可以在 http://localhost:9411 访问 Zipkin

客户端 (SDK) 可观测性#

参见