目录

nginx日志配置

Nginx日志主要分为两种:access_log(访问日志)和error_log(错误日志)。通过访问日志我们可以得到用户的IP地址、浏览器的信息,请求的处理时间等信息。

access_log

访问日志主要记录客户端的请求。客户端向Nginx服务器发起的每一次请求都记录在这里。客户端IP,浏览器信息,referer,请求处理时间,请求URL等都可以在访问日志中得到。当然具体要记录哪些信息,你可以通过log_format指令定义。

access_log path [format [buffer=size] [gzip[=level]] [flush=time] [if=condition]]; # 设置访问日志
access_log off; # 关闭访问日志
  • path 指定日志的存放位置。
  • format 指定日志的格式。默认使用预定义的combined。
  • buffer 用来指定日志写入时的缓存大小。默认是64k。
  • gzip 日志写入前先进行压缩。压缩率可以指定,从1到9数值越大压缩比越高,同时压缩的速度也越慢。默认是1。
  • flush 设置缓存的有效时间。如果超过flush指定的时间,缓存中的内容将被清空。
  • if 条件判断。如果指定的条件计算为0或空字符串,那么该请求不会写入日志。 另外,还有一个特殊的值off。如果指定了该值,当前作用域下的所有的请求日志都被关闭。

作用域

可以应用access_log指令的作用域分别有http,server,location,limit_except。也就是说,在这几个作用域外使用该指令,Nginx会报错。

用法

基本用法:

access_log /var/logs/nginx-access.log

使用log_format自定义日志格式

格式:

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

我们定义一个名为main的日志格式

http {
    include       /etc/nginx/mime.types;
    default_type  application/octet-stream;
    log_format  main  '$remote_addr-$time_iso8601-$request_uri-$request-$status';
    access_log  /var/log/nginx/access.log  main;
    sendfile        on;
    #tcp_nopush     on;
    keepalive_timeout  65;
    #gzip  on;
    include /etc/nginx/conf.d/*.conf;
}

Nginx预定义了名为combined日志格式,如果没有明确指定日志格式默认使用该格式:

log_format combined '$remote_addr - $remote_user [$time_local] '
                    '"$request" $status $body_bytes_sent '
                    '"$http_referer" "$http_user_agent"';
  • 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/"

error_log

语法

配置错误日志文件的路径和日志级别。

error_log file [level];

level可以是debug, info, notice, warn, error, crit, alert,emerg中的任意值。可以看到其取值范围是按紧急程度从低到高排列的。只有日志的错误级别等于或高于level指定的值才会写入错误日志中。默认值是error。