---

title: OpenTelemetry 分布式追踪与指标采集实践

keywords:

• OpenTelemetry
• OTLP
• 采样
• 资源标签
• Collector

description: 通过 OpenTelemetry 采集追踪与指标，提供标准 Collector 配置与环境变量示例，覆盖采样与资源标注。

categories:

• 文章资讯
• 编程技术

---

OpenTelemetry 分布式追踪与指标采集实践

环境变量

OTEL_SERVICE_NAME=web
OTEL_EXPORTER_OTLP_ENDPOINT=http://localhost:4318
OTEL_RESOURCE_ATTRIBUTES=env=prod,region=ap-south-1

Collector 配置示例

receivers:
  otlp:
    protocols:
      http:
exporters:
  logging:
    loglevel: info
processors:
  batch: {}
service:
  pipelines:
    traces:
      receivers: [otlp]
      processors: [batch]
      exporters: [logging]
    metrics:
      receivers: [otlp]
      processors: [batch]
      exporters: [logging]

采样与资源

• 在 SDK 层设置比例采样（如 0.1）以控制开销
• 使用 OTEL_RESOURCE_ATTRIBUTES 为服务与区域等打标签

验证

• 通过 Collector 日志观察接收与导出
• 使用查看端（如 Tempo/Jaeger）确认 TraceId 串联正确

总结

规范的采样与资源标注配合 Collector，能快速落地追踪与指标采集并便于扩展。