阿里云Prometheus监控提供一键安装配置Nginx类型Exporter的功能，并提供开箱即用的专属监控大盘。本文介绍新版Nginx类型Exporter的安装配置详情。

前提条件

您已成功安装并运行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类型的Exporter。

  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.1和deny 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模块已成功启动。cw_prom_exporter_nginx_module_success

步骤二：安装新版Nginx类型的Exporter

  1. 登录ARMS控制台。
  2. 在左侧导航栏单击Prometheus监控。
  3. 在页面左上角选择目标地域，然后单击目标K8s集群名称。
  4. 在左侧导航栏单击Exporter接入。
  5. 在Exporter接入页面，单击右上角的添加Exporter。
  6. 在Exporter列表对话框右上角的搜索框中，输入要添加的Exporter名称，并在筛选结果中单击目标Exporter图标。
  7. 在Nginx(V2) Exporter配置对话框的配置页签输入各项参数，并单击确定。
    参数 描述
    Exporter名称 Exporter的名称命名规范要求如下：
    • 仅可包含小写字母、数字和短划线（-），且短划线不可出现在开头或结尾。
    • 名称具有唯一性。
    默认名称由Exporter类型及数字后缀组成。
    Nginx(v2) 地址 Nginx的连接地址。
    Nginx(v2) 端口 Nginx的端口号，例如：80。
  8. 在Exporter接入页面，单击面板列的大盘链接，查看Prometheus监控大盘。
    pg_prom_dashboard_Nginx
  9. 可选：在Exporter接入页面，可对已添加的Exporter执行以下操作：
    • 单击操作列的删除，可删除已添加的Exporter。
    • 单击操作列的日志，可查看Exporter的运行日志。
    • 单击操作列的详情，可查看Exporter的详情，包括Exporter的环境变量和描述信息。