promhippie/hcloud-exporter

Hetzner Cloud Exporter

概述

Hetzner Cloud Exporter是一个为https://prometheus.io设计的指标导出器，用于从Hetzner Cloud平台收集监控指标。它能够将Hetzner Cloud的资源状态、性能数据等转换为Prometheus兼容的格式，便于集成到监控系统中，支持通过容器、二进制文件、DEB/RPM包等多种方式部署。

核心功能与特性

• Hetzner Cloud指标收集：从Hetzner Cloud API获取资源指标，包括服务器、网络、存储、负载均衡等资源的状态及性能数据。
• Prometheus兼容：提供标准的Prometheus metrics端点，支持Prometheus直接抓取指标并集成到现有监控体系。
• 多部署方式支持：提供容器镜像（发布于GHCR、Docker Hub、Quay等仓库）、预编译二进制文件及DEB/RPM包，满足不同环境部署需求。
• 轻量高效：基于Go语言开发，资源占用低，适合在各类环境中稳定运行。

使用场景与适用范围

• Hetzner Cloud资源监控：适用于需要监控Hetzner Cloud基础设施（如虚拟机、网络组件、存储卷、数据库等）的场景。
• Prometheus监控集成：无缝对接Prometheus监控系统，满足DevOps、SRE团队对云资源状态、性能的实时监控需求。
• 自动化运维与告警：配合Prometheus Alertmanager可实现基于Hetzner Cloud指标的告警机制，提升资源异常响应效率。

使用方法与配置说明

镜像获取

Hetzner Cloud Exporter的Docker镜像托管在多个平台，可通过以下仓库拉取：

• GHCR：ghcr.io/promhippie/hcloud_exporter
• Docker Hub：promhippie/hcloud-exporter
• Quay：quay.io/promhippie/hcloud-exporter

基本部署（Docker Run）

使用Docker部署时，需配置Hetzner Cloud API令牌（必需）及可选参数（如监听地址、端口等）。

必要环境变量

• HCLOUD_TOKEN：Hetzner Cloud API访问令牌，需具有资源读取权限（可在Hetzner Cloud控制台“API令牌”部分创建）。

部署命令示例

bash
docker run -d \
  --name hcloud-exporter \
  -p 9501:9501 \
  -e HCLOUD_TOKEN="your-hetzner-cloud-api-token" \
  ghcr.io/promhippie/hcloud_exporter:latest

参数说明

• -p 9501:9501：将容器内默认监听端口（9501）映射到主机，Prometheus通过此端口抓取指标。
• 可选命令行参数：可通过-h查看所有参数，例如--web.listen-address=":9501"指定监听地址和端口，--log.level=info设置日志级别（支持debug/info/warn/error）。

Docker Compose配置

创建docker-compose.yml文件，示例如下：

yaml
version: '3.8'

services:
  hcloud-exporter:
    image: ghcr.io/promhippie/hcloud_exporter:latest
    container_name: hcloud-exporter
    restart: unless-stopped
    ports:
      - "9501:9501"
    environment:
      - HCLOUD_TOKEN=your-hetzner-cloud-api-token  # 替换为实际API令牌
    command: --log.level=info  # 可选：设置日志级别

启动服务：

bash
docker-compose up -d

指标访问与Prometheus配置

指标端点

部署后，可通过http://<主机IP>:9501/metrics访问导出的指标，例如：

hcloud_server_status{id="12345", name="server-01", status="running"} 1
hcloud_volume_size{id="67890", name="volume-01", size_gb="50"} 50

Prometheus抓取配置

在Prometheus配置文件中添加如下scrape_config：

yaml
scrape_configs:
  - job_name: 'hcloud'
    static_configs:
      - targets: ['<hcloud-exporter-ip>:9501']  # 替换为导出器所在主机IP或域名

参考链接

• https://github.com/promhippie/hcloud_exporter
• Hetzner Cloud
• https://prometheus.io
• 镜像仓库：https://github.com/promhippie/hcloud_exporter/pkgs/container/hcloud_exporter、https://hub.docker.com/r/promhippie/hcloud-exporter、https://quay.io/repository/promhippie/hcloud-exporter