Nginx 日志配置

Nginx 主要有两种日志类型：访问日志（access log）和错误日志（error log），可以帮助监控和调试服务的运行。

1.访问日志

访问日志主要记录客户端的请求，客户端向 Nginx 发起的每一次都会被记录到访问日志中。客户端IP、浏览器信息等都可以在访问日志中获取得到，具体的日志记录格式可以通过 log_format 来进行定义。

1.1 语法

# 设置访问日志
access_log  path  [format [buffer=size] [gzip[=level]] [flush=time] [if=condition]];
# 关闭访问日志
access_log  off;

访问日志设置字段说明：

path：指定访问日志的存储路径。
format：指定日志的格式。
buffer：用来指定日志写入时的缓存大小，默认是64K。
gzip：日志写入前先进行压缩，从 1 到 9 数值越大压缩比越高，同事压缩的速度也越慢，默认为 1。
flush：设置缓存的有效时间，如果超过 flush 指定的时间，缓存中的内容将被清空。
if：条件判断，如果指定的条件计算为0或空字符串，那么该请求不会写入日志。

1.2 作用域

可以使用 access_log 日志的作用域有：http、server、loaction、limit_except，如果在这几个作用域之外使用 access_log ，Nginx 会报错。

1.3 基础使用

指定 access_log 的日志写入路径为 Nginx 目录下 logs/access.log 文件。

access_log logs/access.log

指定 access_log 的日志写入路径为 Nginx 目录下 logs/access.log 文件，日志的缓存大小为 32K，日志写入前启用 gzip 进行压缩，压缩比使用默认值 1，缓存数据有效时间为 1 分钟。

access_log logs/access.log buffer=32k gzip flush=1m

1.4 log_format 自定义日志格式

Nginx 预定义了日志格式，如果没有明确指定日志格式将使用预定义的日志格式。

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

如果需要修改，参考 log_format 的语法进行修改即可。

log_format name [escape=default|json] string ...;

log_format 语法字段说明：

name：格式名称，在 access_log 中显性引用，否则会使用默认的语法。
escape：置变量中的字符编码方式是 json 还是 default ，默认是 default。
stirng：要定义的日志格式内容，该参数可以有多个，参数中可以使用Nginx变量。

如下是 log_format 中常用的一些变量：

变量	含义
$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://daojia.com/”

1.5 访问日志配置测试

关闭访问日志，客户端向 Nginx 服务器发起请求，访问日志未记录。

access_log off;

开启访问日志，使用预定义的 log_format，日志按照预定义的格式进行打印。

access_log  logs/access.log;

开启访问日志，使用自定义的 log_format，能够按照指定的格式进行打印。

log_format self_format '$remote_addr - $http_user_agent	- $remote_addr'
                       '"$request" $status $body_bytes_sent '
                       '"$http_referer" "$http_user_agent" "$request_uri"';

access_log  logs/access.log self_format;

2.错误日志

错误日志主要记录服务器和请求处理过程中的错误信息，通过 error_log 实现。

错误日志在Nginx中是通过error_log指令实现的。该指令记录服务器和请求处理过程中的错误信息。

2.1 语法

# 设置错误日志及错误级别
error_log file [level];

访问日志设置字段说明：

error_log，关键字，不能修改。
file：日志文件存放的路径。
level：错误级别，常见的日志级别有 debug、info、notice、warn、error、crit、alert、merg，级别越高，记录的信息越少，默认为 error。

注意：不要配置info等级较低的级别，会带来大量的磁盘I/O消耗。

2.2 作用域

可以使用 error_log 日志的作用域有：main、http、server、loaction，如果在这几个作用域之外使用 error_log，Nginx 会报错。

2.3 基础使用

指定 error_log 的日志写入路径为 Nginx 目录下的 logs/error.log 文件。

error_log logs/error.log;

指定 error_log 的日志写入路径为 Nginx 目录下的 logs/error.log 文件，日志级别为 info。

error_log logs/error.log info;

2.4 错误日志配置测试

指定 error_log 的日志写入路径为 Nginx 目录下的 logs/error.log 文件，正常输出错误到 logs/error.log 中。

error_log logs/error.log;