在Solo-io Gloo中配置Envoy默认链路追踪

概述

在现代微服务架构中，分布式链路追踪是确保系统可观测性的重要组成部分。Solo-io Gloo作为API网关解决方案，集成了Envoy代理的分布式追踪能力，可以帮助开发者追踪请求在网关和分布式后端服务中的流转情况。

链路追踪基础概念

什么是分布式链路追踪？

分布式链路追踪是一种监控技术，用于记录请求在分布式系统中的流转路径。它通过以下核心概念实现：

1. Trace（追踪）：代表一个完整的请求流程，包含多个Span
2. Span（跨度）：代表请求在系统中的单个操作单元，如API调用或数据库查询
3. 父子关系：初始请求创建父Span，后续操作创建子Span

为什么需要链路追踪？

• 可视化请求流转路径
• 识别系统瓶颈和高延迟服务
• 分析服务间依赖关系
• 快速定位故障点

Gloo支持的追踪平台

Gloo通过Envoy支持以下主流分布式追踪平台：

1. Zipkin - 轻量级开源追踪系统
2. Jaeger - Uber开源的端到端分布式追踪系统
3. Datadog - 商业化的全栈可观测性平台

配置Zipkin链路追踪

准备工作

在本地Kind集群中部署Zipkin服务：

docker run --network=kind -itd --name zipkin -p 9411:9411 openzipkin/zipkin

验证Zipkin容器IP地址：

docker network inspect kind

配置追踪集群

有两种方式配置Zipkin追踪集群：

方式1：通过Gloo Gateway Helm安装

创建values.yaml文件：

gatewayProxies: 
  gatewayProxy:
    tracing:
      cluster:
        - name: zipkin
          connect_timeout: 1s
          type: STRICT_DNS
          load_assignment:
            cluster_name: zipkin
            endpoints:
            - lb_endpoints:
              - endpoint:
                  address:
                    socket_address:
                      address: <zipkin_container_IP_address>
                      port_value: 9411

安装Gloo：

helm install gloo gloo/gloo --namespace gloo-system --create-namespace -f values.yaml

方式2：直接修改Envoy配置

编辑ConfigMap：

kubectl edit configmap -n gloo-system gateway-proxy-envoy-config

添加Zipkin集群配置：

static_resources:
  clusters:
    - name: zipkin
      connect_timeout: 1s
      type: STRICT_DNS
      load_assignment:
        cluster_name: zipkin
        endpoints:
        - lb_endpoints:
          - endpoint:
              address:
                socket_address:
                  address: <zipkin_container_IP_address>
                  port_value: 9411

重启Envoy代理：

kubectl rollout restart deployment gateway-proxy

配置监听器追踪提供者

动态监听器配置（推荐）

通过Gloo Gateway配置监听器级别的追踪：

listeners:
  - name: http_listener
    tracing:
      provider:
        name: envoy.tracers.zipkin
        typed_config:
          "@type": "type.googleapis.com/envoy.config.trace.v3.ZipkinConfig"
          collector_cluster: zipkin
          collector_endpoint: "/api/v2/spans"
          collector_endpoint_version: HTTP_JSON

静态监听器配置

直接修改Envoy配置：

listeners:
  - name: http_listener
    filter_chains:
      - filters:
          - name: envoy.filters.network.http_connection_manager
            typed_config:
              "@type": type.googleapis.com/envoy.extensions.filters.network.http_connection_manager.v3.HttpConnectionManager
              tracing:
                provider:
                  name: envoy.tracers.zipkin
                  typed_config:
                    "@type": "type.googleapis.com/envoy.config.trace.v3.ZipkinConfig"
                    collector_cluster: zipkin
                    collector_endpoint: "/api/v2/spans"
                    collector_endpoint_version: HTTP_JSON

路由注解（可选）

为虚拟服务添加路由描述符：

routes:
  - matchers:
    - exact: /abc
    routeAction:
      single:
        upstream:
          name: my-upstream
          namespace: gloo-system
    options:
      tracing:
        routeDescriptor: "my_route_description"

验证追踪

1. 发送测试请求：

curl localhost:31500/abc

2. 访问Zipkin UI查看追踪数据（默认地址：http://localhost:9411）

最佳实践

1. 生产环境建议：本地Zipkin仅适合开发和测试，生产环境应使用持久化存储
2. 采样率控制：高流量环境应配置适当的采样率以避免性能影响
3. 标签标准化：为Span添加一致的业务标签便于分析
4. 错误追踪：特别关注错误和异常Span

总结

通过本文，我们学习了如何在Solo-io Gloo中配置Envoy的默认链路追踪功能。从基础概念到实际操作步骤，涵盖了Zipkin的完整集成过程。这种配置方式同样适用于其他支持的追踪平台，只需调整相应的配置参数即可。

链路追踪是微服务可观测性的重要支柱，合理配置和使用可以帮助团队快速定位问题、优化系统性能，是现代化微服务架构不可或缺的工具。