【亲测免费】 NGINX Prometheus Exporter 安装与配置完全指南

项目基础介绍与编程语言

NGINX Prometheus Exporter 是一个用于监控 NGINX 和 NGINX Plus 的开源工具，它允许通过 Prometheus 监控系统收集这两个Web服务器的性能指标。此项目由 nginxinc 维护，并采用 Go 语言编写，确保了高效率和跨平台兼容性。

关键技术和框架

本项目的核心技术围绕着三个关键点：

• Prometheus: 一个流行的开源监控和告警系统，专注于收集时序数据。
• NGINX/NGINX Plus: 高性能的HTTP和反向代理服务器，广泛应用于网站和服务的负载均衡。
• Go语言: 开发环境，使得出口器能够高效处理指标收集和转换任务。

准备工作与详细安装步骤

环境需求

1. Prometheus: 确保已经安装并运行Prometheus服务。
2. NGINX 或 NGINX Plus: 需要配置好NGINX（需开启stub_status页面）或NGINX Plus（需开启API访问）。
3. Go环境（仅限自建二进制文件时需要）。

步骤一：获取项目源码或预编译版本

获取源码

如果你愿意从源码编译：

git clone https://github.com/nginxinc/nginx-prometheus-exporter.git
cd nginx-prometheus-exporter

使用预编译二进制

对于快速部署，可以直接下载对应的预编译版本，地址在项目的Release页。

步骤二：配置NGINX

• 对于 NGINX，编辑配置文件以公开stub_status页面，例如：

  server {
      listen 8080;
      location /stub_status {
          stub_status on;
          access_log off;
          allow 127.0.0.1; # 允许指定IP访问
          deny all;
      }
  }
  

• 对于 NGINX Plus，确保API接口是可用的。

步骤三：安装和配置Prometheus Exporter

使用Docker容器（推荐）

启动NGINX Prometheus Exporter的Docker容器，以监控NGINX为例：

docker run -p 9113:9113 nginx/nginx-prometheus-exporter:latest \
    --nginx.scrape-uri=http://你的NGINX主机IP:8080/stub_status

对于NGINX Plus，将URL替换为API地址：

docker run -p 9113:9113 nginx/nginx-prometheus-exporter:latest \
    --nginx.plus --nginx.scrape-uri=http://你的NGINX-Plus主机IP:8080/api

直接运行二进制文件（本地编译或下载）

首先，如果你是从源代码编译的，使用如下命令：

make build
./bin/nginx-prometheus-exporter --nginx.scrape-uri=http://你的NGINX主机IP:8080/stub_status

如果使用的是下载的二进制文件，则直接执行该二进制文件加上相应的参数即可。

步骤四：配置Prometheus

在Prometheus的配置文件中添加一个新的scrape_config来抓取NGINX Prometheus Exporter提供的/metrics路径。示例配置：

- job_name: 'nginx'
  static_configs:
  - targets: ['localhost:9113']

步骤五：验证

• 访问Prometheus UI，你应该能在目标列表中看到名为'nginx'的job，且状态为UP。
• 直接访问 http://localhost:9113/metrics 来查看导出的指标是否正确。

至此，您已完成NGINX Prometheus Exporter的安装与配置，开始享受对您的NGINX或NGINX Plus服务器的细致监控吧！

---

以上步骤为基于小白级别的操作指南，确保每一步都易于理解并执行。请注意，实际操作中，网络配置、安全设置以及环境变量等可能需要根据实际情况进行调整。