Nginx 中 access_log 配合 log_format 实现自定义格式记录-Nginx-PHP中文网

nginx通过log_format定义日志格式、access_log启用记录，支持自定义变量、缓冲、条件写入及多日志输出；需重载生效，注意变量拼写、权限与性能。

nginx 中 access_log 配合 log_format 实现自定义格式记录

Nginx 的 access_log 指令配合 log_format 可以灵活控制访问日志的输出内容和格式，满足调试、监控、审计等不同场景需求。

在 http 块中使用 log_format 定义日志模板，名称需唯一，后续通过名称引用：

格式名不能含空格或特殊字符，建议用下划线命名（如 main、with_time）
变量用 $ 开头，常见变量包括：$remote_addr（客户端IP）、$time_local（本地时间）、$request（完整请求行）、$status（响应状态码）、$body_bytes_sent（响应体字节数）、$http_user_agent（User-Agent）、$http_referer（来源页）
支持嵌套变量和条件判断（如 $upstream_http_x_trace_id 或 $sent_http_content_type），但需确保上游服务实际返回对应头

用 access_log 指令指定日志路径和使用的格式名，可同时配置缓冲、刷盘、条件记录等：

使用tbot机器ID身份文件配合tsh CLI，通过Teleport访问控制SSH登录托管主机或执行远程命令。

下载

基本写法：access_log /var/log/nginx/app.log with_time;
启用缓冲减少 I/O：access_log /var/log/nginx/app.log with_time buffer=64k;
按条件记录（如只记录非 200 响应）：access_log /var/log/nginx/error_access.log main if=$bad_request;，需提前定义 map 变量 $bad_request
多个 access_log 指令可共存，实现同一请求写入多份日志（如一份全量，一份仅错误）

根据典型需求快速复用：

带毫秒级时间戳与请求耗时：log_format detailed '$time_iso8601.$msec $remote_addr "$request" $status $body_bytes_sent "$http_referer" "$http_user_agent" $request_time $upstream_response_time';
JSON 格式（便于 ELK 或 Loki 解析）：log_format json '{"time":"$time_iso8601","remote":"$remote_addr","method":"$request_method","uri":"$request_uri","status":$status,"size":$body_bytes_sent,"ua":"$http_user_agent","rt":$request_time}';（注意：需确保字符串内无换行或未转义引号）
区分动静态资源：结合 location 块，在静态资源 location 中使用独立日志格式，避免混杂业务日志