一、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組件開始的一段配置信息。注意到這里定義了兩個輸出位置：

三、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函數在nginx中的應用。我們從ngx.log lua、ngx.log的輸出位置、ngx.log格式化輸出和ngx.log的使用建議四個方面進行了分析。掌握這些方面，可以幫助我們更好地使用ngx.log函數，對Nginx的日志輸出有更好的理解。