可观测监控 Prometheus 版提供一键安装配置Nginx类型的组件，并提供开箱即用的专属监控大盘。本文介绍新版Nginx类型组件的安装配置详情。
前提条件
您已成功安装并运行Nginx服务。背景信息
- Nginx状态监控模块ngx_http_stub_status_module是统计Nginx服务所接收和处理的请求数量的模块。
- 新版Nginx类型Exporter安装的是ngx_http_stub_status_module模块。
- 新版Nginx类型Exporter采集的Nginx指标如下表所示。
指标 描述 nginx_connections_accepted 接受的客户端连接总数 nginx_connections_active 当前客户端连接数 nginx_connections_handled Handled状态的连接数 nginx_connections_reading 读取客户端的连接数 nginx_connections_waiting 等待中的客户端连接数 nginx_connections_writing 回写客户端的连接数 nginx_http_requests_total 客户端请求总数 nginx_up Nginx Exporter是否正常运行 nginxexporter_build_info Nginx Exporter的构建信息
步骤一：安装ngx_http_stub_status_module模块
如果您的Nginx服务运行在云服务器ECS，则按照以下步骤安装Nginx类型的组件。
- 检查状态监控模块ngx_http_stub_status_module是否已安装。
nginx -V 2>&1 | grep -o with-http_stub_status_module- 出现以下提示则表示已安装ngx_http_stub_status_module模块。
- 若未出现以上提示，则说明未安装ngx_http_stub_status_module模块，可执行以下命令安装此模块。
wget http://nginx.org/download/nginx-1.13.12.tar.gz tar xfz nginx-1.13.12.tar.gz cd nginx-1.13.12/ ./configure --with-http_stub_status_module make make install
- 出现以下提示则表示已安装ngx_http_stub_status_module模块。
- 启用ngx_http_stub_status_module模块查询Nginx状态。
location /nginx_status { stub_status on; allow 127.0.0.1; #only allow requests from localhost deny all; #deny all other hosts }说明- Location地址请严格命名为
nginx_status。 allow 127.0.0.1和deny all表示仅允许本地访问。若需允许Nginx Exporter访问，则可将这两行代码注释，或者将127.0.0.1设置为Nginx Exporter的IP地址。
- Location地址请严格命名为
- 重启Nginx。
nginx -t nginx -s reload - 可选：验证ngx_http_stub_status_module模块是否已成功启动。
curl http://127.0.0.1/nginx_status出现以下提示则表示ngx_http_stub_status_module模块已成功启动。
步骤二：接入Nginx（新）
功能入口
功能入口一：集成中心
- 登录Prometheus控制台。
- 在左侧导航栏单击监控列表，进入可观测监控 Prometheus 版的实例列表页面。
- 单击目标Prometheus实例名称，进入集成中心页面。
功能入口二：接入中心
- 登录ARMS控制台。
- 在左侧导航栏单击接入中心，然后在组件应用区域单击Nginx（新）卡片的添加，然后在弹出的页面根据控制台指引完成组件接入。
接入Nginx（新）
这里以从集成中心入口为例，介绍接入Nginx（新）组件的操作，具体步骤如下。
- 接入Nginx（新）组件。
- 若您初次安装Nginx（新）类型的组件：
在集成中心页面单击未安装区域Nginx（新）组件卡片的安装。
- 若您已安装Nginx（新）类型的组件，需要再次添加该组件：
在集成中心页面单击已安装区域Nginx（新）组件卡片的添加。
- 若您初次安装Nginx（新）类型的组件：
- 在STEP2区域的配置页签配置相关参数，并单击确定，完成组件接入。
参数 描述 Exporter名称 当前Nginx（新）监控唯一命名。命名规范要求如下： - 仅可包含小写字母、数字和短划线（-），且短划线不可出现在开头或结尾。
- 名称具有唯一性。
说明 默认名称由组件类型及数字后缀组成。Nginx（新）地址 Nginx的连接地址。 Nginx（新）端口 Nginx的端口号，例如：80。 说明 在STEP2区域的指标页签可查看监控指标。已接入的组件会显示在集成中心页面的已安装区域。单击该组件卡片，在弹出的面板中可以查看Targets、指标、大盘、告警、服务发现配置、Exporter等信息。集成中心的更多信息，请参见集成中心。