跳转至

📅 Prometheus 服务器安装指南

📝 概述

提供两种部署 Prometheus 服务器的方式:

  1. 手动下载安装脚本并配置环境变量
  2. 使用 EdgeHit Controller 预配置的安装脚本

两种方式均会调用基础安装脚本:

https://files.ops2.net/edgehit/prod/prometheus/deploy/install.sh
EdgeHit Controller 预配的脚本会设置环境变量,然后执行以上脚本。

重要说明

Node-Exporter 组件在 EdgeHit Controller 和 Load Proxy 上均启用了 HTTP 认证,Prometheus 服务器需配置对应的预共享密钥(PSK)才能采集监控数据


环境变量参考(install-prometheus.sh)

Variable Configured Value
DASH_SERVER_DOMAIN EdgeHit Controller 安装时配置的域名=
DASH_HTTP_AUTH_PASS EdgeHit Controller 节点 Node-Exporter 认证密钥
EDGE_HTTP_AUTH_PASS Load Proxy 节点 Node-Exporter 认证密钥
PROM_SERVER_DOMAIN 默认为 DASH_SERVER_DOMAIN 数值

!!! info “特别注意” 若 Prometheus 未部署在 EdgeHit Controller 上,必须修改 PROM_SERVER_DOMAIN 为实际部署域名

建议优先使用 EdgeHit Controller 自动生成的安装脚本以:

  • ✔️ 预配置完整环境变量
  • ✔️ 确保与控制面板的兼容性
  • ✔️ 避免手动配置错误
  • ✔️ 内置标准化安装流程


🪜 安装步骤

  1. 域名预配置

    install-prometheus.sh 默认假设 Prometheus 服务器将部署在 EdgeHit Controller 上。在生产环境中,您需要将环境变量修改为指向实际目标安装服务器的域名。

    冗余监控目标场景说明

    该安装脚本本身包含 Node-Exporter 的安装。如果将 Prometheus 服务器安装在 EdgeHit Controller 上,会导致同一台服务器上运行两个 Node-Exporter 实例

    参考以下需要修改的脚本参数配置:

    环境变量 参数值说明
    PROM_SERVER_DOMAIN 填写实际部署的目标服务器域名


    2. 传输安装脚本

    本地执行
    scp /path/to/local/destination/install-prometheus.sh root@<Target>:~/  
    

  2. 执行脚本

    chmod 700 ./install-prometheus.sh
    ./install-prometheus.sh
    

    • 安装完成后将在 /usr/local/edgehit/prometheus/ 目录下生成以下关键文件:

          prometheus/
          ├──.env
          ├──install-info.txt
          ├──compose.yml
          ├──bin/
          │ ├── bash Scripts
          │ └── more bash Scripts 
          │ └── .....
      

    • .env 包含所有秘密配置参数

    • install-info.txt 记录默认管理员账号密码及安装域名


安装完成后,您需要进行以下初始化配置:

  1. Prometheus 服务配置
  2. Grafana 仪表板设置

具体配置方法详见 Prometheus 监控目标配置 章节