promhippie/hetzner-exporter

Hetzner Exporter

概述和主要用途

Hetzner Exporter是一款专为Prometheus设计的指标导出工具，用于从Hetzner云服务及基础设施中采集各类监控指标。它能够将Hetzner的资源数据转换为Prometheus兼容格式，助力用户通过Prometheus监控Hetzner环境的运行状态、资源利用率及性能表现。支持多种部署方式，包括预编译二进制、DEB/RPM包及容器化部署，适用于各类基于Prometheus的监控场景。

核心功能和特性

• Prometheus兼容：生成符合Prometheus标准的指标格式，可直接被Prometheus抓取并集成到监控系统中
• Hetzner指标采集：从Hetzner平台采集服务器、网络、存储等基础设施资源指标（具体指标集可参考官方文档）
• 多部署形态：提供预编译二进制文件、DEB/RPM包及容器镜像，适配不同运维环境需求
• 多镜像源支持：容器镜像同步发布于GHCR、Docker Hub和Quay等主流容器平台，方便用户获取

使用场景和适用范围

适用于所有采用Hetzner云服务或基础设施，且使用Prometheus作为监控解决方案的用户场景，主要包括：

• 监控Hetzner服务器、网络设备、存储资源的实时运行状态与性能指标
• 构建基于Prometheus+Grafana的Hetzner环境可视化监控面板
• 实现Hetzner资源告警规则配置，及时发现并响应异常状况
• 进行Hetzner资源利用率趋势分析与容量规划

详细使用方法和配置说明

容器化部署

Hetzner Exporter提供官方容器镜像，可通过以下平台获取：

• Docker Hub：promhippie/hetzner-exporter
• GHCR：ghcr.io/promhippie/hetzner_exporter
• Quay：quay.io/promhippie/hetzner-exporter

Docker Run部署示例

bash
docker run -d \
  --name hetzner-exporter \
  -p 9502:9502 \
  docker.xuanyuan.run/promhippie/hetzner-exporter:latest

Docker Compose部署示例

yaml
version: '3.8'
services:
  hetzner-exporter:
    image: docker.xuanyuan.run/promhippie/hetzner-exporter:latest
    container_name: hetzner-exporter
    restart: unless-stopped
    ports:
      - "9502:9502"  # 默认指标暴露端口
    # 如需配置Hetzner API认证，添加环境变量（具体参数参考官方文档）
    # environment:
    #   - HETZNER_API_TOKEN=your_hetzner_api_token
    #   - EXPORTER_LOG_LEVEL=info

其他安装方式

• 预编译二进制：从https://github.com/promhippie/hetzner_exporter/releases%E4%B8%8B%E8%BD%BD%E5%AF%B9%E5%BA%94%E5%B9%B3%E5%8F%B0%E7%9A%84%E4%BA%8C%E8%BF%9B%E5%88%B6%E6%96%87%E4%BB%B6%EF%BC%8C%E7%9B%B4%E6%8E%A5%E6%89%A7%E8%A1%8C%E5%8D%B3%E5%8F%AF
• 包管理器安装：通过Cloudsmith提供的DEB/RPM仓库安装，支持Debian/Ubuntu及RHEL/CentOS系统，仓库地址：[***]
• 源码编译：需Go 1.24.0及以上环境，通过源码编译（具体步骤参考官方开发文档）

配置说明

Hetzner Exporter主要通过命令行参数或环境变量进行配置，核心配置项包括：

• --web.listen-address：指标暴露地址，默认0.0.0.0:9502
• --hetzner.api-token：Hetzner API访问令牌（必填，用于认证）
• --log.level：日志级别，可选debug/info/warn/error，默认info

完整配置参数及使用方法请参考https://promhippie.github.io/hetzner_exporter/#getting-started

相关资源

• 官方GitHub仓库：https://github.com/promhippie/hetzner_exporter
• 容器镜像地址：
  • GHCR：https://github.com/promhippie/hetzner_exporter/pkgs/container/hetzner_exporter
  • Docker Hub：https://hub.docker.com/r/promhippie/hetzner-exporter
  • Quay：https://quay.io/repository/promhippie/hetzner-exporter
• 详细使用文档：https://promhippie.github.io/hetzner_exporter