如何通过 log_format 引入 $request_id 联通微服务架构的全链路日志追踪-Nginx-PHP中文网

nginx通过$request_id实现全链路日志追踪：自动或继承x-request-id头，proxy_set_header透传，log_format中嵌入该变量，并要求下游服务统一读取、记录和转发该id。

如何通过 log_format 引入 $request_id 联通微服务架构的全链路日志追踪

在微服务架构中，通过 log_format 在 Nginx 中注入 $request_id，是实现前端请求到后端服务全链路日志追踪的关键一环。它让一次用户请求在 Nginx、网关、业务服务、中间件等各环节产生的日志，都能通过同一个唯一 ID 关联起来。

确保 $request_id 在请求生命周期中稳定传递

Nginx 自带的 $request_id 变量（需 1.11.0+）会在每个新请求进入时自动生成一个 UUID v4 格式的字符串。但前提是：该请求未携带 X-Request-ID 头，否则 Nginx 会直接复用该值——这是实现跨服务透传的基础逻辑。

若上游（如浏览器或 API 客户端）已发起了带 X-Request-ID 的请求，Nginx 会继承它，避免覆盖；
若无此头，Nginx 自动生成并设置响应头 X-Request-ID，同时可用于日志记录；
务必在 proxy_pass 前启用 proxy_set_header X-Request-ID $request_id;，确保下游服务也能收到该 ID。

在 log_format 中嵌入 $request_id 并输出到访问日志

定义日志格式时，将 $request_id 作为固定字段插入，便于后续用日志系统（如 ELK、Loki）提取和关联。

log_format main '$remote_addr - $remote_user [$time_local] '
                 '"$request" $status $body_bytes_sent '
                 '"$http_referer" "$http_user_agent" '
                 '$request_id '  # ← 关键：显式加入
                 '$upstream_http_x_request_id ';  # ← 可选：记录下游返回的 ID（用于验证透传）

然后在 access_log 中使用该格式：

access_log /var/log/nginx/access.log main;

下游服务需主动读取并注入自身日志

Nginx 的 $request_id 只解决入口层打标问题。要形成完整链路，所有微服务必须：

从 HTTP 请求头 X-Request-ID 中读取该值（而非自行生成）；
在应用日志中将该 ID 作为固定字段输出（如 Logback 的 %X{X-Request-ID} 或 Zap 的 With(zap.String("request_id", rid))）；
调用其他服务时，通过 proxy_set_header X-Request-ID $request_id; 或代码中透传该 header，保持链条不断。