配置Nginx错误和访问日志

时间:2020-03-05 15:30:28  来源:igfitidea点击:

Nginx是一个开源的高性能HTTP和反向代理服务器,负责处理Internet上一些最大站点的负载。

在管理NGINX网络服务器时,我们要执行的最常见任务之一就是检查日志文件。

在对服务器或者应用程序问题进行故障排除时,知道如何配置和读取日志非常有用,因为它们提供了详细的调试信息。

Nginx用两种类型的日志记录其事件记录:访问日志和错误日志。
访问日志记录有关客户端请求的信息,错误日志记录有关服务器和应用程序问题的信息。

本文概述了如何配置和读取Nginx访问和错误日志。

配置访问日志

每当处理客户请求时,Nginx都会在访问日志中生成一个新事件。
每个事件记录都包含一个时间戳,并包含有关客户端和所请求资源的各种信息。
访问日志可以显示访问者的位置,访问者访问的页面,他们在页面上花费的时间等等。

'log_format'指令允许我们定义记录消息的格式。
'access_log'指令启用并设置日志文件的位置和使用的格式。

“ access_log”指令的最基本语法如下:

access_log log_file log_format;

其中“ log_file”是日志文件的完整路径,而“ log_format”是日志文件使用的格式。

可以在“ http”,“ server”或者“ location”指令块中启用访问日志。

默认情况下,在Nginx主配置文件中的'http'指令中全局启用访问日志。

/etc/nginx/nginx.conf

http {
  ...
  access_log  /var/log/nginx/access.log;
  ...
}

为了提高可读性,建议为每个服务器块设置一个单独的访问日志文件。
在“服务器”指令中设置的“ access_log”指令将覆盖在“ http”(更高级别)指令中设置的指令。

/etc/nginx/conf.d/theitroad.com.conf

http {
  ...
  access_log  /var/log/nginx/access.log;
  ...
  server {
    server_name theitroad.com
    access_log  /var/log/nginx/domain.access.log;
    ...
  }
}

如果未指定日志格式,Nginx将使用如下所示的预定义组合格式:

log_format combined '$remote_addr - $remote_user [$time_local] '
                    '"$request" $status $body_bytes_sent '
                    '"$http_referer" "$http_user_agent"';

要更改日志记录格式,请覆盖默认设置或者定义一个新设置。
例如,要定义一个名为custom的新日志记录格式,它将使用显示“ X-Forwarded-For”标题的值扩展组合格式,并在“ http”或者“ server”指令中添加以下定义:

log_format  custom  '$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 custom;

虽然访问日志提供了非常有用的信息,但它占用了磁盘空间,并可能影响服务器性能。
如果服务器资源不足并且繁忙,则可能要禁用访问日志。
为此,请将“ access_log”指令的值设置为“ off”:

access_log  off;

配置错误日志

Nginx在错误日志文件中写入有关应用程序和常规服务器错误的消息。
如果我们在Web应用程序中遇到错误,则错误日志是开始进行故障排除的第一个位置。

“ error_log”指令启用并设置错误日志的位置和严重性级别。
它采用以下形式,可以在'http','server'或者'location'块中进行设置:

error_log log_file log_level

'log_level'参数设置日志记录的级别。
以下是按严重性(从低到高)列出的级别:

  • 'debug'-调试消息。
  • 'info'-信息性消息。
  • 'notice'-公告。
  • '警告'-警告。
  • '错误'-处理请求时出错。
  • “暴击”-关键问题。需要迅速采取行动。
  • “警报”-警报。必须立即采取行动。
  • 'emerg'-紧急情况。系统处于无法使用状态。

每个日志级别包括更高的级别。
例如,如果我们将日志级别设置为'warn',则Nginx还将记录'error','crit','alert'和'emerg'消息。

如果未指定'log_level'参数,则默认为'error'。

默认情况下,在主要的nginx.conf文件内的“ http”指令中定义了“ error_log”指令:

/etc/nginx/nginx.conf

http {
  ...
  error_log  /var/log/nginx/error.log;
  ...
}

与访问日志相同,建议为每个服务器块设置一个单独的错误日志文件,该文件将覆盖从更高级别继承的设置。

例如,要将theitroad.com的错误日志设置为“警告”,可以使用:

http {
  ...
  error_log  /var/log/nginx/error.log;
  ...
  server {
    server_name theitroad.com
    error_log  /var/log/nginx/domain.error.log warn;
    ...
  }
}

每当我们修改配置文件时,都必须重新启动Nginx服务,以使更改生效。

日志文件的位置

在大多数Linux发行版(例如Ubuntu,CentOS和Debian)上,默认情况下,访问和错误日志位于'/var/log/nginx'目录中。

阅读和了解Nginx日志文件

我们可以使用“ cat”,“ less”,“ grep”,“ cut”,“ awk”等标准命令打开和解析日志文件。

这是来自访问日志文件的示例记录,该记录使用默认的Combine Nginx日志格式:

192.168.33.1 - - [15/Oct/2019:19:41:46 +0000] "GET/HTTP/1.1" 200 396 "-" "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/77.0.3865.120 Safari/537.36"

让我们分解一下记录中每个字段的含义:

  • '$remote_addr'-'192.168.33.1'-发出请求的客户端的IP地址。
  • '$remote_user'-'-'-HTTP身份验证用户。未设置用户名时,此字段显示'-'。
  • '[$time_local]'-'[15/Oct/2019:19:41:46 +0000]'-本地服务器时间。
  • '“ $request”'-'“ GET/HTTP/1.1”'-请求类型,路径和协议。
  • '$status'-'200'-服务器响应代码。
  • '$body_bytes_sent'-'396'-服务器响应的大小(以字节为单位)。
  • '“ $http_referer”'-'“-”'-引荐网址。
  • '“ $http_user_agent”'-'Mozilla/5.0 ...'-客户端的用户代理(Web浏览器)。

使用“ tail”命令实时查看日志文件:

tail -f  access.log