nginx 日志配置笔记

Nginx 的日志配置非常重要，它可以帮助你记录服务器的访问情况、错误信息等，便于后续的分析和故障排查。Nginx 的日志配置主要包括访问日志（access log）和错误日志（error log）。

1、访问日志（Access Log）

访问日志记录了客户端对服务器的请求信息，包括请求的 URL、HTTP 状态码、客户端 IP 地址、请求时间等。

配置示例：

http {log_format main '$remote_addr - $remote_user [$time_local] "$request" ''$status $body_bytes_sent "$http_referer" ''"$http_user_agent" "$http_x_forwarded_for"';access_log /var/log/nginx/access.log main;server {listen 80;server_name example.com;location / {root /var/www/html;index index.html;}}
}

配置解释：

• log_format main …：定义了一个名为 main 的日志格式。

$remote_addr：客户端 IP 地址。

$remote_user：客户端用户名（如果有）。

$time_local：本地时间。

$request：请求的 URL 和 HTTP 方法。

$status：HTTP 状态码。

$body_bytes_sent：发送给客户端的字节数。

$http_referer：请求的来源页面。

$http_user_agent：客户端的用户代理（浏览器类型）。

$http_x_forwarded_for：如果使用了反向代理，这个变量记录了客户端的真实 IP 地址。

• access_log /var/log/nginx/access.log main;：指定访问日志的文件路径和使用的日志格式。

2、错误日志（Error Log）

错误日志记录了 Nginx 运行过程中发生的错误信息，包括配置错误、请求处理错误等。

配置示例：

error_log /var/log/nginx/error.log warn; 
http {server {listen 80;server_name example.com;location / {root /var/www/html;index index.html;}}
}

配置解释：

• error_log /var/log/nginx/error.log warn;：指定错误日志的文件路径和日志级别。

日志级别可以是 debug, info, notice, warn, error, crit, alert, emerg。

warn 表示记录警告及以上级别的错误信息。

3、日志轮转（Log Rotation）

日志文件会随着时间的推移变得越来越大，因此需要定期进行日志轮转，以避免日志文件过大。你可以使用系统自带的日志轮转工具（如 logrotate）来管理 Nginx 的日志文件。

示例配置：

/var/log/nginx/*.log {dailymissingokrotate 7compressdelaycompressnotifemptycreate 640 nginx admsharedscriptspostrotateif [ -f /var/run/nginx.pid ]; thenkill -USR1 `cat /var/run/nginx.pid`fiendscript
}

解释：

• daily：每天轮转一次。

• missingok：如果日志文件不存在，不报错。

• rotate 7：保留 7 个旧日志文件。

• compress：压缩旧日志文件。

• delaycompress：延迟压缩，下次轮转时再压缩。

• notifempty：如果日志文件为空，不轮转。

• create 640 nginx adm：创建新日志文件时，指定权限和用户组。

• sharedscripts：共享脚本，只在第一次轮转时执行一次。

• postrotate：轮转后执行的脚本。

kill -USR1 cat /var/run/nginx.pid``：发送 USR1 信号给 Nginx，通知其重新打开日志文件。

4、其他日志配置

• 禁用日志：如果你不希望记录某些请求的日志，可以使用 access_log off; 来禁用访问日志。

location /static/ {access_log off;root /var/www/static;
}

• 自定义日志格式：你可以根据需要自定义日志格式，记录更多或更少的信息。

log_format custom '$remote_addr - [$time_local] "$request" $status';
access_log /var/log/nginx/custom_access.log custom;

总结

Nginx 的日志配置非常灵活，可以根据实际需求进行调整。通过合理配置访问日志和错误日志，可以帮助你更好地监控和维护 Nginx 服务器。