Solo.io Gloo项目实战：使用请求转换功能增强访问日志

2025-06-12 13:08:39作者：曹令琨Iris

前言

在现代API网关解决方案中，访问日志是监控和故障排查的重要工具。Solo.io Gloo项目作为一款基于Envoy的云原生API网关，提供了强大的访问日志功能。本文将深入探讨如何利用Gloo的请求转换功能，为访问日志添加自定义属性，从而获得更丰富的监控数据。

基础概念理解

访问日志的核心价值

访问日志记录了每个请求的关键信息，包括：

请求方法（GET/POST等）
响应状态码
请求处理时间
请求路径
上游服务信息

这些数据对于API性能监控、异常请求分析和流量统计都至关重要。

Gloo的转换功能优势

Gloo的独特之处在于其强大的转换能力，允许我们：

从请求/响应体中提取数据
访问环境变量信息
将这些信息注入到动态元数据中
最终呈现在访问日志里

实战配置详解

初始环境准备

首先需要配置基础的上游服务和网关，这里我们使用Postman Echo服务作为示例上游。

基础访问日志配置

Gloo通过Gateway资源配置访问日志，关键配置项包括：

options:
  accessLoggingService:
    accessLog:
    - fileSink:
        jsonFormat:
          httpMethod: '%REQ(:METHOD)%'
          protocol: '%PROTOCOL%'
          responseCode: '%RESPONSE_CODE%'
          clientDuration: '%DURATION%'
          targetDuration: '%RESPONSE_DURATION%'
          path: '%REQ(X-ENVOY-ORIGINAL-PATH?:PATH)%'
          upstreamName: '%UPSTREAM_CLUSTER%'
          systemTime: '%START_TIME%'
          requestId: '%REQ(X-REQUEST-ID)%'
        path: /dev/stdout

这段配置定义了标准访问日志的JSON格式和输出位置。

添加自定义日志字段

我们需要在日志中添加两个特殊字段：

Pod名称：处理请求的Gateway代理Pod名称
端点URL：上游服务的实际请求URL

动态元数据配置原理

Gloo通过转换过滤器将自定义数据写入Envoy的动态元数据，然后在日志配置中通过DYNAMIC_METADATA指令引用这些数据。

具体实现步骤

更新Gateway配置：添加对新元数据的引用

pod_name: '%DYNAMIC_METADATA(io.solo.transformation:pod_name)%'
endpoint_url: '%DYNAMIC_METADATA(io.solo.transformation:endpoint_url)%'

配置Virtual Service：设置响应转换规则

options:
  transformations:
    responseTransformation:
      transformationTemplate:
        dynamicMetadataValues:
        - key: 'pod_name'
          value:
            text: '{{ env("POD_NAME") }}'
        - key: 'endpoint_url'
          value:
            text: '{{ url }}'

这段配置实现了：

从环境变量获取Pod名称
从响应JSON中提取url字段
将两者存入动态元数据

验证与结果分析

执行测试请求后，查看日志输出将包含新增字段：

{
  "path": "/get",
  "endpoint_url": "\"https://postman-echo.com/get\"",
  "pod_name": "\"gateway-proxy-f46b58f89-5fkmd\"",
  "responseCode": "200"
}