Web 服务器与网关 / 系统课时
Access Log 一行都记录了什么
Access Log 一行都记录了什么
访问日志通常在请求处理结束时写入,记录来源、请求目标、状态与发送量。本篇生成一条可核对的本机请求,拆开 combined 格式中的字段,区分真实连接信息与客户端自报内容,为后续故障排查准备可靠证据。
学习目标
- 读懂 combined 格式中最常用的字段。
- 对照实际请求验证状态、请求目标与正文发送字节数。
- 识别代理来源、客户端头和日志敏感信息的边界。
先产生一条已知请求
实验需要 Linux、curl、Nginx 1.28 及空闲的本机 8080。以下只准备本次实验目录,若已有同名数据,先选择新目录并同步修改配置:
# 使用三字节文件,便于核对发送量。
mkdir -p /tmp/nginx-log-lab/site
printf 'ok\n' > /tmp/nginx-log-lab/site/ok.txt预期结果:ok.txt 包含 ok 与换行。确保 Master 可打开日志,Worker 可读取文件及经过父目录;不能为了解决日志权限问题把整个站点设为所有人可写。
以下片段示例放入 http 上下文,依赖上述路径:
server {
listen 127.0.0.1:8080;
server_name log.test;
root /tmp/nginx-log-lab/site;
access_log /tmp/nginx-log-lab/access.log combined;
location / { }
}检查并重载成功后执行:
curl --noproxy '*' --resolve log.test:8080:127.0.0.1 -A 'lab-client' -sS 'http://log.test:8080/ok.txt?lang=zh'
tail -n 1 /tmp/nginx-log-lab/access.log预期 curl 输出 ok 与换行;稍后日志出现一条含 GET /ok.txt?lang=zh HTTP/1.1、状态 200、正文大小 3 和 lab-client 的记录。日志写入可能略晚于客户端显示;本例没有显式缓冲,但不能用一次空的 tail 就判断访问未发生。
按字段拆开 combined 格式
下面是一条结构示意,时间与环境字段不代表本机实际值:
127.0.0.1 - - [10/Oct/2026:12:00:00 +0800] "GET /ok.txt?lang=zh HTTP/1.1" 200 3 "-" "lab-client"| 字段 | 含义与边界 |
|---|---|
| 127.0.0.1 | remote_addr,当前连接来源;经过代理时可能是代理地址 |
| 两个短横线 | combined 的固定分隔占位与未取得的 remote_user;不是两种错误码 |
| 方括号时间 | time_local,含时区,跨机器比较先统一时间 |
| 引号内请求行 | 方法、原请求目标与协议,查询参数也可能出现在其中 |
| 200 | 最终响应状态,不能据此断言业务数据正确 |
| 3 | body_bytes_sent,不含响应头,不等于整个网络连接字节数 |
| 最后两项 | Referer 与 User-Agent,本例 Referer 未提供,二者都能由客户端自报 |
若启用压缩、HEAD 或特殊响应,发送正文大小不应机械等同于磁盘文件大小。combined 的字段定义见 Nginx 访问日志文档。
访问日志与错误日志相互补充
访问日志回答哪次请求、状态怎样;错误日志解释某些失败的具体原因。404 可能是 Nginx 文件查找,也可能来自后端;只看访问日志状态无法区分。
同一请求内部跳转后,日志按处理最终结束的 location 配置写入,不能总在最初匹配的 location 寻找它。检查 nginx -T 输出中的实际 access_log、off、条件记录和日志路径,输出可能包含敏感配置,应在受控环境查看。
轮转或启用缓冲时,还要核对文件句柄重开与 flush 策略。不要把“当前文件暂时没有新行”立即解释为没有流量。
日志字段也需要隐私与信任边界
原始请求目标可能含令牌、个人信息与搜索词,Referer 也可能携带敏感地址。根据实际需求选择记录 $uri 而非完整请求目标,设置访问权限与保留周期,不额外记录 Cookie、Authorization 或完整请求体。
来源头未经可信代理恢复时,不应当作真实客户端地址;User-Agent 只能提供线索。排查时用时间、目标、状态及后续增加的请求标识联合定位,保留证据原文,避免凭单个自报字段作确定判断。