文档首页/ 应用性能管理 APM/ 常见问题(2.0)/ 咨询类问题/ 在Nginx请求中携带TraceID,需如何配置?
更新时间:2026-06-02 GMT+08:00
分享

在Nginx请求中携带TraceID,需如何配置?

TraceID是整条用户请求的全局唯一凭证,Nginx中配置TraceID,能够打通从客户端到Nginx再到后端微服务,最后到数据库的完整调用链路,方便用户查询下游日志。

在Nginx请求中配置TraceID

在nginx.conf中配置如下信息:

# 记录客户端请求头,即客户端主动携带的TraceID
 "req_gtrace":"$http_lubanops_gtrace_id" 
# 记录Nginx响应头,即Nginx自己添加的TraceID
 "resp_gtrace":"$sent_http_lubanops_gtrace_id" 
#记录上游服务器响应头,即后端服务生成的TraceID
"upstream_gtraceid":"$upstream_http_lubanops_gtrace_id"

配置完成后,可在云日志服务 LTS中查看相关日志信息:

相关文档