Nginx日志配置与切割

log, logrotate, nginx

Nginx日志配置与切割

Nginx 日志配置非常简单，首先使用log_format指令配置一个格式。然后使用 access_log（访问日志）、error_log（错误日志）指令开启即可。

1
2
3
4
5
6
7
8
9
10
11
12
13
http {
    # 日志格式 第二个参数是格式名字，可以配置多个format（这里的日志格式名为 `main`）。后面 access_log 指令使用哪个格式就写这个格式的名字。
    log_format main '$remote_addr - $remote_user [$time_local] '
                       '"$request" $status $bytes_sent '
                       '"$http_referer" "$http_user_agent"';

    access_log /var/log/nginx/access.log main;
}

# 或者每个虚拟主机配置单独的日志文件夹
server {
    access_log /var/log/nginx/$host/access.log main;
}

条件日志

我们有一个心跳检测的服务，定期会向服务器发请求。这个请求每天会发很多次，这个请求的日志也是非常多的。这个日志没什么意义，可以把它忽略掉。

第一种方法就是配置一个location匹配到这个心跳检测接口将日志关掉。

1
2
3
4
location = /_heartbeat {
    access_log off;
    proxy_pass http://myserver;
}

上面方法不是很灵活，我们要重复配置。有没有办法只配置一处就能做到呢？查看Nginx文档，发现有一个条件日志配置示例：

1
2
3
4
5
6
7
8
9
10
http {
    map $uri $loggable {
        # 可以使用正则
        ~\.(jpg|png|gif|webp)$   0; # 不记录图片
        /_heartbeat              0; # 不记录心跳检测
        default                  1;
    }

    access_log /var/log/nginx/access.log main if=$loggable;
}

日志切割

当 Nginx 接收到 USR1 时会重新打开日志文件。

1
2
mv /var/log/nginx/access.log /var/log/nginx/access.log-20180706
kill -USR1 `cat /var/run/nginx.pid`

上面方案很不灵活，需要手动处理。我们可以使用crontab或者logrotate来做到自动化。

  1. crontab 

    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    #!/bin/bash
    # 0 0 * * * 每天零点执行

    LOG_PATH=/var/log/nginx
    DATE=`date -d "yesterday" +%Y%m%d`
    PID=`cat /var/run/nginx.pid`

    cd $LOG_PATH

    mv access.log access.log-$DATE && zip -mq access.log-$DATE.zip access.log-$DATE
    kill -USR1 $PID

  2. logrotate

    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    /var/log/nginx/*.log {
        daily
        dateext
        rotate 30
        compress
        delaycompress
        notifempty
        sharedscripts
        postrotate
            if [ -f /var/run/nginx.pid ]; then
                kill -USR1 `cat /var/run/nginx.pid`
            fi
        endscript
    }
    • 第一行要处理的日志，可以使用通配符。后面{}包裹日志切割的配置项。
    • daily：表示每天执行一次，类似的配置还有weekly,monthly每周和每月。
    • dateext：文件后缀使用日期命名。
    • rotate 30：保留最近30天的日志。
    • compress：对日志进行压缩。
    • delaycompress：延迟压缩，分割完成后延迟一天压缩此日志。
    • notifempty：忽略空日志。
    • sharedscripts：执行脚本。
    • postrotate：日志被切割后执行的脚本，对应的prerotate表示在切割前执行的脚本。
    • endscript：标记脚本结束。
    • 测试一下脚本：logrotate -d /etc/logrotate.d/nginx。
    • 执行后面的命令能立即看到效果：logrotate -vf /etc/logrotate.d/nginx。

输出JSON格式的日志

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
log_format json escape=json '{'
    '"remote_addr": "$remote_addr",'
    '"x_forwarded_for":  "$http_x_forwarded_for",'
    '"time_iso8601": "$time_iso8601",'
    '"host": "$host",'
    '"method": "$request_method",'
    '"request_uri": "$request_uri",'
    '"status": $status,'
    '"http_referer":  "$http_referer",'
    '"body_bytes_sent": "$body_bytes_sent",'
    '"http_user_agent": "$http_user_agent",'
    '"request_time": "$request_time",'
    '"upstream_addr": "$upstream_addr",'
    '"upstream_response_time": "$upstream_response_time",'
    '"x_request_id": "$upstream_http_x_request_id",'
    '"x_response_time": "$upstream_http_x_response_time"'
'}';

参考

本站采用「署名 4.0 国际」进行许可。