Web 服务器与网关 / 系统课时
Error Log 应该怎么看
Error Log 应该怎么看
访问日志里的 502 只说明响应失败,错误日志往往能指出连接哪个地址时发生了什么。本篇在隔离环境复现文件缺失和上游拒绝连接,按级别、请求上下文与具体操作阅读证据,再决定下一步检查。
学习目标
- 根据错误日志阈值理解哪些消息会被记录。
- 从文件操作和上游连接信息定位排查方向。
- 区分运行期请求错误与配置检查失败。
阈值控制记录范围
常见级别从低到高为 debug、info、notice、warn、error、crit、alert、emerg。配置 warn 会包含 warn 及更高严重程度,不包含 info。debug 的可用信息还受构建与调试配置影响,不能只改级别就假定能得到所有细节。
级别表达日志严重程度,不与 HTTP 状态一一对应:404 也可能伴随 error 级文件操作消息。error_log 可出现在不同上下文,先查看有效配置和实际路径,避免读到另一个站点或旧实例的文件。
在隔离服务制造两类失败
实验需要 Linux、curl、Nginx 1.28、空闲本机 8080,以及确认没有服务监听的 9001。先创建全新的 /tmp/nginx-error-lab/site 空目录,不在里面放 missing.txt。以下片段示例位于 http:
server {
listen 127.0.0.1:8080;
server_name error.test;
root /tmp/nginx-error-lab/site;
error_log /tmp/nginx-error-lab/error.log warn;
access_log /tmp/nginx-error-lab/access.log combined;
location /api/ { proxy_pass http://127.0.0.1:9001; }
location / { }
}检查并重载后执行;这些请求只发给实验站:
curl --noproxy '*' --resolve error.test:8080:127.0.0.1 -sS -o /dev/null -w 'status=%{http_code}\n' http://error.test:8080/missing.txt
curl --noproxy '*' --resolve error.test:8080:127.0.0.1 -sS -o /dev/null -w 'status=%{http_code}\n' http://error.test:8080/api/health
tail -n 20 /tmp/nginx-error-lab/error.log预期前两条输出:
status=404
status=502日志应分别出现 missing.txt 的 open 失败与上游连接拒绝;日期、PID、连接号和具体错误数字随环境变化。没有记录时先检查日志路径、继承、阈值及 log_not_found 设置。
读操作、路径与上下文
| 证据片段 | 含义 | 下一步 |
|---|---|---|
| open() failed,No such file | 所选路径没有文件或路径组件 | 核对 server、location、root/alias 与部署内容 |
| open() failed,Permission denied | 当前进程无法完成访问 | 核对 Worker 身份、每层目录权限及系统访问策略 |
| connect() failed,Connection refused | 目标端口拒绝连接 | 核对实际地址、监听、进程存活与网络命名空间 |
| upstream timed out | 某阶段超时 | 阅读 while 后阶段,结合上游与访问耗时排查 |
同一行还可能有 client、server、request、upstream、host。先用时间和请求目标对齐访问日志,再沿实际失败路径检查。连接拒绝不能直接证明后端代码有 bug;文件权限错误也不能靠 chmod 777 当作通用修复。
配置失败先看测试命令结果
缺少分号、未知指令、凭据读取失败等可能在 nginx -t 阶段报出 emerg,信息通常也显示在命令标准错误输出。配置测试失败时不要 reload;运行实例可能仍使用旧的有效配置。
阈值语义与配置范围见 Nginx error_log 文档。排查采用少量目标请求,记录错误原文与时刻;提高日志详细程度后还应评估写入量并恢复合适阈值。
错误日志未必覆盖业务失败原因,后端返回的业务 500 仍需应用日志。确认失败在哪一层后,再收集该层的请求标识、依赖与资源信息,避免把所有 5xx 都归因于 Nginx 配置。