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 中常用的一些变量：

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; 

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

error_log logs/error.log info;