### 如何在 Nginx 中使用 `log_format` 配置多个自定义日志格式 在 Nginx 的配置中，可以通过多次调用 `log_format` 指令来定义多个自定义日志格式。每种日志格式都需要有一个唯一的名称，并且可以在后续的 `access_log` 或其他日志相关指令中引用该名称。 以下是具体的说明和示例： #### 定义多个日志格式 `log_format` 是用于定义日志输出格式的指令，其语法如下： ```plaintext Syntax: log_format name [escape=default|json] string ...; Default: log_format combined "..."; Context: http ``` 通过重复声明 `log_format` 指令并赋予不同的名字，可以创建多种日志格式[^3]。例如，在 HTTP 块中定义两个不同类型的日志格式： ```nginx http { # 自定义第一个日志格式 log_format main '$remote_addr - $remote_user [$time_local] ' '"$request" $status $body_bytes_sent ' '"$http_referer" "$http_user_agent"'; # 自定义第二个日志格式 log_format custom_json escape=json '{' '"timestamp": "$time_iso8601", ' '"client_ip": "$remote_addr", ' '"method": "$request_method", ' '"uri": "$request_uri", ' '"status_code": "$status", ' '"response_size": "$body_bytes_sent", ' '"referer": "$http_referer", ' '"user_agent": "$http_user_agent"' '}'; } ``` 以上代码片段展示了两种日志格式：一种是传统的文本形式 (`main`)，另一种是以 JSON 形式存储的数据 (`custom_json`)。 #### 使用自定义日志格式 一旦定义了日志格式，就可以将其应用于特定的日志文件中。这通常是在 server 块或者 location 块中完成的。下面是一个例子，展示如何分别应用这两种日志格式到不同的日志文件中： ```nginx server { listen 80; server_name example.com; # 应用名为 "main" 的日志格式 access_log /var/log/nginx/access_main.log main; # 应用名为 "custom_json" 的日志格式 access_log /var/log/nginx/access_custom.json custom_json; location / { proxy_pass http://backend; } } ``` 在这个例子中，所有的请求都会被写入两份独立的日志文件 `/var/log/nginx/access_main.log` 和 `/var/log/nginx/access_custom.json`，它们各自采用之前定义的不同格式[^2]。 #### 注意事项 - **唯一性**：每个 `log_format` 名称在整个配置文件范围内都应该是独一无二的。 - **上下文限制**：`log_format` 只能在 `http` 上下文中定义[^3]。 - **性能影响**：复杂的日志格式可能会稍微增加 CPU 开销以及磁盘 I/O 负载，因此应谨慎设计日志字段的内容。 --- ### 示例代码总结 以下是一套完整的 Nginx 配置示例，演示如何定义和使用多个日志格式： ```nginx http { # 定义标准日志格式 log_format standard '$remote_addr - $remote_user [$time_local] ' '"$request" $status $body_bytes_sent ' '"$http_referer" "$http_user_agent"'; # 定义JSON格式化日志 log_format json escape=json '{' '"@timestamp":"$time_iso8601",' '"host":"$hostname",' '"clientip":"$remote_addr",' '"bytesSent":"$bytes_sent",' '"requestMethod":"$request_method",' '"requestURI":"$request_uri",' '"status":"$status",' '"userAgent":"$http_user_agent"' '}'; server { listen 80 default_server; # 将standard格式应用于此处 access_log /var/log/nginx/standard_access.log standard; # 同时启用另一个基于JSON的日志记录器 access_log /var/log/nginx/json_access.log json buffer=32k flush=5m; root /usr/share/nginx/html; index index.html index.htm; } } ``` ---