tempo

Grafana Tempo 分布式追踪后端

补充说明

Grafana Tempo 是低成本分布式追踪后端，接收 OTLP/Jaeger/Zipkin 数据，按 trace ID 存储到对象存储，配合 Grafana 查询。

常用示例

tempo -config.file=/etc/tempo/tempo.yaml
tempo -config.file=/etc/tempo/tempo.yaml -target=all
tempo-cli --help

配置要点：

server:
  http_listen_port: 3200

distributor:
  receivers:
    otlp:
      protocols:
        grpc:
          endpoint: 0.0.0.0:4317
        http:
          endpoint: 0.0.0.0:4318

storage:
  trace:
    backend: s3
    s3:
      bucket: tempo-traces
      endpoint: s3.example.com

易错点与排错

• OTLP gRPC/HTTP 端口不同；客户端协议要和 receiver 匹配。
• 对象存储凭据、bucket 和区域配置错误会导致写入失败。
• 采样策略决定成本；全量采集可能非常贵。
• trace 查询需要 trace ID 或后端索引；不要期望全文搜索。
• 多租户要配置 X-Scope-OrgID 和认证。
• 保留期和 block 清理要配置，避免对象存储无限增长。
• Grafana 数据源 URL 和认证要指向正确 Tempo 实例。

相关命令

• tempo — 追踪后端
• grafana — 查询与可视化
• otel-cli — 链路埋点