Nginx 中 nginx.conf 如何达成高性能的日志格式定制

Nginx高性能日志定制需精简字段、启用缓冲与异步刷盘、避免运行时计算：仅保留必要字段如$remote_addr、$status等，用$request替代拆解字段，禁用$http_*和$hostname等高开销变量，配置buffer=128k flush=3s，并采用竖线分隔的轻量格式。

要让 Nginx 的 nginx.conf 实现高性能的日志格式定制，核心不是堆砌字段，而是**精简必要字段 + 合理缓冲 + 避免运行时计算**。过度记录或低效格式会显著拖慢写日志路径，尤其在高并发下。

只记录真正需要的字段

默认 log_format combined 包含大量字段（如 $http_user_agent、$http_referer），但多数场景并不需要实时分析 UA 或来源页。这些字段体积大、解析开销高，且常含空格和特殊字符，影响日志解析效率。

• 用 $request 替代拆解的 $request_method $request_uri $server_protocol —— 更紧凑，Nginx 内部已拼接好
• 优先用 $status 和 $bytes_sent，避免 $body_bytes_sent（需等待响应体发送完才写日志）
• 如需客户端真实 IP，用 $realip_remote_addr（配合 set_real_ip_from）而非不稳定的 $http_x_forwarded_for
• 删除 $http_* 类字段（除极少数必须项），它们触发 header 解析，增加 CPU 开销

启用日志缓冲与异步刷盘

频繁小写操作是 I/O 瓶颈。通过缓冲批量写入，可大幅提升吞吐。

• 在 access_log 指令中加入 buffer=64k：累积至 64KB 再写磁盘
• 添加 flush=5s：即使未满缓冲，每 5 秒也强制刷一次，防丢失
• 确保日志文件所在磁盘使用 ext4/xfs 并挂载 noatime,data=ordered，减少元数据开销

避免运行时变量与条件逻辑

Nginx 日志格式不支持 if 判断，但有人误用 $arg_* 或 $cookie_* 导致每次请求都遍历全部参数/cookie，实测可使 log 写入延迟上升 20%+。

• 不直接记录 $arg_token、$cookie_sessionid 等非常驻字段，除非业务强依赖
• 如需脱敏或过滤，应在日志采集端（如 Filebeat、rsyslog）处理，而非在 Nginx 中用 map 模块做条件映射
• 禁用 log_format 中的 $hostname（每次调用 gethostname() 系统调用）和 $time_iso8601（比 $time_local 更重）

用自定义 format 替代默认 combined

示例：一个面向监控与快速排障的轻量格式

log_format fast '$remote_addr|$time_local|$status|$request_length|$bytes_sent|$request_time|$upstream_response_time';
access_log /var/log/nginx/access.log fast buffer=128k flush=3s;

该格式不含空格分隔符（改用 |），字段全为数值或固定长度时间，便于 grep/awk 快速提取；$request_length 和 $bytes_sent 可评估请求/响应负载；双时间字段区分 Nginx 处理耗时与上游真实耗时，利于定位瓶颈。