一、概述
Nginx日志是服务器运维与问题排查的核心支撑，能够精准记录客户端请求详情、服务响应状态、处理耗时等关键信息，为故障定位、性能优化、安全审计和流量分析提供可靠数据依据。Nginx具备灵活的日志记录机制，支持多级别配置独立日志、自定义日志格式及缓存优化等功能。
二、日志级别
Nginx日志级别按优先级从高到低排序为：debug > info > notice > warn > error > crit > alert > emerg。级别越高，记录的日志信息越少，仅触发对应严重程度及更高等级的事件；级别越低，日志内容越详细，适合调试场景。
- 生产环境建议使用
warn或error级别，平衡日志完整性与存储资源占用，避免冗余日志消耗系统性能； - 调试场景可临时启用
debug级别，但需配合过滤规则（如指定IP），防止高流量场景下日志泛滥。
三、日志命令
3.1 access_log
access_log用于定义访问日志的存储路径、输出格式及附加配置，是Nginx日志配置的核心指令。
语法格式：
access_log path [format [buffer=size] [gzip[=level]] [flush=time] [if=condition]];
或
access_log off;
支持syslog输出格式：
access_log syslog:server=address[,parameter=value] [format];
默认值：
access_log logs/access.log combined;
作用域：
http、server、location、if in location、limit_except
核心参数说明：
- buffer：设置内存缓存区大小，减少磁盘
I/O操作； - gzip：启用日志压缩并指定压缩级别，降低存储占用；
- flush：设置缓存区日志写入磁盘的最长等待时间；
实例：
access_log /spool/logs/nginx-access.log compression buffer=32k;
表示使用
compression格式记录日志，存储至指定路径，设置32k缓存提升写入效率。
3.2 log_format
log_format用于自定义日志输出格式，通过变量组合满足不同业务场景的数据记录需求，仅在http块中生效。
语法格式：
log_format name [escape=default|json] string ...;
默认值：
log_format combined "...";（内置通用格式，兼容Apache的combined格式）
作用域：
http
常用格式实例：
基础格式：
log_format main '$remote_addr - $remote_user [$time_local] '
' "$request" $status $body_bytes_sent '
' "$http_referer" "$http_user_agent"';
JSON格式：便于日志分析工具（如Logstash）解析，
log_format logstash_json
'{"@timestamp": "$time_iso8601","host": "$server_addr","client": "$remote_addr","status": "$status","url": "$request_uri"
}';
反向代理格式：记录客户端真实IP，
log_format proxy '$http_x_forwarded_for - $remote_user [$time_local] '
' "$request" $status $body_bytes_sent';
关键变量说明：
$remote_addr记录客户端IP，
$request记录请求URL及协议，
$status记录响应状态码，
$request_time记录请求处理耗时。
3.3 open_log_file_cache
open_log_file_cache用于设置日志文件缓存，减少频繁打开/关闭日志文件的I/O开销，默认关闭（off）。
语法格式：
open_log_file_cache max=N [inactive=time] [min_uses=N] [valid=time];
或
open_log_file_cache off;
作用域：
http、server、location
核心参数说明：
- max：缓存中最大文件描述符数量，满额时按LRU算法淘汰旧描述符；
- inactive：缓存条目存活时间，默认10秒，超时未使用则移除；
- min_uses：inactive时间段内日志文件最少使用次数，达标后记入缓存，默认1次；
- valid：缓存有效性检查频率，默认60秒；
实例：
open_log_file_cache max=1000 inactive=20s valid=1m min_uses=2;
3.4 log_not_found
log_not_found用于控制是否在error_log中记录404（资源未找到）错误日志，默认开启（on）。
语法格式：
log_not_found on | off;
作用域：
http、server、location
应用场景：静态资源（如图片、JS文件）频繁出现404时，可设置为off减少无效日志占用，聚焦关键错误信息。
3.5 log_subrequest
log_subrequest用于控制是否在access_log中记录子请求日志，默认关闭（off）。
语法格式：
log_subrequest on | off;
作用域：
http、server、location
说明：子请求通常用于内部跳转（如index指令、try_files），开启后会增加日志冗余，仅在调试内部请求流程时建议启用。
3.6 rewrite_log
rewrite_log用于开启rewrite规则调试日志，由ngx_http_rewrite_module模块提供，默认关闭（off）。
语法格式：
rewrite_log on | off;
作用域：
http、server、location、if
说明：开启后，所有rewrite相关操作日志会以notice级别写入error_log，便于排查规则跳转异常（如404错误）。
3.7 error_log
error_log用于定义错误日志的存储路径及记录级别，记录服务启动、运行中的错误信息（如配置语法错误、连接失败等）。
语法格式：
error_log file | stderr | syslog:server=address[,parameter=value]
[debug | info | notice | warn | error | crit | alert | emerg];
默认值：
error_log logs/error.log error;
作用域：
main、http、server、location
实例：
error_log /var/logs/nginx/example.com.error.log warn; #仅记录warn及以上级别错误，减少日志量。
3.8 日志文件切割
Nginx无内置日志切割功能，需通过脚本或工具实现，避免单日志文件过大导致查询缓慢、存储溢出。
核心思路：定期（如每日）重命名旧日志文件，发送信号通知Nginx生成新日志文件；
常用实现方式：
Crontab定时执行Shell脚本：通过mv命令重命名旧日志，执行nginx -s reopen生成新日志；Logrotate工具：主流Linux系统自带，通过配置文件设置切割周期、保留天数及压缩规则，自动完成切割；
简易脚本示例：
#!/bin/bash
LOG_PATH="/var/log/nginx"
DATE=$(date +%Y%m%d)
mv $LOG_PATH/access.log $LOG_PATH/access_$DATE.log
mv $LOG_PATH/error.log $LOG_PATH/error_$DATE.log
nginx -s reopen
四、日志调试技巧
4.1 精准过滤调试日志
高流量场景下开启debug级别时，通过debug_connection仅记录指定IP的错误日志，避免日志泛滥。配置示例：
events {debug_connection 192.168.1.100; # 仅记录该IP的调试日志
}
4.2 rewrite规则调试
开启rewrite_log后，所有rewrite操作日志会以notice级别写入error_log，精准定位规则问题：
server {error_log /var/logs/nginx/example.com.error.log;rewrite_log on; # 开启rewrite调试日志
}
4.3 按URL单独记录日志
针对特定路径（如静态资源、接口）单独配置日志文件，便于精准排查模块问题：
server {error_log /var/logs/nginx/example.com.error.log;location /static/ { error_log /var/logs/nginx/static-error.log debug; # 单独记录/static/路径错误日志}
}
4.4 日志快速分析命令
通过Linux命令快速提取关键信息，提升运维效率：
- 统计状态码分布：
awk '{print $9}' access.log | sort | uniq -c | sort -rn - 筛选
302跳转 URL：awk '($9 ~ /302/)' access.log | awk '{print $7}' | sort | uniq -c | sort -rn - 定位耗时较长的请求：
awk '$10>1 {print $7,$10}' access.log | sort -k2nr
五、总结
Nginx日志配置的核心在于“按需记录、精准调试、高效管理”。生产环境中，需结合业务场景选择合适的日志级别与格式，通过open_log_file_cache优化I/O性能，配合日志切割避免存储压力；调试场景下，灵活运用rewrite_log、debug_connection等指令，结合日志分析命令快速定位问题。同时，需注意日志变量的合理使用（如用requesturi替代uri避免中文编码问题），反向代理场景下通过$http_x_forwarded_for记录客户端真实IP。合理的日志配置不仅能提升运维效率，还能为服务优化、安全防护提供数据支撑，是Nginx运维不可或缺的核心技能。
