promhippie/prometheus-vcd-sd

Prometheus VMWare vCloud Director SD

镜像概述和主要用途

该项目提供一个服务器工具，用于自动发现VMWare vCloud Director账户中的节点资源，并以Prometheus服务发现(SD)兼容的格式输出节点信息。通过此工具，Prometheus可自动识别并监控vCloud Director环境中的节点，无需手动配置监控目标，简化监控流程。

核心功能和特性

• 自动节点发现：扫描并发现VMWare vCloud Director账户中的节点资源
• Prometheus兼容输出：以Prometheus SD兼容格式（如JSON）提供节点信息，支持直接集成到Prometheus
• 多平台部署支持：提供容器化镜像，发布于GHCR、Docker Hub、Quay等主流容器仓库
• 灵活安装选项：除容器外，还支持二进制文件、DEB/RPM包等多种安装方式

使用场景和适用范围

适用于采用VMWare vCloud Director管理虚拟化环境，并使用Prometheus进行监控的场景。特别适合节点动态变化的环境，通过自动发现功能减少手动维护Prometheus监控目标的工作量，确保监控覆盖的实时性和准确性。

使用方法和配置说明

容器镜像获取

工具镜像发布于以下平台，可按需选择：

• GHCR: ghcr.io/promhippie/prometheus-vcd-sd
• Docker Hub: promhippie/prometheus-vcd-sd
• Quay: quay.io/promhippie/prometheus-vcd-sd

Docker部署示例

基本运行命令

bash
docker run -d --name prometheus-vcd-sd \
  -p 9000:9000 \
  -e VCD_URL="https://vcloud.example.com" \
  -e VCD_USER="admin@org" \
  -e VCD_PASSWORD="your-secure-password" \
  -e VCD_ORG="your-organization" \
  ghcr.io/promhippie/prometheus-vcd-sd:latest

参数说明

访问与集成

服务启动后，可通过 http://<容器IP>:9000/sd 端点获取Prometheus SD格式的节点列表。在Prometheus配置中添加以下内容即可集成：

yaml
scrape_configs:
  - job_name: 'vcd-nodes'
    file_sd_configs:
      - files:
          - 'http_sd_configs'
    http_sd_configs:
      - url: 'http://prometheus-vcd-sd:9000/sd'

开发与扩展

如需参与开发，需配置Go环境（>= 1.24.0）及go-task构建工具。源码托管于GitHub，开发流程如下：

bash
git clone https://github.com/promhippie/prometheus-vcd-sd.git
cd prometheus-vcd-sd
task generate build
./bin/prometheus-vcd-sd -h

安全与许可

• 安全报告：发现安全问题请联系 thomas@webhippie.de
• 许可证：Apache-2.0
• 版权：Copyright (c) 2018 Thomas Boerger <***>