调整 Docker 中 nginx 的日志级别

Posted 2021-10-02 dotNET跨平台

调整 Docker 中 nginx 的日志级别

Intro

最近发现我们的一个应用产生了很多日志，而这些日志大多都是 nginx 的 access_log，我们默认会把标准输出收集到 es 里分析应用日志，但是很多都是 access_log 就可能会掩盖掉真实的错误日志，所以可能有时候我们并不想输出这些 access_log，示例如下：

Nginx Dockerfile

去 Github 上扒了一下 Nginx 的 Dockerfile, docker-nginx/Dockerfile at master · nginxinc/docker-nginx (github.com)

可以看到 nginx 默认会把 access_log 和 error_log 链接到标准输出中，这也就是为什么我们在  docker logs 或者 kubectl logs  的时候能够看到 access_log

我们可以在容器里执行 cat /etc/nginx/nginx.conf 来查看默认的 nginx  配置

default nginx conf

从上面可以看出来 error_log 的级别是 notice，如果有需要也可以配置成 warn/error，具体的日志配置可以参考官方文档介绍，可配置的日志级别有：debug, info, notice, warn, error, crit, alert, emerg

access_log 可以使用 off 直接禁用掉或者使用另外一个 path，这样就不会直接输出到标准输出中，就不会有那么多的日志了

New conf

知道配置怎么修改了就比较方便了，只需要把我们新改的配置替换掉默认的配置就可以了，新的配置如下：

user  nginx;
worker_processes  auto;

error_log  /var/log/nginx/error.log error;
pid        /var/run/nginx.pid;

events {
    worker_connections  1024;
}

http {
    include       /etc/nginx/mime.types;
    default_type  application/octet-stream;

    access_log  off;

    sendfile        on;
    #tcp_nopush     on;

    keepalive_timeout  65;

    #gzip  on;

    include /etc/nginx/conf.d/*.conf;
}

然后在 Dockerfile 里用新的配置覆写默认的配置：

# Copy custom nginx config
COPY /conf/nginx.conf /etc/nginx/nginx.conf

More

如果你想记录 access_log 但是不想直接，可以配置 access_log 为另外的文件名即可，就会写入对应配置的文件中，但不会直接输出到标准输出，也就不会造成采集的日志很多都是 access_log

如果不想记录，不关心 access_log 可以直接使用 off 配置禁用 access_log，如果想选择性地记录比如 2xx/3xx 不记录，其他情况记录也是可以的，nginx 文档上也有介绍，可以根据自己需要进行选择

map $status $loggable {
    ~^[23]  0;
    default 1;
}
access_log /path/to/access.log combined if=$loggable;

References

• https://notestack.io/public/configure-nginx-logging-in-a-docker-container/874f1253-cf1a-4c62-9d2d-467ab23c258d

• https://docs.nginx.com/nginx/admin-guide/monitoring/logging/

• https://github.com/nginxinc/docker-nginx/blob/master/stable/alpine/Dockerfile