全部產品
Search
文件中心

:Nginx組件接入

更新時間:Jul 06, 2024

可觀測監控 Prometheus 版提供一鍵安裝配置Nginx類型的組件,並提供開箱即用的專屬監控大盤。本文介紹舊版Nginx類型組件的安裝配置詳情。

背景資訊

  • 舊版Nginx類型組件安裝的是nginx-module-vts模組。

  • 舊版Nginx類型組件採集的Nginx指標如下表所示。

    指標

    類型

    描述

    nginx_server_requests

    Server

    Server請求數

    nginx_server_bytes

    Server

    Server位元組數

    nginx_server_cache

    Server

    Server緩衝

    nginx_filter_requests

    Filter

    Filter請求數

    nginx_filter_bytes

    Filter

    Filter位元組數

    nginx__filter_responseMsec

    Filter

    Filter回應時間

    nginx_upstream_requests

    Upstreams

    上行請求數

    nginx_upstream_bytes

    Upstreams

    上行位元組數

    nginx_upstream_responseMsec

    Upstreams

    上行回應時間

前提條件

您已成功安裝並運行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配置。更改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. 登入ARMS控制台

  2. 在左側導覽列選擇Prometheus監控 > 執行個體列表,進入可觀測監控 Prometheus 版的執行個體列表頁面。

  3. 單擊目標Prometheus執行個體名稱,進入整合中心頁面。

功能入口二:接入中心

  1. 登入ARMS控制台

  2. 在左側導覽列單擊接入中心,然後在組件應用地區單擊Nginx卡片的添加,然後在彈出的頁面根據控制台指引完成組件接入。

接入Nginx

這裡以從整合中心入口為例,介紹接入Nginx組件的操作,具體步驟如下。

  1. 接入Nginx組件。

    • 若您初次安裝Nginx類型的組件:

      在整合中心頁面單擊未安裝地區Nginx組件卡片的安裝at

    • 若您已安裝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等資訊。整合中心的更多資訊,請參見整合中心