Ngx_lua_reqstatus 项目常见问题解决方案

Ngx_lua_reqstatus 项目常见问题解决方案

ngx_lua_reqstatus 实时统计 nginx 状态的 lua 拓展 项目地址: https://gitcode.com/gh_mirrors/ng/ngx_lua_reqstatus

项目基础介绍

Ngx_lua_reqstatus 是一个用于实时统计 Nginx 状态的 Lua 扩展。它可以监控 Nginx 域名的 QPS（每秒查询率）、5xx 错误数量以及响应时长等信息。项目主要使用 Lua 语言编写，同时包含少量的 Python 代码用于辅助开发。

主要编程语言

• Lua（53.9%）
• Python（46.1%）

新手常见问题及解决方案

问题一：如何配置 Nginx 支持 ngx_lua_reqstatus？

问题描述：安装 ngx_lua_reqstatus 后，无法在 Nginx 中正常使用。

解决步骤：

1. 确保已经正确安装了 LuaJIT 和 Nginx。
2. 在 Nginx 配置文件中添加 ngx_lua_reqstatus 模块路径：

   lua_package_path "/path/to/ngx_lua_reqstatus/?.lua;;";
   

3. 在 Nginx 服务器块中添加监控服务的配置：

   server {
       listen 127.0.0.1:6080;
       location /status {
           content_by_lua_file "/path/to/ngx_lua_reqstatus/status.lua";
       }
   }
   

4. 重启 Nginx 服务。

问题二：如何查看域名的 QPS、5xx 错误数量和响应时长？

问题描述：配置完成后，无法获取到域名相关的监控数据。

解决步骤：

1. 在 Nginx 的配置文件中，为需要监控的域名添加如下配置：

   server {
       listen 80;
       server_name your_domain.com;
       location / {
           log_by_lua_file "/path/to/ngx_lua_reqstatus/hook.lua";
       }
   }
   

2. 使用 curl 命令查看监控数据：

   curl http://localhost:6080/domain=your_domain.com
   

3. 查看输出结果，其中包含了 QPS、5xx 错误数量和响应时长等信息。

问题三：如何修改监控数据的存储路径？

问题描述：默认的监控数据存储路径不满足需求，需要修改。

解决步骤：

1. 打开 hook.lua 文件，找到如下代码：

   local statics_dict = ngx.shared.stastics_dict
   

2. 修改 statics_dict 变量的值为新的存储路径：

   local statics_dict = ngx.shared.new("new_path_to_stastics_dict", 1 << 20)
   

3. 重启 Nginx 服务，使修改生效。

ngx_lua_reqstatus 实时统计 nginx 状态的 lua 拓展 项目地址: https://gitcode.com/gh_mirrors/ng/ngx_lua_reqstatus