nginx的日志配置


1. nginx中日志的种类

nginx中可以记录的日志主要有access日志、error日志和rewrite日志。前两种由ngx_http_log_module模块予以支持,rewrite日志则由ngx_http_rewrite_module模块提供,这两个模块默认都已包含且启用。

2.nginx中日志的作用

  • access日志
    记录nginx处理的请求的过程,包含请求类型、时间、客户端信息、处理结果、处理时长等信息,具体可以通过log_format指令引用特定变量来记录相关信息。

  • error日志
    记录nginx进程启动、停止、重启及处理请求过程中发生的错误信息。

  • rewrite日志
    记录rewrite规则工作的过程,可以用于调试rewrite规则。

3. nginx中日志的配置

  • access日志
    默认情况下就会自动记录access日志,默认存放路径为/usr/local/nginx/logs/access.log
    配置层级:http、server、location、if in location、limit_except。
    配置指令:
    access_log path [format [buffer=size [flush=time]]];
    access_log path format gzip[=level] [buffer=size] [flush=time];
    access_log syslog:server=address[,parameter=value] [format];
    access_log off;
    配置指令说明:

  • path 用于指定access日志存放的路径,需要确保nginx worker process运行的身份对此路径有写权限。

  • format 实际是引用的log_format指令定义好的日志格式模板名称。

  • buffer 用来设置内存中用于存放缓存日志的缓存大小。

  • gzip 表示日志在写入磁盘中时调用gzip进行压缩,level用于指定压缩级别,压缩后的日志文件可以用zcat查看其内容。

  • flush 设置日志保存在缓存中的最长时间。

  • syslog 用于将access日志写入syslog日志中,server用于指定syslog server的地址。如access_log syslog:server=127.0.0.1,facility=local7,tag=nginx,severity=info;

  • off 表示关闭access日志,不记录任何access信息。

  • access日志的格式
    nginx提供了log_format指令用于自定义access日志的格式,它统一在http层级进行配置。
    配置指令:
    log_format name string ...;
    默认值:log_format combined ...;
    默认情况下,只要不明确指定access_log off;,nginx就会使用默认的combined格式记录access日志。
    配置指令说明:
    name 用户自定义的日志格式模板名称。
    string 可以调用很多变量来表示记录哪些字段到日志中。
    默认的combined格式如下:

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

**log_format可使用的变量: **

变量名 含义
$remote_addr 记录客户端IP地址
$http_x_forwarded_for 当nginx处于负载均衡器,squid,反向代理之后时,需要这个字段才能记录用户的实际IP地址
$remote_user 记录客户端用户名称,针对启用了用户认证的请求进行记录
$request 记录用户请求的URL
$status 记录请求结果状态码
$body_bytes_sent 发送给客户端的字节数,不包括响应头的大小
$bytes_sent 发送给客户端的总字节数
$connection 连接的序列号
$msec 日志写入时间,单位为秒,精度是毫秒
$pipe 如果请求是通过http流水线发送,则其值为"p",否则为“."
$http_referer 记录从哪个页面链接过来的
$http_user_agent 记录客户端浏览器相关信息
$request_length 请求的长度(包括请求行,请求头和主体)
$request_time 请求处理时长,单位为秒,精度为毫秒,从读入客户端的第一个字节开始,直到把最后一个字符发送张客户端进行日志写入为止
$time_iso8601 标准格式下的本地时间,形如“2017-05-24T18:31:27+08:00”
$time_local 通过日志格式下的本地时间,形如“24/May/2017:18:31:27 +0800”
  • open_log_file_cache指令
    对于每一条日志 记录都是需要先打开文件再写入日志,然后关闭,可以使用open_log_file_cache来设置日志文件缓存(默认是off)。它可以配置在http、server、location层级之中。
    配置语法:
    open_log_file_cache max=N [inactive=time] [min_uses=N] [valid=time];
    默认值: open_log_file_cache off;
    参数解释:
    max:设置缓存中最大文件描述符数量,如果被占满,采用LRU算法将描述符关闭。
    inactive:设置缓存存活时间,默认是10s。
    min_uses:设置在inactive时间段内,日志文件最少使用多少次后,该日志文件描述符记入缓存中,默认是1次。
    valid:设置检查频率,默认是60s。
    off:禁用缓存。
    示例:
    open_log_file_cache max=1000 inactive=20s valid=1m min_uses=2;

  • log_not_found指令
    这一指令的作用是配置是否将not found错误记录到error_log中。默认值on,即记录至error_log中。可以在http、server、location层级配置。
    配置 指令: log_not_found on|off;

  • log_subrequest指令
    这一指令配置是否在access_log中记录子请求的访问日志 ,默认为不记录。同样也是在http、server、location层级配置 。
    配置语法: log_subrequest on|off;

  • rewrite_log指令
    这一指令是用来记录重写日志的,默认关闭,启用以后会将重写日志记录到error_log中,也是配置在http、server、location层级中。
    配置语法: rewrite_log on|off;

  • error_log指令
    这一指令用于指定记录的错误日志级别,它可以配置在main、http、server、location层级之中。
    配置语法:
    error_log file|stderr|syslog:server=address[,parameter=value] [debug|info|notice|warn|error|crit|alert|emerg];
    默认值:error_log logs/error.log error;

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 206,968评论 6 482
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 88,601评论 2 382
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 153,220评论 0 344
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 55,416评论 1 279
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 64,425评论 5 374
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 49,144评论 1 285
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 38,432评论 3 401
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 37,088评论 0 261
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 43,586评论 1 300
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 36,028评论 2 325
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 38,137评论 1 334
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,783评论 4 324
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 39,343评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 30,333评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,559评论 1 262
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 45,595评论 2 355
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,901评论 2 345

推荐阅读更多精彩内容