Linux Nginx 怎么使用 log_format 自定义日志输出格式-Nginx-PHP中文网

log_format指令用于定义nginx访问日志格式，须置于http块中，通过access_log引用；支持内置变量（如$remote_addr、$status）、普通文本及转义双引号，名称需合法且唯一。

linux nginx 怎么使用 log_format 自定义日志输出格式

在 Nginx 中，log_format 指令用于定义访问日志的输出格式，它必须写在 http 块中，然后通过 access_log 指令引用生效。自定义格式的关键是组合内置变量（如 $remote_addr、$time_local 等），并控制字段分隔、引号、空格等细节。

定义 log_format 的基本语法

格式为：
log_format 名称 "字段1 字段2 ...";
名称不能含空格和特殊字符（建议用下划线），引号内是实际日志内容，支持任意文本和变量。

变量以 $ 开头，例如 $status 表示 HTTP 状态码，$body_bytes_sent 表示响应体字节数
普通字符串（如 "["、" - "）直接写在引号内，注意保留空格或符号位置
可嵌套双引号，但需用反斜杠转义，如 "\"$http_user_agent\""
一个配置中可定义多个 log_format，但名称不能重复

常用变量与实用格式示例

以下是一个兼顾可读性与调试需求的常用格式：

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

$remote_addr：客户端真实 IP（若前端有代理，需配合 set_real_ip_from 和 real_ip_header 使用）
$request：完整请求行，如 GET /api/v1/users HTTP/1.1
$http_referer 和 $http_user_agent：带双引号包裹，避免日志解析错位
$request_time：整个请求处理耗时（秒，精度毫秒），由 Nginx 计算
$upstream_response_time：后端响应耗时（多个 upstream 用逗号分隔），仅在 proxy_pass 场景有效

在 server 或 location 中启用自定义日志

定义好格式后，需在 server 或 location 块中用 access_log 指定路径和格式名：

Zynq Linux Hardware Debug

Zynq‑7000 / Zynq UltraScale+ 硬件调试技能。适用于 Xilinx Zynq（Cortex‑A9/A53 + FPGA）Linux 环境，调试 I2C、I2S、UART、GPIO 等外设。包括设备树配置、内核驱动、用户空间调试工具、交叉编译和常见问题排查，支持 PetaLinux 开发。

下载

server {
    listen 80;
    server_name example.com;
<pre class="brush:php;toolbar:false;">access_log /var/log/nginx/example_access.log main;  # 引用名为 "main" 的格式
error_log  /var/log/nginx/example_error.log warn;

location / {
    proxy_pass http://backend;
}

}

路径必须有写入权限（通常属主为 nginx 或 www-data）
同一 server 内可为不同 location 设置不同日志格式和路径，例如 API 接口单独记录详细耗时
若省略格式名，默认使用预设的 combined 格式

验证与调试技巧

修改配置后务必检查语法并重载：

运行 nginx -t 确认配置无误
执行 nginx -s reload 生效（不中断服务）
用 tail -f /var/log/nginx/xxx.log 实时观察新格式是否输出正确
发起一次请求（如 curl -I http://localhost），检查日志行是否包含预期字段，特别留意引号、空格、缺失值（如 $remote_user 为空时显示 “-”）
若某些变量始终为空（如 $http_x_forwarded_for），确认对应请求头确实存在且未被过滤