如何收集 NGINX 指標（第二篇）

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

如何獲取需要的指標取決於你正在使用的 NGINX 版本以及你希望看到哪些指標。（參見 如何監控 NGINX（第一篇） 來深入瞭解NGINX指標。）自由開源的 NGINX 和商業版的 NGINX Plus 都有可以報告指標度量的狀態模組，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 所提供。要檢查該模組是否已啟用，執行以下命令：

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

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

如果該命令沒有輸出，你需要啟用該狀態模組。你可以在從原始碼構建 NGINX 時使用 --with-http_stub_status_module 配置引數:

./configure \
… \
--with-http_stub_status_module
make
sudo make install

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

server {
    location /nginx_status {
        stub_status on;

        access_log off;
        allow 127.0.0.1;
        deny all;
    }
}

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

nginx -t 

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

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

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

nginx -s reload 

現在，你可以瀏覽狀態頁看到你的指標：

Active connections: 24 
server accepts handled requests
1156958 1156958 4491319
Reading: 0 Writing: 18 Waiting : 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 在狀態儀表盤中的“Active”連線的定義和開源 NGINX 透過 stubstatusmodule 收集的“Active”連線指標略有不同。在 NGINX Plus 指標中，“Active”連線不包括Waiting狀態的連線（即“Idle”連線）。

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

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

要啟動 NGINX Plus 指標儀表盤，你可以在 NGINX 配置檔案的 http 塊內新增狀態 server 塊。 (參見上一節，為收集開源版 NGINX 指標而如何查詢相關的配置檔案的說明。）例如，要設定一個狀態儀表盤 （http://your.ip.address:8080/status.html）和一個 JSON 介面（http://your.ip.address:8080/status），可以新增以下 server 塊來設定：

server {
    listen 8080;
    root /usr/share/nginx/html;

    location /status {
        status;
    }

    location = /status.html {
    }
}

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

nginx -s reload 

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

指標收集：NGINX 日誌

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

access_log logs/host.access.log combined;

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

nginx -s reload

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

127.0.0.1 - - [19/Feb/2015:12:10:46 -0500] "GET /index.html HTTP/1.1" 200 612 "-" "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"

127.0.0.1 - - [19/Feb/2015:12:11:05 -0500] "GET /fail HTTP/1.1" 404 570 "-" "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 塊新增一個新的日誌格式來記錄請求處理時間：

log_format nginx '$remote_addr - $remote_user [$time_local] '
                 '"$request" $status $body_bytes_sent $request_time '
                 '"$http_referer" "$http_user_agent"';

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

access_log logs/host.access.log nginx;

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

127.0.0.1 - - [19/Feb/2015:15:50:36 -0500] "GET /big.pdf HTTP/1.1" 206 33973115 0.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 的免費試用吧。

---

via: https://www.datadoghq.com/blog/how-to-collect-nginx-metrics/

作者：K Young 譯者：strugglingyouth 校對：wxy

本文由 LCTT 原創翻譯，Linux中國 榮譽推出