typedef struct ngx_log_s   ngx_log_t;
struct ngx_log_s {
    ngx_uint_t           log_level;        // 當(dāng)前日志級別
    ngx_open_file_t     *file;             // 日志文件描述符信息
    ngx_atomic_uint_t    connection;       // 連接數(shù)，用于限制日志輸出頻率
    time_t               disk_full_time;   // 磁盤寫滿時(shí)間戳
    ngx_log_handler_pt   handler;          // 自定義日志處理函數(shù)
    void                *data;             // handler 的上下文
    ngx_log_writer_pt    writer;           // 寫入函數(shù)指針（默認(rèn) ngx_log_write）
    void                *wdata;            // writer 的上下文
    char                *action;           // 當(dāng)前動作描述，如 "request line"
    ngx_log_t           *next;             // 下一個(gè)日志對象（鏈表）
};

typedef struct {
    ngx_fd_t              fd;
    ngx_str_t             name;
    u_char               *buffer;         // 日志寫入緩沖區(qū)
    u_char               *pos;
    u_char               *last;
    // … 其他 flags 等
} ngx_open_file_t;

#define ngx_log_error(level, log, ...)    \
    if ((log)->log_level >= level)        \
        ngx_log_error_core(level, log, __VA_ARGS__)
void ngx_log_error_core(ngx_uint_t level, ngx_log_t *log, ...);

static ngx_int_t
ngx_http_example_handler(ngx_http_request_t *r)
{
    ngx_log_t  *log;
    log = r->connection->log;
    ngx_log_error(NGX_LOG_INFO, log, 0,
                  "example module: request to \"%V\" started", &r->uri);
    // 業(yè)務(wù)邏輯 …
    ngx_log_error(NGX_LOG_ERR, log, 0,
                  "example module: something went wrong, status=%d",
                  r->headers_out.status);
    return NGX_OK;
}

2024/08/20 09:52:03 [error] 2345#0: *1024 connect() failed (111: Connection refused) while connecting to upstream, client: 192.168.1.1, server: localhost, request: "GET / HTTP/1.1", upstream: "http://127.0.0.1:8080/", host: "localhost"

typedef struct {
    ngx_array_t           *logs;           // ngx_http_log_t 數(shù)組（支持多個(gè)日志文件）
    ngx_open_file_cache_t *open_file_cache;
    ngx_uint_t             off;            // 是否關(guān)閉 access_log
} ngx_http_log_loc_conf_t;

typedef struct {
    ngx_open_file_t       *file;           // 打開的日志文件
    ngx_http_log_script_t *script;         // 日志格式編譯后的腳本
    time_t                 disk_full_time;
    time_t                 error_log_time;
    ngx_http_log_fmt_t    *format;         // 日志格式定義（if= 條件等）
    ngx_log_t             *log;            // 指向 error log（用于日志輸出錯(cuò)誤）
    unsigned               error:1;
    unsigned               filter:1;       // 是否啟用過濾
} ngx_http_log_t;

typedef struct {
    ngx_chain_t          *op;              // 編譯后的操作鏈
    ngx_array_t           ops;             // 原始操作數(shù)組
    ngx_array_t           args;            // 參數(shù)（變量名等）
    // ...
} ngx_http_log_fmt_t;

typedef struct {
    ngx_http_log_op_t          *op;        // 當(dāng)前操作
    ngx_str_t                  *name;      // 變量名稱
    ngx_http_variable_value_t  *value;     // 運(yùn)行時(shí)變量值
    uintptr_t                   text;      // 常量字符串指針
    size_t                      len;
} ngx_http_log_script_t;
typedef enum {
    ngx_http_log_op_text = 0,      // 固定文本
    ngx_http_log_op_var,           // 變量
    ngx_http_log_op_filter         // 過濾條件
} ngx_http_log_op_t;

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

127.0.0.1 - frank [20/Aug/2024:09:52:03 +0800] "GET /api HTTP/1.1" 200 2326 "https://example.com" "Mozilla/5.0 ..."

worker_processes  1;
error_log  logs/error.log  warn;   # 全局僅輸出警告及以上
events {
    worker_connections  1024;
}
http {
    log_format timing '$remote_addr - $remote_user [$time_local] '
                      '"$request" $status $body_bytes_sent '
                      '"$http_referer" "$http_user_agent" '
                      'rt=$request_time uct="$upstream_addr"';
    access_log  logs/access.log  timing;
    server {
        listen       80;
        server_name  example.com;
        # 為當(dāng)前虛擬主機(jī)打開 info 級別錯(cuò)誤日志
        error_log  logs/example_error.log  info;
        location / {
            root   html;
            index  index.html;
        }
        location /api {
            proxy_pass  http://backend;
            # 僅記錄狀態(tài)碼 >= 400 的請求到獨(dú)立文件
            access_log  logs/api_error.log  timing  if=$status >= 400;
        }
    }
}

http {
    log_format vhost '$host $remote_addr - $remote_user [$time_local] '
                     '"$request" $status $body_bytes_sent';
    server {
        listen       80;
        server_name  example.com www.example.com;
        # 利用 $host 變量自動分離日志文件
        access_log  logs/access_$host.log  vhost;
        error_log   logs/error_$host.log   warn;
    }
    server {
        listen       80;
        server_name  api.example.com;
        access_log  logs/access_api.log  vhost;
        error_log   logs/error_api.log   info;
    }
}