Easegress分布式追踪实践指南：从基础配置到云服务集成-优快云博客

本文链接：https://blog.youkuaiyun.com/gitblog_01089/article/details/148488847

Easegress分布式追踪实践指南：从基础配置到云服务集成

easegress A Cloud Native traffic orchestration system 项目地址: https://gitcode.com/gh_mirrors/eas/easegress

前言

在现代微服务架构中，分布式追踪已成为不可或缺的监控手段。本文将深入探讨Easegress基于OpenTelemetry实现的分布式追踪功能，帮助开发者构建完整的请求链路可视化方案。

分布式追踪基础配置

Easegress的追踪功能通过OpenTelemetry实现，支持在各类流量网关（如HTTPServer）中启用。以下是一个基础配置示例：

kind: HTTPServer
name: http-server-example
port: 10080
tracing:
  serviceName: httpServerExample  # 服务标识名称
  sampleRate: 1                  # 采样率(0-1)
  exporter:
    zipkin:
      endpoint: http://localhost:9412/api/v2/spans
rules:
  - paths:
    - pathPrefix: /pipeline
      backend: pipeline-example

关键配置项说明：

serviceName：定义服务在追踪系统中的显示名称
sampleRate：设置采样率，1表示100%采样
exporter：配置数据导出方式

自定义追踪属性增强

为便于后续的查询和分析，我们可以为追踪数据添加自定义属性：

tracing:
  serviceName: httpServerExample
  attributes:                      # 自定义属性段
    environment: production        # 环境标识
    version: v1.2.3                # 服务版本
    region: us-west-1              # 部署区域
  sampleRate: 1
  exporter:
    zipkin:
      endpoint: http://localhost:9412/api/v2/spans

这些属性将附加到所有相关Span上，在追踪系统中可以用于：

按环境过滤请求
版本对比分析
区域性能监控

多后端导出配置

Easegress支持同时将追踪数据导出到多个后端系统：

tracing:
  serviceName: httpServerExample
  sampleRate: 1
  exporter:
    zipkin:
      endpoint: http://localhost:9412/api/v2/spans
    jaeger:
      mode: agent                  # 支持agent/collector两种模式
      endpoint: localhost:6831     # Jaeger agent地址
    otlp:
      protocol: grpc               # 支持grpc/http协议
      endpoint: localhost:4317     # OTLP接收端
      insecure: true               # 是否启用TLS

各导出器特点：

Zipkin：经典追踪系统，部署简单
Jaeger：功能丰富，支持多种分析视图
OTLP：OpenTelemetry原生协议，可对接Collector

与CDN服务的集成实践

当服务部署在CDN后，我们可以实现完整的边缘到服务端的追踪链路：

自动集成功能

Easegress会自动识别CDN的头信息
在HTTPServer的Span中自动添加cdn.ray标签

完整链路追踪配置

CDN端配置：
- 进入CDN控制台
- 创建修改请求头的规则
- 添加两个时间戳头：
  - x-ts-msec：http.request.timestamp.msec
  - x-ts-sec：http.request.timestamp.sec
效果验证：
- 请求将显示完整的CDN边缘到后端服务的延迟分布
- 可分析CDN加速效果和源站处理时间

版本兼容性说明

新版Easegress对追踪配置进行了标准化，旧版配置需要做如下调整：

# 废弃的配置方式
tracing:
  zipkin:
    hostport: 0.0.0.0:10080  # 不再需要
    sameSpan: true           # 不再支持
    id128Bit: false          # 不再支持

# 新版推荐配置
tracing:
  exporter:
    zipkin:
      endpoint: http://localhost:9412/api/v2/spans

主要变更点：