Nginx是一个开放源代码的高性能HTTP和反向代理服务器,负责处理Internet上某些最大站点的负载。在管理NGINX网络服务器时,你要执行的最常见任务之一就是检查日志文件。
在对服务器或应用程序问题进行故障排除时,知道如何配置和读取日志非常有用,因为它们提供了详细的调试信息。
Nginx用两种类型的日志记录其事件:访问日志和错误日志。访问日志记录有关客户端请求的信息,错误日志记录有关服务器和应用程序问题的信息。
本教程概述了如何配置和读取Nginx访问和错误日志。配置Nginx访问日志的格式与位置,配置错误日志格式与位置,默认的日志文件所在位置,读取和理解Nginx日志文件每个字段。
配置Nginx访问日志
每当处理客户请求时,Nginx都会在访问日志中生成一个新记录。每个事件记录都包含一个时间戳,并包含有关客户端和所请求资源的各种信息。访问日志可以显示访问者的位置,访问者的访问的页面等。
log_format
指令允许你定义记录日志的格式。access_log
指令启用并设置日志文件的位置和使用的格式。
access_log
指令的最基本语法如下:
access_loglog_filelog_format;
其中log_file
是日志文件的完整路径,log_format
是日志文件使用的格式。可以在http
,server
或location
指令的上下文中启用访问日志。
默认情况下,Nginx主配置文件中的http
指令配置了全局访问日志格式。
http{ ... access_log/var/log/nginx/access.log; ... }
/etc/nginx/nginx.conf
为获得更好的可维护性,建议为每个服务器设置一个单独的访问日志文件。在server
指令中设置的access_log
指令将覆盖在http
指令中设置的access_log
。
http{ ... access_log/var/log/nginx/access.log; ... server{ server_namedomain.com access_log/var/log/nginx/domain.access.log; ... } }
/etc/nginx/conf.d/domain.com.conf
如果未指定日志格式,Nginx将使用预定义的combined组合格式,如下所示:
log_formatcombined'$remote_addr-$remote_user[$time_local]' '"$request"$status$body_bytes_sent' '"$http_referer""$http_user_agent"';
要更改日志记录格式,请覆盖默认设置或定义一个新设置。例如,定义一个名为main
的新日志记录格式,它将用添加X-Forwarded-For
header的值来扩展combined
格式,在http
或server
中添加以下定义指令:
log_formatcustom'$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.logcustom;
虽然访问日志提供了非常有用的信息。但它会占用磁盘空间,并可能影响服务器性能。如果服务器资源不足,并且网站繁忙,则可能要禁用访问日志。为此,请将access_log
伪指令的值设置为off
。理论上你不会出现这种情况,Nginx会自动删除前期的日志文件:
access_log off;
配置错误日志
Nginx将应用程序和常规服务器错误的消息写入错误日志文件。如果你在Web应用程序中遇到错误,则错误日志是你开始进行排查问题的第一个位置。error_log
指令启用并设置错误日志的位置和严重性级别。它采用以下格式,可以在http
,server
或location
上下文中进行设置:error_loglog_filelog_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
指令上下文中定义:http{ ... error_log/var/log/nginx/error.log; ... } /etc/nginx/nginx.conf 与访问日志相同,建议为每个服务器设置一个单独的错误日志文件,该文件将覆盖更高级别的设置如http指令上下文。 例如,要将domain.com的错误日志设置为
warn
,你可以使用:http{ ... error_log/var/log/nginx/error.log; ... server{ server_namedomain.com error_log/var/log/nginx/domain.error.logwarn; ... } } 无论何时修改配置文件,都必须重新加载Nginx服务,以使更改生效。
日志文件的位置
在大多数Linux发行版中,例如Ubuntu ,CentOS和Debian。默认情况下,访问和错误日志位于/var/log/nginx
目录中。读取和理解Nginx日志文件
你可以使用cat
,less
,grep
,cut
,awk
等命令打开和解析nginx日志文件。以下是使用默认的Nginx日志格式的访问日志文件的记录:192.168.33.1--[15/Oct/201941:46+0000]"GET/HTTP/1"200396"-""Mozilla/0(X11;Linuxx86_64)AppleWebKit/536(KHTML,likeGecko)Chrome/38120Safari/536" 让我们细分Nginx日志文件记录的每个字段意味着什么:
-
$remote_addr
-192.168.33.1
-发出请求的客户端的IP地址。 -
$remote_user
--
-HTTP身份验证用户。未设置用户名时,此字段显示-
。 -
[$time_local]
-[15/Oct/201941:46 +0000]
-
"$request"
-"GET / HTTP/1.1"
-请求类型,路径和协议。 -
$status
-200
-服务器响应代码。 -
$body_bytes_sent
-396
-服务器响应的大小(以字节为单位)。 -
"$http_referer"
-"-"
-引荐网址。 -
"$http_user_agent"
-Mozilla/5.0 ...
-客户端的用户代理(网络浏览器)。
tail
命令实时观看日志文件记录:tail -f access.log
审核编辑 :李倩
-
服务器
+关注
关注
12文章
9123浏览量
85320 -
源代码
+关注
关注
96文章
2945浏览量
66730 -
nginx
+关注
关注
0文章
149浏览量
12170
原文标题:配置 Nginx 访问与错误日志
文章出处:【微信号:magedu-Linux,微信公众号:马哥Linux运维】欢迎添加关注!文章转载请注明出处。
发布评论请先 登录
相关推荐
评论