「Nginx」- 在日志路径中,使用变量

更新日期:2019年07月10日

access_log (ngx_http_log_module)

在 access_log 中,使用变量:

access_log /home/me/sites/${server_name}.access.log;

但是,需要从(0.7.6+)以后,并且存在限制(参考「access_log」手册):
1)日志文件用“工作进程”创建,所以需要在日志目录有创建文件的权限。
2)无法使用写入缓冲。
3)由于经常使用的文件描述符会被缓存,在指令 open_log_file_cache 的参数 valid 指定的时间内,还会写入旧文件中。
4)每次写入日志时,会检查 root 目录是否存在。不存在,则不会创建日志。

error_log (ngx_core_module)

对于 error_log 属性,官方手册的「error_log」上没提可以使用变量。

# 07/10/2019 Nginx error log won't read variable - 不支持
# 07/10/2019 #562 closed enhancement (invalid) - 不支持

根据官方的说法:
1)这是故意这个设计的。变量只在 HTTP 请求中可用,而 error_log 不限于HTTP请求。
2)错误日志是非常重要的。必须保证可用。例如,当解析 /path/$var/error.log$var 变量出错(比如内存分配)时,应该在哪里记录错误日志呢?
3)可以考虑在非 main 块以外的上下文中支持变量。

我们的方案

对于这两个日志文件,我们直接进行硬编码(因为,一个不好,一个不行)。在 Nginx variable expansion in error_log for virtual hosts/servers 中,作者也解释了,这没什么必要。

如果想要使用这种方式,建议进行性能测试,评估没有写入缓存经常打开和关闭文件等等这些限制对性能的影响。

参考文献

Module ngx_http_log_module/access_log
Module ngx_http_log_module/open_log_file_cache
Variables in log name - nginx
Core functionality/error_log
Nginx error log won't read variable
#562 closed enhancement (invalid)
Nginx variable expansion in error_log for virtual hosts/servers


ToC

access_log (ngx_http_log_module)

error_log (ngx_core_module)

我们的方案

参考文献