golang 项目 OpenTelemetry 实践

golang 项目 OpenTelemetry 实践

本文整理了 OpenTelemetry 在项目中的 trace 和 metric 实践,涵盖 Golang 开发、Elastic APM 对接和阿里云可观测性平台的集成方式。

🧩 一、Trace 实践

1. Golang 接入方式

  • 使用 go.opentelemetry.io/otel 作为核心库。
  • HTTP 层使用 otelhttp 中间件自动注入 trace context。
  • 自定义 RPC 协议中,通过手动注入/提取 context 实现分布式追踪。
  • 对 grpc/http client 请求使用 otelhttp.NewTransport() 包装 trace。

Golang 官方文档 里面有完整的示例。

2. Elastic APM 对接

  • 使用 OTLP 导出器(HTTP 或 gRPC)将 trace 数据发送至 Elastic APM Server。
  • 设置 OTEL_EXPORTER_OTLP_ENDPOINT 指向 Elastic APM 的入口。
  • 配置 OTEL_EXPORTER_OTLP_HEADERS 头部进行鉴权。

Elastic APM 文档

3. 阿里云 可观测链路 OpenTelemetry版 对接

  • 开通阿里云的 OpenTelemetry 可观测服务
  • 会得到对应的 Endpoint 和 上报路径。例如 /adapt_@xxxxxxxxxxxx@xxxxxx/api/otlp/traces

📊 二、Metric 实践

1. 指标采集方式

  • 使用 go.opentelemetry.io/otel/metric,定义 Counter、Histogram 等。
  • 创建 MeterProvider 并配置 Prometheus 或 OTLP Exporter。
  • 示例指标:
    • api_login_request_duration_seconds_histogram
    • trans_latency_hist(每个 endpoint 的延迟分布)

2. 指标导出到 Elastic

  • 通过 Metricbeat 拉取 OTLP Collector 的 Prometheus Endpoint。

  • 使用标准命名如 _sum/_count/_bucket 配合 Histogram。

  • PromQL 示例:

    promql 复制代码
    rate(trans_latency_hist_sum[1m]) by (endpoint)
    /
    rate(trans_latency_hist_count[1m]) by (endpoint)

3. 指标导出到阿里云可观测链路 OpenTelemetry版

  • 通过 OTLP 上传至阿里云可观测平台。一样是配置阿里云平台提供的 Endpoint 和 上报接口。

🚧 三、问题与解决方案

  • 查询界面: 两种方式并不统一
  • meter Histogram:好多接收放都不支持 min/max 的统计
相关推荐
karry_k14 分钟前
CopyOnWriteArraySet
后端
spmcor15 分钟前
NestJS 统一响应格式最佳实践:标准化 API 返回结构
后端
SamsongSSS24 分钟前
Django之APPEND_SLASH配置爬坑
后端·python·django
EMQX41 分钟前
ESP32 + MCP over MQTT:基于大模型打造人格化情感智能体
后端
karry_k1 小时前
为什么CopyOnWriteArrayList是线程安全的?
后端
hello 早上好1 小时前
Spring Boot 核心启动机制与配置原理剖析
java·spring boot·后端
武子康1 小时前
大数据-112 Flink DataStream API :数据源、转换与输出 文件、Socket 到 Kafka 的完整流程
大数据·后端·flink
Terio_my3 小时前
Spring Boot 缓存技术
spring boot·后端·缓存
IT_陈寒3 小时前
Python 3.12 性能暴增50%!这5个新特性让老项目直接起飞
前端·人工智能·后端
你的人类朋友3 小时前
【操作系统】说说 x86 和 x64
后端·程序员·操作系统