全部产品
Search
文档中心

:Nginx(新)组件接入

更新时间:Oct 08, 2023

可观测监控 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类型的组件。

  1. 检查状态监控模块ngx_http_stub_status_module是否已安装。

    nginx -V 2>&1 | grep -o with-http_stub_status_module
    • 出现以下提示则表示已安装ngx_http_stub_status_module模块。cw_prom_exporter_nginx_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
  2. 启用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.1deny all表示仅允许本地访问。若需允许Nginx Exporter访问,则可将这两行代码注释,或者将127.0.0.1设置为Nginx Exporter的IP地址。

  3. 重启Nginx。

    nginx -t
    nginx -s reload 
  4. 可选:验证ngx_http_stub_status_module模块是否已成功启动。

    curl http://127.0.0.1/nginx_status

    出现以下提示则表示ngx_http_stub_status_module模块已成功启动。wo

步骤二:接入Nginx(新)

功能入口

功能入口一:集成中心

  1. 登录ARMS控制台
  2. 在左侧导航栏选择Prometheus监控 > Prometheus实例列表,进入可观测监控 Prometheus 版的实例列表页面。
  3. 单击目标Prometheus实例名称,进入集成中心页面。

功能入口二:接入中心

  1. 登录ARMS控制台

  2. 在左侧导航栏单击接入中心,然后在组件应用区域单击Nginx(新)卡片的添加,然后在弹出的页面根据控制台指引完成组件接入。

接入Nginx(新)

这里以从集成中心入口为例,介绍接入Nginx(新)组件的操作,具体步骤如下。

  1. 接入Nginx(新)组件。

    • 若您初次安装Nginx(新)类型的组件:

      在集成中心页面单击未安装区域Nginx(新)组件卡片的安装

    • 若您已安装Nginx(新)类型的组件,需要再次添加该组件:

      在集成中心页面单击已安装区域Nginx(新)组件卡片的添加

  2. STEP2区域的配置页签配置相关参数,并单击确定,完成组件接入。

    参数

    描述

    Exporter名称

    当前Nginx(新)监控唯一命名。命名规范要求如下:

    • 仅可包含小写字母、数字和短划线(-),且短划线不可出现在开头或结尾。

    • 名称具有唯一性。

    说明

    默认名称由组件类型及数字后缀组成。

    Nginx(新)地址

    Nginx的连接地址。

    Nginx(新)端口

    Nginx的端口号,例如:80。

    说明

    STEP2区域的指标页签可查看监控指标。

    已接入的组件会显示在集成中心页面的已安装区域。单击该组件卡片,在弹出的面板中可以查看Targets、指标、大盘、告警、服务发现配置、Exporter等信息。集成中心的更多信息,请参见集成中心