Nginx 的日志配置

Nginx 的错误日志

Nginx 错误日志平时不用太关注，但是一旦出了问题，就需要借助错误日志来判断问题所在。
配置参数格式：error_log /path/to/log level;

Nginx 错误日志级别

常见的错误日志级别有 debug | info | notice | warn | error | crit | alert | emerg
级别越高记录的信息越少，如果不定义，默认级别为 error.
它可以配置在 main、http、server、location 段里。

如果在配置文件中定义了两个 error_log，在同一个配置段里的话会产生冲突，所以同一个段里只允许配置一个 error_log。
但是，在不同的配置段中出现是没问题的。

Nginx 错误日志示例

error_log  /var/log/nginx/error.log crit;

如果要想彻底关闭 error_log，需要这样配置
error_log /dev/null;

---

Nginx 访问日志格式

Nginx 访问日志可以设置自定义的格式，来满足特定的需求。

访问日志格式示例

示例 1
    log_format combined_realip '$remote_addr $http_x_forwarded_for [$time_local]'
    '$host "$request_uri" $status'
    '"$http_referer" "$http_user_agent"';

示例 2
    log_format main '$remote_addr [$time_local] '
    '$host "$request_uri" $status "$request"'
    '"$http_referer" "$http_user_agent" "$request_time"';

若不配置 log_format 或者不在 access_log 配置中指定 log_format，则默认格式为：
    '$remote_addr - $remote_user [$time_local] "$request" '
    '$status $body_bytes_sent "$http_referer" '
    '"$http_user_agent";

常见变量

变量	说明
$time_local	通用日志格式下的本地时间；（服务器时间）
$remote_addr	客户端（用户）IP 地址
$status	请求状态码，如 200，404，301，302 等
$body_bytes_sent	发送给客户端的字节数，不包括响应头的大小
$bytes_sent	发送给客户端的总字节数
$request_length	请求的长度（包括请求行，请求头和请求正文）
$request_time	请求处理时间，单位为秒，小数的形式
$upstream_addr	集群轮询地址
$upstream_response_time	指从 Nginx 向后端（php-cgi)建立连接开始到接受完数据然后关闭连接为止的时间
$remote_user	用来记录客户端用户名称
$request	请求方式（GET 或者 POST 等）+ URL（包含 $request_method,$host,$request_uri）
$http_user_agent	用户浏览器标识
$http_host	请求的 url 地址（目标 url 地址）的 host
$host	等同于 $http_host
$http_referer	来源页面，即从哪个页面转到本页，如果直接在浏览器输入网址来访问，则 referer 为空
$uri	请求中的当前 URI(不带请求参数，参数位于 $args)，不同于浏览器传递的 $request_uri 的值，它可以通过内部重定向，或者使用 index 指令进行修改。
$document_uri	等同于$uri
$request_uri	比 $uri 多了参数，即 $uri+$args
$http_x_forwarded_for	如果使用了代理，这个参数会记录代理服务器的 ip 和客户端的 ip

Nginx 访问日志配置

web 服务器的访问日志是非常重要的，我们可以通过访问日志来分析用户的访问情况，
也可以通过访问日志发现一些异常访问，比如 cc 攻击。

格式： access_log /path/to/logfile format;

access_log 可以配置到 http, server, location 配置段中。

配置示例

server 
{
    listen 80;
    server_name www.aminglinux.com;
    root /data/wwwroot/www.aminglinux.com;
    index index.html index.php;
    access_log /data/logs/www.aminglinux.com_access.log main;
}
说明：若不指定 log_format，则按照默认的格式写日志。

---

Nginx 访问日志过滤

一个网站，会包含很多元素，尤其是有大量的图片、js、css 等静态元素。
这样的请求其实可以不用记录日志。

配置示例

location ~* ^.+\.(gif|jpg|png|css|js)$ 
{
    access_log off;
}

或

location ~* ^.+\.(gif|jpg|png|css|js)$                                      
{
    access_log /dev/null;
}

---

Nginx 访问日志切割

如果任由访问日志写下去，日志文件会变得越来越大，甚至是写满磁盘。
所以，我们需要想办法把日志做切割，比如每天生成一个新的日志，旧的日志按规定时间删除即可。

实现日志切割可以通过写 shell 脚本或者系统的日志切割机制实现。

shell 脚本切割 Nginx 日志

切割脚本内容：
#!/bin/bash
logdir=/var/log/nginx  
# 定义日志路径
prefix=`date -d "-1 day" +%y%m%d`  
# 定义切割后的日志前缀
cd $logdir  
for f in `ls *.log`
do
    mv $f $f-$prefix  
    # 把日志改名
done
/bin/kill -USR1 $(cat /usr/local/nginx/logs/nginx.pid 2>/dev/null) 2>/dev/null  
# 生成新的日志
bzip2 *$prefix  
# 压缩日志
find . -type f -mtime +180 |xargs /bin/rm -f  
# 删除超过 180 天的老日志

系统日志切割机制

在 /etc/logrotate.d/ 下创建 nginx 文件，内容为：
/data/logs/*log {
    daily
    rotate 30
    missingok
    notifempty
    compress
    sharedscripts
    postrotate
        /bin/kill -USR1 $(cat /usr/local/nginx/logs/nginx.pid 2>/dev/null) 2>/dev/null || :
    endscript
}

说明：
1 nginx 日志在 /data/logs/ 目录下面，日志名字以 log 结尾
2 daily 表示每天切割
3 rotate 30 表示日志保留 30 天
4 missingok 表示忽略错误
5 notifempty 表示如果日志为空，不切割
6 compress 表示压缩
7 sharedscripts和endscript 中间可以引用系统的命令
8 postrotate 表示当切割之后要执行的命令

---