lekpamartin/uptimerobot_exporter

uptimerobot.com Prometheus 导出器

!Grafana 仪表盘

镜像概述和主要用途

该镜像用于将uptimerobot.com的所有检查数据导出，供Prometheus抓取，以便在监控设置中集成外部第三方检查数据。对于非专业账户，若抓取间隔短于scrape_interval: 5m，会导致数据重复并滥用uptimerobot API。

核心功能和特性

• 导出监控器状态指标：包括故障监控器数量（down_monitors）、正常监控器数量（up_monitors）、暂停监控器数量（paused_monitors）
• 监控器限制指标：最大监控器数量（monitor_limit）
• 监控器详细信息：名称、URL、类型、关键词（可选）、关键词值（可选）、检查间隔、状态（状态变化时颜色更新）
• 响应时间指标：最小（min）、最大（max）、平均（avg）及当前响应时间
• 公共状态页（psp）数据导出

使用场景和适用范围

适用于需要将uptimerobot.com的监控数据集成到Prometheus+Grafana监控系统的场景，帮助用户统一监控外部服务状态。

详细使用方法和配置说明

环境要求

• Python
• requests 库

接受参数

• api_key：uptimerobot.com的API密钥，可在账户详情的"API设置"部分获取（必填）
• server_name（可选）：HTTP服务器绑定名称，默认值：0.0.0.0
• server_port（可选）：HTTP服务器绑定端口，默认值：9705

Docker 部署

基本运行命令

bash
docker run -d --name uptimerobot_exporter -e 'UPTIMEROBOT_API_KEY=your_uptime_robot_api_key' -p 9705:9705 --read-only lekpamartin/uptimerobot_exporter

docker-compose 配置示例

yaml
version: '2.1'

services:
  exporter:
    image: lekpamartin/uptimerobot_exporter
    restart: unless-stopped
    environment:
      UPTIMEROBOT_API_KEY: your_uptime_robot_api_key
    ports:
      - 9705:9705
    read_only: true

其他运行方式

可通过脚本参数（运行python exporter.py -h查看说明）或设置以下环境变量运行：

• UPTIMEROBOT_API_KEY：uptimerobot API密钥
• UPTIMEROBOT_SERVER_NAME：服务器绑定名称
• UPTIMEROBOT_SERVER_PORT：服务器绑定端口

Grafana / Prometheus 集成步骤

1. 部署导出器
2. 在Prometheus中添加抓取目标
3. 在Grafana中添加Prometheus数据源
4. 导入Grafana仪表盘（导入JSON文件或使用仪表盘ID 9955） 完成以上步骤即可开始使用。

文档来源

Fork自 https://github.com/hnrd/uptimerobot_exporter.git