Nginx变量

Nginx的log模块是很多人做日志输出的首选切入点。

Nginx默认access_log语法写入服务器本地路径或NFS,用于以后的汇总分析;在此基础上,Tengine增强了日志目标,可以通过组合管道功能或syslog接口进行远程集中日志存储。

log功能的核心是变量。灵活而全面的变量定义是Nginx日志模块的优势体现。 在2011年时曾经整理过一些核心变量的意义,主要是第一种类型的核心变量。 最近两年核心模块进行过比较大的变动,涌现出比较多的优秀第三方模块,也出现了Tengine/OpenResty这样优秀的第三方发行版,变量的定义大大丰富。

Nginx变量包括:

  1. 核心模块提供了足够的变量定义(Embedded Variables);
  2. 通过rewrite模块的set语法自定义变量(rewrite#set);
  3. 第三方模块提供额外的变量定义(使用ngx_http_add_variable设置一系列ngx_http_variable_t的变量);
  4. 通过第三方模块做变量内容变换/改写(如agentzh/set-misc-nginx-module)。

在这种情况下做一个变量大全需要一定的工作量,根据实际使用情况去查阅各类模块的文档是个捷径。如果有人整理过也请告诉我。

log_unescape

在实际使用中会遇到一个问题关于日志中被转义的字符,比如输出一段json数据,其中的引号会被转义。这种转义规则参考了apache httpd的习惯。早在2008年就有讨论。Nginx官方社区对此问题的态度是继续保留转义。

在实际使用中,查看和处理转义过的字符串带来一些负担,在权衡中选择不做转义也经常是一种选择。Tengine在2012年将log_unescape的功能加入,可以打开/关闭转义功能,或者仅针对ASCII字符,方便大规模日志处理。

当然escape问题并不只出现在log阶段,比如这里,解决方法也不一定都是修改nginx代码或配置——在分析端做转义处理也是一种可行的思路。


公众号推荐

知识分享行动
每天 10:24
只聊技术细节
扫码立即参与
知识分享行动