精品软件与实用教程
什么是Nginx日志
Nginx是一个开放源代码的高性能HTTP和反向代理服务器,负责处理Internet上某些最大站点的负载。在管理 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;
...
}
为获得更好的可维护性,建议为每个服务器块设置一个单独的访问日志文件。在server指令中设置的access_log指令将覆盖在http(更高级别)指令中设置的一个。
/etc/nginx/conf.d/domain.com.conf
http {
...
access_log /var/log/nginx/access.log;
...
server {
server_name domain.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"';
要更改日志记录格式,请覆盖默认设置或定义一个新设置。例如,定义一个名为 main 的新日志记录格式,它将用显示X-Forwarded-For标头的值扩展 combined 格式,在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 -公告。
- warn -警告。
- error -处理请求时出错。
- crit -关键问题。需要立即采取行动。
- alert -警报。必须立即采取行动。
- emerg - 紧急情况。系统处于无法使用的状态。
每个日志级别包括更高级别。例如,如果您将日志级别设置为warn,则Nginx还将记录error,crit,alert和emerg消息。
未指定log_level参数时,默认为error。
默认情况下,error_log指令在主nginx.conf文件内的http指令中定义:
/etc/nginx/nginx.conf
http {
...
error_log /var/log/nginx/error.log;
...
}
与访问日志相同,建议为每个服务器块设置一个单独的错误日志文件,该文件将覆盖从更高级别继承的设置。
例如,要将domain.com的错误日志设置为warn,您可以使用:
http {
...
error_log /var/log/nginx/error.log;
...
server {
server_name domain.com
error_log /var/log/nginx/domain.error.log warn;
...
}
}
无论何时修改配置文件,都必须重新启动Nginx服务,以使更改生效。