后端可观测性#
Chroma 通过 OpenTelemetry 钩子实现了可观测性。
遥测 vs 可观测性
"遥测" 指的是我们收集的匿名产品使用统计数据。"可观测性" 指的是指标、日志和追踪,这些可以被任何操作 Chroma 部署的人使用。本页列出的可观测性功能绝不会发送回 Chroma;它们是为了让终端用户更好地理解他们的 Chroma 部署的行为。
可用的可观测性#
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 Collector 和 Zipkin 组成。
要启动堆栈,请从仓库的根目录运行:
堆栈启动后,你可以在 http://localhost:9411 访问 Zipkin
追踪
在向 Chroma 发出请求后,Zipkin 中将开始出现追踪。
客户端 (SDK) 可观测性#
参见