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:

nginx
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 / { }
}

检查并重载后执行;这些请求只发给实验站:

bash
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

预期前两条输出:

text
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 配置。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

Error Log 应该怎么看

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通