如何通过Nginx log_format和变量实现分布式链路追踪中的长尾请求ID记录？

本文共计933个文字，预计阅读时间需要4分钟。

在分布式系统中，通过Nginx、日志记录及$request_id传递，是实现请求级链路追踪的基础一环。关键不在于有没有request_id，而在于它是否全局唯一、是否贯穿全链路、是否被日志稳定捕获。

确保 $request_id 全局唯一且可复用

Nginx 本身不生成 $request_id，需依赖 ngx_http_core_module 提供的内置变量（Nginx 1.11.0+）或手动设置：

• 若使用内置 $request_id：它由 Nginx 在请求进入时自动生成 UUIDv4 字符串，天然唯一，无需额外配置；
• 若需兼容旧版本或定制逻辑：可用 map + $pid$microtime$remote_addr 等组合模拟，但不推荐——易冲突且不可靠；
• 务必避免在多个 location 中重复 set，否则可能覆盖上游已注入的 request_id（例如来自 OpenResty 或前置网关）。