Envoy Gateway 中基于 Zipkin 的分布式追踪配置详解-优快云博客

本文链接：https://blog.youkuaiyun.com/gitblog_00614/article/details/148940304

Envoy Gateway 中基于 Zipkin 的分布式追踪配置详解

gateway Manages Envoy Proxy as a Standalone or Kubernetes-based Application Gateway 项目地址: https://gitcode.com/gh_mirrors/gate/gateway

前言

在现代微服务架构中，分布式追踪是理解系统行为和诊断问题的重要工具。Envoy Gateway 作为 Kubernetes 中的 API 网关解决方案，提供了强大的分布式追踪支持。本文将深入解析如何在 Envoy Gateway 中配置 Zipkin 作为分布式追踪后端。

核心概念解析

1. Envoy Gateway 的追踪架构

Envoy Gateway 通过 Envoy 代理实现了请求追踪功能，支持将追踪数据发送到多种后端系统。追踪数据可以帮助开发者：

可视化请求在系统中的流转路径
分析服务间的调用关系
定位性能瓶颈
诊断跨服务的问题

2. Zipkin 简介

Zipkin 是一个开源的分布式追踪系统，它可以帮助收集服务架构中的时序数据，解决微服务架构中的延迟问题。Envoy Gateway 原生支持将追踪数据发送到 Zipkin 收集器。

配置详解

1. GatewayClass 配置

apiVersion: gateway.networking.k8s.io/v1
kind: GatewayClass
metadata:
  name: eg
spec:
  controllerName: gateway.envoyproxy.io/gatewayclass-controller
  parametersRef:
    group: gateway.envoyproxy.io
    kind: EnvoyProxy
    name: zipkin-tracing
    namespace: envoy-gateway-system

这部分定义了 GatewayClass 资源，关键点在于：

controllerName 指定了由 Envoy Gateway 控制器管理这个 GatewayClass
parametersRef 引用了名为 zipkin-tracing 的 EnvoyProxy 自定义资源，该资源包含了具体的追踪配置

2. EnvoyProxy 自定义资源

apiVersion: gateway.envoyproxy.io/v1alpha1
kind: EnvoyProxy
metadata:
  name: zipkin-tracing
  namespace: envoy-gateway-system
spec:
  telemetry:
    tracing:
      samplingRate: 100
      provider:
        host: otel-collector.monitoring.svc.cluster.local
        port: 9411
        type: Zipkin
        zipkin:
          enable128BitTraceId: true
      customTags:
        key1:
          type: Literal
          literal:
            value: "val1"
        env1:
          type: Environment
          environment:
            name: ENV1
            defaultValue: "-"
        header1:
          type: RequestHeader
          requestHeader:
            name: X-Header-1
            defaultValue: "-"

这部分是核心配置，我们逐层解析：

采样率配置

samplingRate: 100 表示对所有请求进行采样（100%采样）。在生产环境中，通常需要根据流量大小调整这个值，避免给追踪系统带来过大压力。

追踪提供者配置

provider:
  host: otel-collector.monitoring.svc.cluster.local
  port: 9411
  type: Zipkin
  zipkin:
    enable128BitTraceId: true

host 和 port 指定了 Zipkin 收集器的地址
type: Zipkin 明确使用 Zipkin 协议
enable128BitTraceId 启用 128 位的 Trace ID，提供更大的 ID 空间，减少冲突概率

自定义标签

Envoy Gateway 允许为追踪数据添加自定义标签，这些标签可以帮助后续的分析和过滤：

customTags:
  key1:
    type: Literal
    literal:
      value: "val1"
  env1:
    type: Environment
    environment:
      name: ENV1
      defaultValue: "-"
  header1:
    type: RequestHeader
    requestHeader:
      name: X-Header-1
      defaultValue: "-"

支持三种类型的标签：