日志模块(Log)


·摘要

控制nginx如何记录请求日志。
例:
log_format gzip '$remote_addr - $remote_user [$time_local]  '
                '"$request" $status $bytes_sent '
                '"$http_referer" "$http_user_agent" "$gzip_ratio"';
 
access_log  /spool/logs/nginx-access.log  gzip  buffer=32k;
关于记录nginx错误日志请参考HTTP核心模块

·指令

access_log

语法:access_log path [format [buffer=size | off]]
默认值:access_log log/access.log combined
使用字段:http, server, location
参数为连接日志指定了路径,格式和缓冲区大小。使用“off”将在当前的字段中清除access_log的所有参数,如果没有指定日志格式,默认为“combined”。缓冲区大小不能超过写入磁盘文件的最小大小。
日志文件路径可以包含变量(0.7.4以上版本),但是有一些限制:

·nginx指定的用户必须有创建日志文件的权限。
·缓冲区不会工作
·每个到来的连接,日志文件将被打开并且在记录日志后迅速关闭,然而,频繁使用的文件描述符将被保存到open_log_file_cache中,关于日志的轮询记录,必须记住随着时间的过去(使用open_log_file_cache的valid参数设置),日志仍然在旧的文件中记录。
nginx支持为每个location指定强大的日志记录。同样的连接可以在同一时间输出到不止一个的日志中,更多信息请查看Multiple access_log directives in different contexts

log_format

语法:log_format name format [format ...]
默认值:log_format combined "..."
使用字段:http server
描述记录日志的格式,格式中可以使用大多数变量,也包括一些在写入日志文件过程中定义的变量:

·$body_bytes_sent,减去应答头后传送给客户端的字节数,这个变量兼容apache模块mod_log_config的%B参数(在0.3.10前这个变量为$apache_bytes_sent)。
·$bytes_sent,传送给客户端的字节数。
·$connection,连接数。
·$msec,正在写入日志条目的当前时间(精确到百万分之一秒)
·$pipe,如果请求为管道的
·$request_length,请求主体的长度。
·$request_time,从一个请求发出到而使nginx工作的时间,单位为毫秒(0.5.19版本后可以使用秒为单位)。
·$status,应答的状态(代码)。
·$time_local,写入普通日志格式的当地时间(服务器时间)。
传送到客户端的头中的变量以"sent_http_"标记开头,如:$sent_http_content_range。
注意其他模块产生的变量同样可以写入日志,例如你可以记录前端负载均衡应答头使用“upstream_http_”开头的变量,具体请查看负载均衡模块
nginx有一个预定的日志格式称为combined:
log_format combined '$remote_addr - $remote_user [$time_local]  '
                    '"$request" $status $body_bytes_sent '
                    '"$http_referer" "$http_user_agent"';

open_log_file_cache

语法:open_log_file_cache max=N [inactive=time] [min_uses=N] [valid=time] | off
默认值:open_log_file_cache off
使用字段:http server location
这个指令为频繁使用的日志文件描述符所在的路径变量设置缓存。
指令选项:

·max - 缓存中存储的最大文件描述符数。
·inactive - 设置缓存中在某个时间段内没有使用的文件描述符将被移除,默认为10秒。
·min_uses - 在一定时间内(inactive指定),一个文件描述符最少使用多少次后被放入缓存,默认为1。
·valid - 设置检查同名文件存在的时间,默认是60秒。
·off - 关闭缓存。

·参考文档

Original Documentation
Nginx Http Log Module

前进->Map模块(Map)