怎样在 Nginx 中实现异步日志记录以提高 I/O 性能

Nginx 不支持真正异步日志，但可通过 buffer+flush 缓冲 access_log、syslog 转发、条件记录及磁盘优化等手段显著降低 I/O 干扰：buffer=64k flush=1s 实现内存缓存与定时刷盘；syslog 协议（推荐 TCP）将写入解耦至 rsyslog；map 排除非关键请求；日志分区挂载 SSD 并启用 noatime。

Nginx 本身不支持真正的异步日志写入（即日志不阻塞 worker 进程、由独立线程或进程处理），其 access_log 和 error_log 默认采用同步追加写入文件的方式。但可通过合理配置和外部协作，**显著降低日志 I/O 对请求处理的干扰**，达到近似“异步”的效果。核心思路是：减少写操作频率、避免磁盘直写瓶颈、利用系统缓冲与专用日志服务分流。

使用 buffer 和 flush 参数缓存日志写入

这是最直接有效的内置优化方式。Nginx 允许为 access_log 启用内存缓冲区，累积日志条目后再批量刷盘，大幅减少系统调用次数和磁盘寻道开销。

示例配置：

access_log /var/log/nginx/access.log main buffer=64k flush=1s;<br>error_log /var/log/nginx/error.log notice;

说明：

• buffer=64k：为每条 access_log 指令分配 64KB 内存缓冲区，日志先写入内存；
• flush=1s：每隔 1 秒将缓冲区内容强制刷入磁盘（即使未满）；也可设为 flush=500ms 或 flush=5s，按吞吐与延迟权衡调整；
• 缓冲仅对 access_log 有效，error_log 不支持 buffer，但可通过 syslog 方式间接异步化（见下文）。

将日志转发到 syslog（推荐用于高负载场景）

通过 syslog 协议将日志发送给本地或远程 syslog 守护进程（如 rsyslog、syslog-ng），由其负责持久化。Nginx 发送 UDP/TCP 数据包后立即返回，I/O 完全解耦，真正实现非阻塞。

配置示例（发送到本地 rsyslog）：

access_log syslog:server=127.0.0.1:514,facility=local7,tag=nginx,severity=info main;<br>error_log syslog:server=127.0.0.1:514,facility=local7,tag=nginx_error,severity=error;

注意点：

• 确保 rsyslog 已监听对应端口（如 /etc/rsyslog.conf 中启用 $UDPServerRun 514）；
• UDP 默认不可靠（可能丢日志），生产环境建议用 TCP 并开启 reliable 参数：syslog:protocol=tcp,server=127.0.0.1:514,...；
• rsyslog 可进一步配置 disk-assisted queue，即使 Nginx 瞬时爆发日志，也不会丢失。

禁用访问日志或条件性记录

并非所有请求都需要记 access log。跳过静态资源、健康检查、内部探针等低价值请求，可直接减少 30%–70% 日志量，从源头缓解 I/O 压力。

示例：只记录非静态资源的请求

map $request_uri $loggable {<br>    ~*.(js|css|png|jpg|jpeg|gif|ico|svg|woff2?|ttf|eot)$ 0;<br>    default 1;<br>}<br><br>access_log /var/log/nginx/access.log main if=$loggable;

说明：

• 利用 map 指令生成变量 $loggable，匹配常见静态文件后缀则设为 0；
• access_log ... if=$loggable 表示仅当变量值为非 0 时才写入日志；
• 同理可对 /healthz、/metrics 等路径做排除。

文件系统与磁盘层面配合优化

Nginx 日志性能最终受限于底层存储。即使配置了 buffer 和 syslog，若日志落盘设备慢，仍可能拖累整体表现。

建议措施：

• 将日志目录挂载在独立 SSD 分区（避免与系统盘或应用数据争 I/O）；
• 使用 noatime,nodiratime 挂载选项，禁止更新文件访问时间戳；
• 对日志文件启用 chown nginx:nginx + chmod 640，避免权限检查开销；
• 定期用 logrotate 切分日志，防止单文件过大导致追加写变慢（尤其 ext4 文件系统）。