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 的统计
相关推荐
间彧3 分钟前
Java泛型详解与项目实战
后端
间彧13 分钟前
PECS原则在Java集合框架中的具体实现有哪些?举例说明
后端
间彧15 分钟前
Java 泛型擦除详解和项目实战
后端
间彧19 分钟前
在自定义泛型类时,如何正确应用PECS原则来设计API?
后端
间彧20 分钟前
能否详细解释PECS原则及其在项目中的实际应用场景?
后端
武子康44 分钟前
大数据-132 Flink SQL 实战入门 | 3 分钟跑通 Table API + SQL 含 toChangelogStream 新写法
大数据·后端·flink
李辰洋1 小时前
go tools安装
开发语言·后端·golang
wanfeng_091 小时前
go lang
开发语言·后端·golang
绛洞花主敏明1 小时前
go build -tags的其他用法
开发语言·后端·golang
渣哥1 小时前
从代理到切面:Spring AOP 的本质与应用场景解析
javascript·后端·面试