Nginx日志需结构化捕获关键字段、保留原始语义并适配下游解析，推荐使用escape=json输出标准JSON格式，配合$request、$arg_xxx、$realip_remote_addr等变量实现业务分析与埋点追踪。
要让 Nginx 访问日志支撑业务行为分析和前端埋点追踪，核心不是“记录所有参数”，而是**结构化捕获关键字段、保留原始语义、适配下游解析习惯**。默认日志只记路径不记参数，必须主动配置 log_format，并注意安全与可维护性。
记录完整请求行（含原始 query string）
这是最稳妥、零兼容风险的方式。Nginx 内置变量 $request 已包含方法、带参数的 URI 和协议，例如：GET /product/detail?id=1024&utm_source=wechat HTTP/1.1
它原样保留 URL 编码（如 %20），无需额外 decode。
配置示例：
log_format biz '$remote_addr [$time_local] "$request" $status $body_bytes_sent ' '"$http_referer" "$http_user_agent" "$args"';<br>access_log /var/log/nginx/biz.log biz;
✅ 优势：字段齐全、格式标准、日志分析工具（如 ELK、Grafana Loki）开箱即用
⚠️ 注意：$args 单独记录时与 $request 中的参数内容一致，仍是编码后字符串
提取指定业务参数（结构化打点）
当关注特定埋点字段（如 event、page_id、ab_test_group），用 $arg_xxx 变量精准提取，避免日志膨胀，也便于告警或聚合统计。
例如记录页面曝光事件：
-
$arg_event→ 获取?event=page_view -
$arg_page_id→ 获取?page_id=home_v2 -
$arg_bid→ 获取广告位 ID：?bid=rec_banner_top
配置示例：
log_format track '$remote_addr [$time_local] ' '"$request_method $uri" ' 'event="$arg_event" page="$arg_page_id" bid="$arg_bid" ' 'uid="$arg_uid" ts="$arg_ts" status=$status';<br>access_log /var/log/nginx/track.log track;
✅ 优势：字段语义清晰、无冗余、支持直接 SQL 化查询（如 ClickHouse）
⚠️ 注意：未传参时值为空字符串，需在分析层做空值处理
补充真实客户端与上下文信息
仅靠 URL 参数不足以还原用户行为。还需叠加以下字段提升分析维度：
-
真实 IP：用
$http_x_forwarded_for或配合set_real_ip_from+$realip_remote_addr，避免 CDN/代理遮蔽源头 -
设备标识：提取
$http_ua_platform（需 map 预定义）或从$http_user_agent解析出 iOS/Android/PC -
会话线索：若前端透传了
X-Request-ID或X-Trace-ID，加进日志可串联前后端链路 -
响应耗时：加上
$request_time，识别慢请求是否集中于某类埋点（如某个活动页加载异常）
示例片段：
'clientip="$realip_remote_addr" traceid="$http_x_request_id" ' 'ua_os="$os" ua_device="$device" rt=$request_time'
输出为 JSON 格式（推荐生产环境）
非 JSON 日志需正则解析，易出错且扩展性差。启用 escape=json 可自动转义特殊字符，保障字段完整性：
log_format json escape=json '{ "ts":"$time_iso8601", "ip":"$realip_remote_addr", ' '"method":"$request_method", "path":"$uri", "args":"$args", ' '"event":"$arg_event", "page":"$arg_page_id", "rt":$request_time, ' '"status":$status, "ua":"$http_user_agent" }';<br>access_log /var/log/nginx/biz.json json;
✅ 优势：天然兼容日志采集器（Filebeat、Fluentd）、可直接导入时序数据库或 BI 工具
⚠️ 注意：确保磁盘有足够空间，JSON 日志体积略大于纯文本
