Nginx模块参考手册:日志模块(Log)

这些模块默认会全部编译进Nginx,除非手工指定某个模块在configure时排除。

控制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核心模块(error_log)。

指令

access_log

语法:access_log path [format [buffer=size | off]]
默认值:access_log log/access.log combined
使用字段:http, server, location
参数为连接日志指定了路径,格式和缓冲区0.5.html">大小。使用“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 - 关闭缓存。

时间: 2024-08-04 03:28:03

Nginx模块参考手册:日志模块(Log)的相关文章

Nginx模块参考手册:User ID模块(User ID)

这些模块默认会全部编译进Nginx,除非手工指定某个模块在configure时排除. 模块ngx_http_userid_module为连接发布cookie,主要使用$uid_got和$uid_set变量,注意:$uid_got和$uid_set无法在SSI中取得,因为SSI过滤模块工作在userid模块过滤之前.这个模块相当于Apache的mod_uid模块.示例配置: userid on;userid_name uid;userid_domain example.com;userid_pat

Nginx模块参考手册:URL重写模块(Rewrite)

这些模块默认会全部编译进Nginx,除非手工指定某个模块在configure时排除. 这个模块允许使用正则表达式重写URI(需PCRE库),并且可以根据相关变量重定向和选择不同的配置.如果这个指令在server字段中指定,那么将在被请求的location确定之前执行,如果在指令执行后所选择的location中有其他的重写规则,那么它们也被执行.如果在location中执行这个指令产生了新的URI,那么location又一次确定了新的URI.这样的循环可以最多执行10次,超过以后nginx将返回5

Nginx模块参考手册:Gzip Precompression模块(Gzip Precompression)

如果要使用这些模块,则必须在编译时指定相关的编译参数. 这个模块在一个预压缩文件传送到开启Gzip压缩的客户端之前检查是否已经存在以".gz"结尾的压缩文件,这样可以防止文件被重复压缩.这个模块在0.6.24后可用,如果要使用它则需要在编译时指定如下参数: ./ configure --with-http_gzip_static_module 示例配置: gzip_static on; gzip_http_version 1.1;gzip_proxied expired no-cach

Nginx模块参考手册:主模块(Main Module)

摘要 包含一些Nginx的基本控制功能 指令 daemon 语法:daemon on | off默认值:on daemon off; 生产环境中不要使用"daemon"和"master_process"指令,这些指令仅用于开发调试.虽然可以使用daemon off在生产环境中,但对性能提升没有任何帮助,但是在生产环境中永远不要使用master_process off. env 语法:env VAR|VAR=VALUE默认值:TZ使用字段:main这个命令允许其限定一

Nginx模块参考手册:事件模块(Events Module)

摘要 控制Nginx处理连接的方式 指令 accept_mutex 语法:accept_mutex [ on | off ] 默认值:on Nginx使用连接互斥锁进行顺序的accept()系统调用 accept_mutex_delay 语法:accept_mutex_delay Nms; 默认值:500ms如果一个进程没有互斥锁,它将至少在这个值的时间后被回收,默认是500ms debug_connection 语法:debug_connection [ip | CIDR] 默认值:none

Nginx模块参考手册:Map模块(Map)

这些模块默认会全部编译进Nginx,除非手工指定某个模块在configure时排除. 这个模块允许你分类或者同时映射多个值到多个不同值并储存到一个变量中,map指令用来创建变量,但是仅在变量被接受的时候执行视图映射操作,对于处理没有引用变量的请求,这个模块并没有性能上的缺失. 如下例: map $http_host $name { hostnames; default 0; example.com 1; *.example.com 1; test.com 2; *.test.com 2; .si

Nginx模块参考手册:HTTP核心模块(HTTP Core)

这些模块默认会全部编译进Nginx,除非手工指定某个模块在configure时排除. 摘要 Nginx处理HTTP的http://www.aliyun.com/zixun/aggregation/17626.html">核心功能模块 指令 aio 语法:aio [on|off|sendfile] 默认值:off使用字段:http, server, location这个指令在Linux内核2.6.1922以上版本可以使用,对于Linux内核,这个指令需要配合directio指令,使用这个指令

Nginx模块参考手册:Secure Link模块(Secure Link)

如果要使用这些模块,则必须在编译时指定相关的编译参数. 这个模块为一个必需的安全性令牌检查请求网址.要使用这个模块必须在编译时指定下列编译参数(0.7.18后版本可用): --with-http_secure_link_module 示例配置: location /prefix/ { secure_link_secret secret_word; #如果哈希不正确$secure_link将为一个空字符串. if ($secure_link = "") { return 403; } #

Nginx模块参考手册:HTTP Referer模块(HTTP Referer)

这些模块默认会全部编译进Nginx,除非手工指定某个模块在configure时排除. 当一个请求头的http://www.aliyun.com/zixun/aggregation/16918.html">Referer字段中包含一些非正确的字段,这个模块可以禁止这个请求访问站点.这个头可以随意的伪造,因此,使用这个模块并不能100%的阻止这些请求,绝大多数拒绝的请求来自一些典型的浏览器,可以认为这些典型的浏览器并不能提供一个"Referer"头,甚至是那些正确的请求.如