billimek/node-influx-uptimerobot

node-influx-uptimerobot

一个从Uptime Robot获取统计数据并记录到https://www.influxdata.com/time-series-platform/influxdb/%E7%9A%84%E5%B7%A5%E5%85%B7%E3%80%82

前置条件

• NodeJS 5+
• Uptime Robot账号
• https://www.influxdata.com/time-series-platform/influxdb/%E5%AE%9E%E4%BE%8B

核心功能

1. 定期从Uptime Robot拉取监控日志和响应时间数据
2. 将数据存储到InfluxDB
3. 支持通过配置文件或环境变量设置参数
4. 自动创建InfluxDB所需的测量表
5. 可结合Grafana可视化监控数据

使用场景

适用于需要监控网站、API或服务可用性及响应时间的场景，帮助运维人员分析服务状态，及时发现并处理问题。

配置说明

配置文件格式

创建config.json文件，内容如下：

json
{
  "application" : {
    "interval" : 10
  },
  "uptimerobot" : {
    "api_key" : "uxxxxxx-xxxxxxxxxxxxxxxxxxxxxxxx",
    "logs_limit" : 100,
    "response_times_limit" : 100
  },
  "influx" : {
    "host" : "localhost",
    "port" : 8086,
    "protocol" : "http",
    "username" : "admin",
    "password" : "admin",
    "database" : "uptimerobot"
  }
}

配置项说明

• application.interval：拉取数据的间隔时间（秒），未指定则仅拉取一次
• uptimerobot.api_key：Uptime Robot的API密钥
• uptimerobot.logs_limit：每次拉取的日志数量限制
• uptimerobot.response_times_limit：每次拉取的响应时间数据数量限制
• influx.host：InfluxDB服务器地址
• influx.port：InfluxDB服务器端口
• influx.protocol：InfluxDB连接协议（http/https）
• influx.username：InfluxDB用户名
• influx.password：InfluxDB密码
• influx.database：使用的InfluxDB数据库名称

环境变量替代

所有配置项可通过环境变量设置，优先级高于配置文件：

• APPLICATION_INTERVAL：对应application.interval
• UPTIMEROBOT_API_KEY：对应uptimerobot.api_key
• UPTIMEROBOT_LOGS_LIMIT：对应uptimerobot.logs_limit
• UPTIMEROBOT_RESPONSE_TIMES_LIMIT：对应uptimerobot.response_times_limit
• INFLUX_HOST：对应influx.host
• INFLUX_PORT：对应influx.port
• INFLUX_PROTOCOL：对应influx.protocol
• INFLUX_USERNAME：对应influx.username
• INFLUX_PASSWORD：对应influx.password
• INFLUX_DATABASE：对应influx.database

部署示例

Docker运行

bash
docker run --name node-influx-uptimerobot \
  -e UPTIMEROBOT_API_KEY=your_api_key \
  -e INFLUX_HOST=influxdb_host \
  -e INFLUX_DATABASE=uptimerobot \
  docker.xuanyuan.run/billimek/node-influx-uptimerobot

或挂载配置文件：

bash
docker run --name node-influx-uptimerobot \
  -v ${PWD}/config.json:/usr/src/node-influx-uptimerobot/config.json \
  docker.xuanyuan.run/billimek/node-influx-uptimerobot

Docker Compose

编辑docker-compose.yml设置配置后运行：

bash
docker-compose up -d

Uptime Robot配置

1. 登录Uptime Robot账号
2. 进入My Settings
3. 创建Main API Key（可监控所有服务）或Monitor Specific API Key（仅监控单个服务）

InfluxDB配置

创建数据库

sql
CREATE DATABASE uptimerobot;
USE uptimerobot;

创建用户并授权

sql
CREATE USER "uptimerobot" WITH PASSWORD 'uptimerobot' WITH ALL PRIVILEGES;
GRANT ALL ON "uptimerobot" TO "uptimerobot";

自动创建的测量表

工具运行时会自动创建以下测量表：

• logs：存储Uptime Robot的监控日志，包含字段：friendlyname（监控名称）、id（监控ID）、reason（ downtime原因）、reason_detail（原因详情）、type（日志类型：1-宕机/2-恢复/99-暂停/98-启动）
• response_times：存储响应时间数据，包含字段：friendlyname（监控名称）、id（监控ID）、value（响应时间值）

可视化仪表盘

可导入grafana-uptimerobot-dashboard.json到Grafana，配置数据源后即可可视化监控数据。 !Dashboard