Nginx组件接入

前提条件

您已成功安装并运行Nginx服务，之后需要安装nginx-module-vts模块。安装nginx-module-vts模块的具体操作如下。

1. 下载nginx-module-vts模块。
   说明 git@github.com:vozlt/nginx-module-vts.git
2. 编译配置。
   1. 在nginx编译时添加nginx-module-vts模块。

      --add-module=/path/to/nginx-module-vts

   2. 下载官方软件包并编译进nginx-module-vts模块。

      ./configure --user=www --group=www --prefix=/usr/local/nginx --with-http_sysguard_module  --add-module=nginx-module-vts

3. 安装nginx-module-vts模块。

   make && make install

4. Nginx Conf配置。更改Nginx Conf的配置，并添加监控接口。

   http {
       vhost_traffic_status_zone;
           vhost_traffic_status_filter_by_host on;
   
       ...
   
       server {
   
           ...
   
           location /status {
               vhost_traffic_status_display;
               vhost_traffic_status_display_format html;
           }
       }
   }

   在配置文件中打开vhost过滤。

   vhost_traffic_status_filter_by_host on

   说明 开启此功能，当Nginx配置有多个server_name的情况下，系统会根据不同的server_name进行流量的统计，否则默认会把流量全部计算到第一个server_name上。

   若您不需要统计流量的server区域，可以执行如下命令禁用vhost_traffic_status。以下示例中的...部分是省略的内容。

   server {
   ...
   vhost_traffic_status off;
   ...
   }

5. 验证nginx-module-vts模板是否安装成功。

   curl http://127.0.0.1/status

功能入口

功能入口一：集成中心

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

功能入口二：接入中心

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

接入Nginx

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

1. 接入Nginx组件。
   • 若您初次安装Nginx类型的组件：
     在集成中心页面单击未安装区域Nginx组件卡片的安装。
   • 若您已安装Nginx类型的组件，需要再次添加该组件：

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

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

   参数	描述
   Exporter名称	当前Nginx监控唯一命名。命名规范要求如下： 仅可包含小写字母、数字和短划线（-），且短划线不可出现在开头或结尾。 名称具有唯一性。 说明 默认名称由组件类型及数字后缀组成。
   Nginx（旧）地址	Nginx的连接地址。
   Nginx（旧）端口	Nginx的端口号，例如：80。

   重要

   • 您需要先安装Nginx的监控模块nginx-module-vts：Nginx virtual host traffic status module，此模块可以提供JSON格式的数据产出。
   • 在STEP2区域的指标页签可查看监控指标。

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