log_format指令用于定义Nginx访问日志格式，须置于http块中，通过access_log引用；支持内置变量（如$remote_addr、$status）、普通文本及转义双引号，名称需合法且唯一。
在 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），确认对应请求头确实存在且未被过滤
