1. 程式人生 > >如何收集 NGINX 指標(第二篇)

如何收集 NGINX 指標(第二篇)

如何獲取你所需要的 NGINX 指標

如何獲取需要的指標取決於你正在使用的 NGINX 版本以及你希望看到哪些指標。(參見 如何監控 NGINX(第一篇) 來深入瞭解NGINX指標。)自由開源的 NGINX 和商業版的 NGINX Plus 都有可以報告指標度量的狀態模組,NGINX 也可以在其日誌中配置輸出特定指標:

指標可用性

accepts(接受) / accepted(已接受) x x
handled(已處理) x x
dropped(已丟棄) x x
active(活躍) x x
requests (請求數)/ total(全部請求數) x x
4xx 程式碼 x x
5xx 程式碼 x x
request time(請求處理時間) x

指標收集:NGINX(開源版)

開源版的 NGINX 會在一個簡單的狀態頁面上顯示幾個與伺服器狀態有關的基本指標,它們由你啟用的 HTTP stub status module所提供。要檢查該模組是否已啟用,執行以下命令:

  1. nginx -V 2>&1| grep -o with-http_stub_status_module

如果你看到終端輸出了 httpstubstatus_module,說明該狀態模組已啟用。

如果該命令沒有輸出,你需要啟用該狀態模組。你可以在從原始碼構建 NGINX 

時使用 --with-http_stub_status_module 配置引數:

  1. ./configure \

  2. \

  3. --with-http_stub_status_module

  4. make

  5. sudo make install

在驗證該模組已經啟用或你自己啟用它後,你還需要修改 NGINX 配置檔案,來給狀態頁面設定一個本地可訪問的 URL(例如: /nginx_status):

  1. server {

  2. location /nginx_status {

  3. stub_status on;

  4. access_log off;

  5. allow 127.0.0.1;

  6. deny all

    ;

  7. }

  8. }

注:nginx 配置中的 server 塊通常並不放在主配置檔案中(例如:/etc/nginx/nginx.conf),而是放在主配置會載入的輔助配置檔案中。要找到主配置檔案,首先執行以下命令:

  1. nginx -t

開啟列出的主配置檔案,在以 http 塊結尾的附近查詢以 include 開頭的行,如:

  1. include /etc/nginx/conf.d/*.conf;

在其中一個包含的配置檔案中,你應該會找到主 server 塊,你可以如上所示配置 NGINX 的指標輸出。更改任何配置後,通過執行以下命令重新載入配置檔案:

  1. nginx -s reload

現在,你可以瀏覽狀態頁看到你的指標:

  1. Active connections:24

  2. server accepts handled requests

  3. 115695811569584491319

  4. Reading:0Writing:18Waiting:6

請注意,如果你希望從遠端計算機訪問該狀態頁面,則需要將遠端計算機的 IP 地址新增到你的狀態配置檔案的白名單中,在上面的配置檔案中的白名單僅有 127.0.0.1。

NGINX 的狀態頁面是一種快速檢視指標狀況的簡單方法,但當連續監測時,你需要按照標準間隔自動記錄該資料。監控工具箱Nagios 或者 Datadog,以及收集統計資訊的服務 collectD 已經可以解析 NGINX 的狀態資訊了。

指標收集: NGINX Plus

商業版的 NGINX Plus 通過它的 ngxhttpstatus_module 提供了比開源版 NGINX 更多的指標。NGINX Plus 以位元組流的方式提供這些額外的指標,提供了關於上游系統和快取記憶體的資訊。NGINX Plus 也會報告所有的 HTTP 狀態碼型別(1XX,2XX,3XX,4XX,5XX)的計數。一個 NGINX Plus 狀態報告例子可在此檢視

NGINX Plus status board

注:NGINX Plus 在狀態儀表盤中的“Active”連線的定義和開源 NGINX 通過 stubstatusmodule 收集的“Active”連線指標略有不同。在 NGINX Plus 指標中,“Active”連線不包括Waiting狀態的連線(即“Idle”連線)。

NGINX Plus 也可以輸出 JSON 格式的指標,可以用於整合到其他監控系統。在 NGINX Plus 中,你可以看到 給定的上游伺服器組的指標和健康狀況,或者簡單地從上游伺服器的單個伺服器得到響應程式碼的計數:

  1. {"1xx":0,"2xx":3483032,"3xx":0,"4xx":23,"5xx":0,"total":3483055}

  1. server {

  2. listen 8080;

  3. root /usr/share/nginx/html;

  4. location /status {

  5. status;

  6. }

  7. location =/status.html {

  8. }

  9. }

當你重新載入 NGINX 配置後,狀態頁就可以用了:

  1. nginx -s reload

關於如何配置擴充套件狀態模組,官方 NGINX Plus 文件有 詳細介紹 。

指標收集:NGINX 日誌

NGINX 的 日誌模組 會把可自定義的訪問日誌寫到你配置的指定位置。你可以通過新增或移除變數來自定義日誌的格式和包含的資料。要儲存詳細的日誌,最簡單的方法是新增下面一行在你配置檔案的 server 塊中(參見上上節,為收集開源版 NGINX 指標而如何查詢相關的配置檔案的說明。):

  1. access_log logs/host.access.log combined;

更改 NGINX 配置檔案後,執行如下命令重新載入配置檔案:

  1. nginx -s reload

預設包含的 “combined” 的日誌格式,會包括一系列關鍵的資料,如實際的 HTTP 請求和相應的響應程式碼。在下面的示例日誌中,NGINX 記錄了請求 /index.html 時的 200(成功)狀態碼和訪問不存在的請求檔案 /fail 的 404(未找到)錯誤。

  1. 127.0.0.1--[19/Feb/2015:12:10:46-0500]"GET /index.html HTTP/1.1"200612"-""Mozilla/5.0 (Macintosh; Intel Mac OS X 10_10_1) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/40.0.2214.111 Safari 537.36"

  2. 127.0.0.1--[19/Feb/2015:12:11:05-0500]"GET /fail HTTP/1.1"404570"-""Mozilla/5.0 (Macintosh; Intel Mac OS X 10_10_1) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/40.0.2214.111 Safari/537.36"

你可以通過在 NGINX 配置檔案中的 http 塊新增一個新的日誌格式來記錄請求處理時間:

  1. log_format nginx '$remote_addr - $remote_user [$time_local] '

  2. '"$request" $status $body_bytes_sent $request_time '

  3. '"$http_referer" "$http_user_agent"';

並修改配置檔案中 server 塊的 access_log 行:

  1. access_log logs/host.access.log nginx;

重新載入配置檔案後(執行 nginx -s reload),你的訪問日誌將包括響應時間,如下所示。單位為秒,精度到毫秒。在這個例子中,伺服器接收到一個對 /big.pdf 的請求時,傳送 33973115 位元組後返回 206(成功)狀態碼。處理請求用時 0.202 秒(202毫秒):

  1. 127.0.0.1--[19/Feb/2015:15:50:36-0500]"GET /big.pdf HTTP/1.1"206339731150.202"-""Mozilla/5.0 (Macintosh; Intel Mac OS X 10_10_1) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/40.0.2214.111 Safari/537.36"

你可以使用各種工具和服務來解析和分析 NGINX 日誌。例如,rsyslog 可以監視你的日誌,並將其傳遞給多個日誌分析服務;你也可以使用自由開源工具,比如 logstash 來收集和分析日誌;或者你可以使用一個統一日誌記錄層,如 Fluentd 來收集和解析你的 NGINX 日誌。

結論

監視 NGINX 的哪一項指標將取決於你可用的工具,以及監控指標所提供的資訊是否滿足你們的需要。舉例來說,錯誤率的收集是否足夠重要到需要你們購買 NGINX Plus ,還是架設一個可以捕獲和分析日誌的系統就夠了?

在 Datadog 中,我們已經集成了 NGINX 和 NGINX Plus,這樣你就可以以最小的設定來收集和監控所有 Web 伺服器的指標。在本文中瞭解如何用 NGINX Datadog 來監控 ,並開始 Datadog 的免費試用吧。