Nginx日志主要分为两种:access_log(访问日志)和error_log(错误日志)。Nginx日志主要记录以下信息:
如果你不进行任何配置的话,这 2 个日志将会使用默认的日志配置,这个日志将会位于 /var/log/nginx 目录中。
access_log path [format [buffer=size] [gzip[=level]] [flush=time] [if=condition]]; # 设置访问日志
记录客户端请求的信息。
access_log off; #关闭当前作用域下的所有日志
access_log log_file log_format;#设置日志文件的位置和使用的格式
第二条指令中log_file是日志文件的绝对路径,log_format是日志文件记录的格式。可以在http、server、location等指令的上下文中启用访问日志。Nginx默认开启了访问日志的功能,且log_format指令的配置仅可用在http模块内,否则会出现警告信息。
http {
access_log /nginx/access.log;
......
server {
server_name test.com
access_log /nginx/domain.access.log;
......
}
}
如果没有指定log_format,会自动使用系统默认名为combined的:
access_log /var/logs/nginx-access.log
该例子指定日志的写入路径为/var/logs/nginx-access.log,日志格式使用默认的combined。
access_log /var/logs/nginx-access.log buffer=32k gzip flush=1m
该例子指定日志的写入路径为/var/logs/nginx-access.log,
日志格式使用默认的combined,指定日志的缓存大小为32k,
日志写入前启用gzip进行压缩,压缩比使用默认值1,缓存数据有效时间为1分钟。
log_format combined '$remote_addr - $remote_user [$time_local]'
'"$request" $status $body_bytes_sent'
'"$http_referer" "$http_user_agent"';
变量 | 含义 |
---|---|
$bytes_sent | 发送给客户端的总字节数 |
$body_bytes_sent | 发送给客户端的字节数,不包括响应头的大小 |
$connection | 连接序列号 |
$connection_requests | 当前通过连接发出的请求数量 |
$msec | 日志写入时间,单位为秒,精度是毫秒 |
$pipe | 如果请求是通过http流水线发送,则其值为"p",否则为“." |
$request_length | 请求长度(包括请求行,请求头和请求体) |
$request_time | 请求处理时长,单位为秒,精度为毫秒,从读入客户端的第一个字节开始,直到把最后一个字符发送张客户端进行日志写入为止 |
$status | 响应状态码 |
$time_iso8601 | 标准格式的本地时间,形如“2017-05-24T18:31:27+08:00” |
$time_local | 通用日志格式下的本地时间,如"24/May/2017:18:31:27 +0800" |
$http_referer | 请求的referer地址。 |
$http_user_agent | 客户端浏览器信息。 |
$remote_addr | 客户端IP |
$http_x_forwarded_for | 当前端有代理服务器时,设置web节点记录客户端地址的配置,此参数生效的前提是代理服务器也要进行相关的x_forwarded_for设置。 |
$request | 完整的原始请求行,如 "GET / HTTP/1.1" |
$remote_user | 客户端用户名称,针对启用了用户认证的请求 |
$request_uri | 完整的请求地址,如 "https://www.cdsy.xyz/" |
它也是在http,server或location指令的上下文中设置,一般写法如下:
error_log path(存放路径) level(日志等级)
其中log_file为错误日志存放的绝对路径。
path含义同access_log,level表示日志等级,日志等级分为[ debug | info | notice | warn | error | crit ],从左至右,日志详细程度逐级递减,即debug最详细,crit最少。
一般情况下每个server都会有自己单独的,在server中配置后,其优先级比http下的高。
http {
error_log /home/sdc/public/app/nginx/error.log;
......
server {
server_name test.com
error_log /home/sdc/public/app/nginx/test_error.log debug;
......
}
}
error_log logs/error.log info;
需要注意的是:error_log off并不能关闭错误日志,而是会将错误日志记录到一个文件名为off的文件中。正确的关闭错误日志记录功能的方法如下:
error_log /dev/null; 表示将存储日志的路径设置为“垃圾桶”。