Chroma 内置了 OpenTelemetry 的埋点,配置 endpoint 之后就能把 trace 打出去。实现通过看板,如 Grafana 进行监控。
OTEL Collector 是 OpenTelemetry 生态里独立的遥测数据网关 / 代理服务,是整个可观测链路里的中转核心。
OTEL Collector 统一接收、处理、转发 Trace(链路)、Metrics(指标)、Logs(日志),上游业务不用直接对接 Jaeger/Zipkin/Prometheus/Loki 等后端。
注意: OTEL Collector 不是存储,本身不持久化链路 / 指标,只做转发;存储是 Zipkin / Prometheus / Loki 的事 。
Zipkin 是一款轻量分布式追踪(Distributed Tracing)系统,由 Twitter 开源,专门用来收集、存储、展示调用链路(Trace)。
在本次的链路里,Zipkin 只负责存 Trace 和可视化,不接收 OTLP,依赖 OTEL Collector 做协议转换。
创建一个 chroma-data 目录,然后在 chroma-data 目录中创建 otel-collector-config.yaml 配置文件,内容如下:
receivers:
otlp:
protocols:
grpc:
endpoint: 0.0.0.0:4317
http:
endpoint: 0.0.0.0:4318
exporters:
debug:
zipkin:
endpoint: "http://zipkin:9411/api/v2/spans"
service:
pipelines:
traces:
receivers: [otlp]
exporters: [zipkin, debug]再创建 docker-compose.yml 文件,内容如下:
services:
zipkin:
image: openzipkin/zipkin
ports:
- "9411:9411"
depends_on: [otel-collector]
networks: [internal]
otel-collector:
image: otel/opentelemetry-collector-contrib:0.111.0
command: ["--config=/etc/otel-collector-config.yaml"]
volumes:
- ${PWD}/otel-collector-config.yaml:/etc/otel-collector-config.yaml
networks: [internal]
server:
image: chromadb/chroma
volumes:
- chroma_data:/data
ports:
- "8000:8000"
networks: [internal]
environment:
- CHROMA_OPEN_TELEMETRY__ENDPOINT=http://otel-collector:4317/
- CHROMA_OPEN_TELEMETRY__SERVICE_NAME=chroma
depends_on:
- otel-collector
- zipkin
networks:
internal:
volumes:
chroma_data:此时,chroma-data 目录内容如下:
root@localhost:~/chroma-data# ll
total 16
drwxr-xr-x 2 root root 4096 Nov 10 18:47 ./
drwx------ 18 root root 4096 Nov 10 18:47 ../
-rw-r--r-- 1 root root 754 Nov 10 18:47 docker-compose.yml
-rw-r--r-- 1 root root 291 Nov 10 18:46 otel-collector-config.yaml执行“docker compose up --build -d”命令创建容器,执行过程中会自动拉取镜像,创建并启动容器:
root@localhost:~/chroma-data# docker compose up --build -d
[+] up 19/19
✔ Image openzipkin/zipkin Pulled 665.8s
✔ Image otel/opentelemetry-collector-contrib:0.111.0 Pulled 32.9ss
✔ Network chroma-data_internal Created 0.0s
✔ Volume chroma-data_chroma_data Created 0.0s
✔ Container chroma-data-otel-collector-1 Started 0.5s
✔ Container chroma-data-zipkin-1 Started 0.5s
✔ Container chroma-data-server-1 Started 0.7如果你看到了类似上面的界面,说明容器服务创建成功,使用 curl 发起对 chroma 心跳接口调用 curl http://localhost:8000/api/v2/heartbeat,多试几次,生产点数据,方便 Zipkin 上面观察。
最后,使用浏览打开 Zipkin(http://localhost:9411)点 "Run Query" 就能看到 trace 了,如下图:

注意:Zipkin 只是演示,实际用 Jaeger、Grafana Tempo、或者云厂商的 APM 都行,把 CHROMA_OPEN_TELEMETRY__ENDPOINT 指过去即可。