Prometheus Hetzner Cloud SD 镜像文档

镜像概述

该镜像提供一个服务器程序，用于自动发现Hetzner Cloud账户中的节点资源，并以Prometheus服务发现(SD)兼容格式输出节点信息，帮助用户简化Prometheus监控目标的配置流程。

核心功能与特性

• 自动节点发现：实时探测Hetzner Cloud账户中的节点资源
• Prometheus兼容：输出符合Prometheus服务发现标准的格式数据
• 多部署方式：支持容器化部署，提供多平台镜像
• 轻量高效：基于Go语言构建，资源占用低，性能高效
• 灵活配置：通过环境变量自定义服务参数

适用场景

适用于使用Hetzner Cloud作为基础设施且采用Prometheus进行监控的用户，尤其适合节点动态变化的环境，可自动同步节点列表，减少手动维护Prometheus监控目标的工作量。

使用方法

镜像获取

***容器镜像托管于以下平台，可根据需求选择：

• GitHub Container Registry (GHCR): ghcr.io/promhippie/prometheus-hcloud-sd
• Docker Hub: promhippie/prometheus-hcloud-sd
• Quay.io: quay.io/promhippie/prometheus-hcloud-sd

基本部署示例（Docker）

使用Docker运行服务，需配置Hetzner Cloud API令牌以授权访问账户资源：

bash
docker run -d \
  --name prometheus-hcloud-sd \
  -p 9000:9000 \
  -e HCLOUD_API_TOKEN="your-hetzner-cloud-api-token" \
  ghcr.io/promhippie/prometheus-hcloud-sd

关键配置参数

通过环境变量进行服务配置，常用参数如下：

Prometheus集成配置

在Prometheus配置文件中添加HTTP服务发现配置，指向本服务的SD端点：

yaml
scrape_configs:
  - job_name: 'hetzner_cloud_nodes'
    http_sd_configs:
      - url: '[***]  # 容器名或服务IP需根据实际环境调整
    relabel_configs:
      - source_labels: [__meta_hcloud_public_ipv4]
        action: replace
        target_label: __address__
        replacement: '${1}:9100'  # 假设节点暴露9100端口（node-exporter）

镜像来源与支持

• 项目源码：GitHub
• 问题反馈：通过GitHub Issues提交
• 许可证：Apache-2.0

作者信息

• Thomas Boerger (GitHub)