prometheus監(jiān)控nginx的實(shí)現(xiàn)步驟

更新時(shí)間：2026年05月09日 09:40:48 作者：**Cara**

本文主要介紹了prometheus監(jiān)控nginx的實(shí)現(xiàn)步驟,文中通過示例代碼介紹的非常詳細(xì),對(duì)大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價(jià)值,需要的朋友們下面隨著小編來一起學(xué)習(xí)學(xué)習(xí)吧

方式一：nginx-module-vts 方式（推薦，無需額外 exporter）

1. 環(huán)境準(zhǔn)備與依賴安裝

# 1. 安裝基礎(chǔ)依賴
yum -y install gcc-c++ pcre pcre-devel zlib zlib-devel openssl openssl-devel git wget
# 2. 創(chuàng)建工作目錄
mkdir -p /opt/nginx-install && cd /opt/nginx-install
# 3. 下載 Nginx 1.24.0 和 nginx-module-vts 模塊
wget http://nginx.org/download/nginx-1.24.0.tar.gz
git clone git://github.com/vozlt/nginx-module-vts.git
# 4. 解壓 Nginx 源碼包
tar -zxvf nginx-1.24.0.tar.gz
mv nginx-module-vts /usr/local/nginx-module-vts

GitHub 的 git 協(xié)議（git://）可能被防火墻攔截，換成 HTTPS 協(xié)議，同時(shí)使用國(guó)內(nèi)鏡像源（如 GitHub 鏡像站）：

# 1. 先刪除失敗的空目錄（如果有）
rm -rf nginx-module-vts
# 2. 使用 HTTPS 協(xié)議克?。▋?yōu)先）
git clone https://github.com/vozlt/nginx-module-vts.git
# 如果依然失敗，使用國(guó)內(nèi)鏡像站（如 gitee 鏡像）
git clone https://gitee.com/mirrors/nginx-module-vts.git

2. 編譯安裝 Nginx（帶 vts 模塊）

# 進(jìn)入 Nginx 源碼目錄
cd /opt/nginx-install/nginx-1.24.0
# 配置編譯參數(shù)（指定安裝路徑 + 加載 vts 模塊）
./configure --prefix=/usr/local/nginx --add-module=/usr/local/nginx-module-vts/
# 編譯并安裝（-j 后接CPU核心數(shù)，加快編譯速度，比如 -j4）
make -j4 && make install
# 驗(yàn)證模塊是否加載成功
/usr/local/nginx/sbin/nginx -V | grep nginx-module-vts
# 輸出包含 --add-module=/usr/local/nginx-module-vts/ 即表示成功

3. 配置 Nginx 開啟狀態(tài)監(jiān)控

# 備份原有配置文件
cp /usr/local/nginx/conf/nginx.conf /usr/local/nginx/conf/nginx.conf.bak
# 編輯 Nginx 主配置文件
cat > /usr/local/nginx/conf/nginx.conf << 'EOF'
worker_processes  1;
events {
    worker_connections  1024;
}
http {
    include       mime.types;
    default_type  application/octet-stream;
    # 開啟 vts 狀態(tài)監(jiān)控區(qū)域
    vhost_traffic_status_zone;
    sendfile        on;
    keepalive_timeout  65;
    server {
        listen       80;
        server_name  localhost;
        # 配置狀態(tài)監(jiān)控接口
        location /status {
            vhost_traffic_status_display;
            vhost_traffic_status_display_format html;
        }
        location / {
            root   html;
            index  index.html index.htm;
        }
        error_page   500 502 503 504  /50x.html;
        location = /50x.html {
            root   html;
        }
    }
}
EOF
# 啟動(dòng)/重啟 Nginx
/usr/local/nginx/sbin/nginx -t  # 驗(yàn)證配置文件
/usr/local/nginx/sbin/nginx     # 啟動(dòng)
# 如果已啟動(dòng)，執(zhí)行重啟：/usr/local/nginx/sbin/nginx -s reload
# 驗(yàn)證狀態(tài)頁(yè)面是否可訪問
curl http://172.16.213.29/status          # 查看 HTML 格式狀態(tài)
curl http://172.16.213.29/status/format/prometheus  # 查看 Prometheus 格式指標(biāo)

4. 配置 Prometheus 采集 Nginx 指標(biāo)

# 備份 Prometheus 配置文件
cp /usr/local/prometheus/prometheus.yml /usr/local/prometheus/prometheus.yml.bak
# 編輯 Prometheus 配置，添加 Nginx 采集任務(wù)
sed -i '/scrape_configs:/a\  - job_name: "nginx"\n    metrics_path: /status/format/prometheus\n    static_configs:\n      - targets: ["172.16.213.29"]' /usr/local/prometheus/prometheus.yml
# 驗(yàn)證配置文件
/usr/local/prometheus/promtool check config /usr/local/prometheus/prometheus.yml
# 重啟 Prometheus（根據(jù)你的啟動(dòng)方式選擇，以下是 systemd 方式示例）
systemctl restart prometheus
# 如果是直接啟動(dòng)，先殺死進(jìn)程再重啟：
# ps -ef | grep prometheus | grep -v grep | awk '{print $2}' | xargs kill
# /usr/local/prometheus/prometheus --config.file=/usr/local/prometheus/prometheus.yml &

方式二：nginx-prometheus-exporter 方式（官方推薦，更簡(jiǎn)單）

1. 確保 Nginx 已開啟 stub_status 模塊

# 編輯 Nginx 配置，開啟 stub_status
cp /usr/local/nginx/conf/nginx.conf /usr/local/nginx/conf/nginx.conf.bak
sed -i '/server {/a\        location /basic_status {\n            stub_status on;\n            allow 127.0.0.1;\n            allow 172.16.213.0/24;\n            deny all;\n        }' /usr/local/nginx/conf/nginx.conf
# 驗(yàn)證配置并重啟
/usr/local/nginx/sbin/nginx -t
/usr/local/nginx/sbin/nginx -s reload
# 驗(yàn)證 stub_status 是否可用
curl http://172.16.213.29/basic_status
# 正常輸出示例：
# Active connections: 1 
# server accepts handled requests
#  1 1 1 
# Reading: 0 Writing: 1 Waiting: 0

2. 用 Docker 運(yùn)行 nginx-prometheus-exporter

# 拉取官方鏡像
docker pull nginx/nginx-prometheus-exporter:latest
# 啟動(dòng) exporter（關(guān)聯(lián) Nginx 的 stub_status 地址）
docker run -d --name nginx-exporter \
  -p 9113:9113 \
  nginx/nginx-prometheus-exporter:latest \
  --nginx.scrape-uri=http://172.16.213.29/basic_status
# 驗(yàn)證 exporter 是否正常輸出指標(biāo)
curl http://172.16.213.29:9113/metrics

3. 配置 Prometheus 采集 exporter 指標(biāo)

# 編輯 Prometheus 配置，添加 exporter 采集任務(wù)
sed -i '/scrape_configs:/a\  - job_name: "nginx-exporter"\n    static_configs:\n      - targets: ["172.16.213.29:9113"]' /usr/local/prometheus/prometheus.yml
# 驗(yàn)證配置并重啟 Prometheus
/usr/local/prometheus/promtool check config /usr/local/prometheus/prometheus.yml
systemctl restart prometheus

總結(jié)

nginx-module-vts 方式：無需額外運(yùn)行 exporter，直接通過 Nginx 自身模塊暴露 Prometheus 格式指標(biāo)，指標(biāo)更豐富（支持虛擬主機(jī)、upstream 等）。
nginx-prometheus-exporter 方式：官方維護(hù)，部署更簡(jiǎn)單，僅依賴 Nginx 原生的 stub_status 模塊，適合基礎(chǔ)監(jiān)控需求。
核心驗(yàn)證步驟：確保 Nginx 狀態(tài)接口可訪問 → Prometheus 配置正確 → Prometheus 頁(yè)面能看到 nginx 或 nginx-exporter 任務(wù)狀態(tài)為 UP。

執(zhí)行完上述命令后，你可以在 Prometheus Web UI（默認(rèn) http://prometheus服務(wù)器IP:9090）的「Targets」頁(yè)面查看 Nginx 采集任務(wù)是否正常，也可以通過「Graph」頁(yè)面查詢 Nginx 相關(guān)指標(biāo)（如 nginx_connections_active、nginx_requests_total 等）。

正確的驗(yàn)證操作

1. 用瀏覽器訪問 Prometheus UI

在你的電腦（能訪問 192.168.52.129 的機(jī)器）上打開瀏覽器，輸入：http://192.168.52.129:9090/targets

你會(huì)看到 Prometheus 的 Targets 頁(yè)面，里面會(huì)列出 3 個(gè)采集任務(wù)：prometheus、redis、nginx_vts
檢查nginx_vts的狀態(tài)：
- 如果顯示UP：說明采集成功
- 如果顯示DOWN：大概率是 Prometheus 訪問 Nginx 時(shí)的網(wǎng)絡(luò)問題（但你 curl 能通，大概率是 UP）

2. 驗(yàn)證是否采集到 Nginx 指標(biāo)

在瀏覽器中訪問：http://192.168.52.129:9090/graph

在輸入框中輸入指標(biāo)名：nginx_vts_main_connections
點(diǎn)擊Execute按鈕，就能看到 Nginx 的連接數(shù)指標(biāo)數(shù)據(jù)（如果能看到，說明采集成功）

到此這篇關(guān)于prometheus監(jiān)控nginx的實(shí)現(xiàn)步驟的文章就介紹到這了,更多相關(guān)prometheus監(jiān)控nginx內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！

您可能感興趣的文章: