深入理解ngx.log

一、ngx.log lua

ngx.log(ngx.ERR, 'Log message')

ngx.log是nginx的内置函数，可用于在nginx的错误日志中记录自定义日志。ngx.log接受两个参数，第一个参数是一个日志级别，可以是debug、info、notice、warn、error或crit。第二个参数是一个日志信息字符串。ngx.log支持使用变量和Lua表达式引用来定制日志消息，这是通过将消息作为一个格式化的字符串来完成的。

在Lua代码中使用ngx.log函数时，可以使用常量作为第一个参数中的日志级别，或者可以使用整数进行替代。在大多数情况下，建议使用常量。

local log_level = ngx.ERR
ngx.log(log_level, 'Log message')

ngx.log的第一个参数是日志级别。默认情况下，Nginx记录所有的错误消息。您可以通过编辑您的Nginx配置文件的error_log指令来控制记录级别。

error_log logs/error.log notice;

二、ngx.log的输出位置

ngx.log的日志输出位置可以通过配置文件指定。下面是一段示例代码，分别演示了ngx.log的三个不同输出位置：

http {
    log_format main '$remote_addr - $remote_user [$time_local] '
                  '"$request" $status $body_bytes_sent '
                  '"$http_referer" "$http_user_agent" '
                  '"$gzip_ratio"';

    server {
        listen       80;
        server_name  localhost;

        access_log logs/access.log main;
        error_log logs/error.log notice;

        location / {
            proxy_pass http://127.0.0.1:9080;
        }
    }
}

上面的配置文件为主配置文件，定义了从http组件开始的一段配置信息。注意到这里定义了两个输出位置：

access_log：记录HTTP请求的详细信息，例如客户端IP地址、浏览器类型等信息。 error_log：记录与服务相关的错误和异常，例如非法请求、超时错误等。

三、ngx.log格式化输出

local headers = ngx.req.get_headers()
ngx.log(ngx.ERR, 'User agent: ', headers["user-agent"])

正如之前提到的，ngx.log支持使用变量和Lua表达式来定制日志消息。实际上，ngx.log内部使用的就是Lua的string.format函数进行格式化。下面的示例演示了如何使用格式化输出来输出客户端IP地址。

local client_ip = ngx.var.remote_addr
ngx.log(ngx.ERR, 'Client IP address: %s', client_ip)

使用格式化输出，可以轻松地以更具可读性的方式输出日志信息。

四、ngx.log的使用建议

在使用ngx.log时需要注意以下几点：

避免在高负载服务器上记录过多的日志信息，这可能会影响服务器性能。 在生产服务器上记录日志时，应该尽可能的减少使用ngx.log。相反，应该对代码进行仔细的测试，以便在运行时发现任何潜在的错误和异常。 当记录日志时，应该提高日志记录级别。这样可以减轻服务器的负载压力，并保持服务器性能的稳定性。

五、小结

本文详细讲解了ngx.log函数在nginx中的应用。我们从ngx.log lua、ngx.log的输出位置、ngx.log格式化输出和ngx.log的使用建议四个方面进行了分析。掌握这些方面，可以帮助我们更好地使用ngx.log函数，对Nginx的日志输出有更好的理解。