Web 服务器与网关 / 系统课时

使用错误日志与状态指标

使用错误日志与状态指标

本课解决生产环境中如何通过 Nginx 自带观测能力快速判断请求异常、连接压力和运行状态的问题。学习完成后,可以配置错误日志、查看活动连接指标,并建立日志文件供轮转与采集系统使用。

学习目标

  • 理解 Nginx 错误日志级别与定位方法。
  • 使用 stub_status 获取基础运行指标。
  • 配置适合生产环境的日志文件管理策略。

配置错误日志进行故障定位

Nginx 错误日志记录启动失败、上游异常、权限错误和请求处理失败等关键事件。通过调整 error_log 的级别,可以控制记录详细程度,常用级别包括 error、warn、info 和 debug。

生产环境通常使用 warn 或 error,避免日志量过大影响磁盘和采集系统。排查复杂问题时,可以临时提高级别,定位完成后恢复默认配置。

nginx
http {
    # 生产环境保留告警和错误信息
    error_log /var/log/nginx/error.log warn;

    server {
        listen <PORT>;
        server_name example.com;
        access_log /var/log/nginx/access.log;
    }
}

预期结果

text
Nginx 启动后继续写入 /var/log/nginx/error.log
仅记录 warn 及以上级别事件

查看 Nginx 状态指标

Nginx 提供 stub_status 模块用于查看基础状态数据,包括当前活动连接数、已处理连接数和请求数量。它适合快速判断入口层是否存在连接堆积。

启用状态接口时,应限制访问来源,避免直接暴露运行信息。

nginx
server {
    listen <PORT>;

    location /nginx_status {
        stub_status;
        allow 127.0.0.1;
        deny all;
    }
}

验证接口:

bash
curl http://127.0.0.1:<PORT>/nginx_status

预期输出

text
Active connections: 3
server accepts handled requests
 1200 1200 5600
Reading: 0 Writing: 1 Waiting: 2

其中 Active connections 表示当前连接压力,Reading、Writing 和 Waiting 可以辅助判断请求处理状态。

管理日志轮转与采集

Nginx 日志文件会持续增长,生产环境需要配合日志轮转工具定期压缩和清理旧文件。轮转后通常需要让 Nginx 重新打开日志文件,避免继续写入旧句柄。

常见策略包括按日期切割、限制保存数量,并由日志采集系统读取新的文件。

bash
nginx -s reopen

预期结果

text
Nginx 重新打开日志文件
新的请求日志继续写入当前日志文件
按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

使用错误日志与状态指标

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

登录哪都通