Chroma 教程 收藏

可观测性

🎉摘要:本文介绍如何配置 Chroma 内置的 OpenTelemetry 埋点,通过 OTEL Collector 转发 trace 到 Zipkin,实现分布式链路追踪和监控。包含完整的 docker-compose 示例和配置文件。

Chroma 内置了 OpenTelemetry 的埋点,配置 endpoint 之后就能把 trace 打出去。实现通过看板,如 Grafana 进行监控。

最小的 compose 栈(Chroma + OTEL Collector + Zipkin)

OTEL Collector

OTEL Collector 是 OpenTelemetry 生态里独立的遥测数据网关 / 代理服务,是整个可观测链路里的中转核心。

OTEL Collector 统一接收、处理、转发 Trace(链路)、Metrics(指标)、Logs(日志),上游业务不用直接对接 Jaeger/Zipkin/Prometheus/Loki 等后端。

注意: OTEL Collector 不是存储,本身不持久化链路 / 指标,只做转发;存储是 Zipkin / Prometheus / Loki 的事 。

Zipkin

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 指过去即可。

说说我的看法
全部评论()
没有评论
关于
本网站专注于 Java、数据库(MySQL、Oracle)、Linux、软件架构及大数据等多领域技术知识分享。涵盖丰富的原创与精选技术文章,助力技术传播与交流。无论是技术新手渴望入门,还是资深开发者寻求进阶,这里都能为您提供深度见解与实用经验,让复杂编码变得轻松易懂,携手共赴技术提升新高度。如有侵权,请来信告知:hxstrive@outlook.com
其他应用
公众号