Skip to content

Check uptimerobot

Overview

Monitors all configured monitors on a given UptimeRobot status page. Reports the number of monitors in up, down, and paused states, along with the 24-hour uptime ratio.

Data Collection:

  • Fetches the HTML of the UptimeRobot status page to extract the internal API path
  • Then fetches the monitor list JSON from the discovered API endpoint
  • Reports per-monitor name, type, and state in a table

Fact Sheet

Fact Value
Check Plugin Download https://github.com/Linuxfabrik/monitoring-plugins/tree/main/check-plugins/uptimerobot
Nagios/Icinga Check Name check_uptimerobot
Check Interval Recommendation Every minute
Can be called without parameters Yes
Runs on Cross-platform
Compiled for Windows No

Help

usage: uptimerobot [-h] [-V] [--always-ok] [--insecure] [--no-proxy]
                   [--test TEST] [--timeout TIMEOUT] [--url URL]

Monitors all configured UptimeRobot monitors via the UptimeRobot API. Alerts
on any monitor that is in a down or unknown state.

options:
  -h, --help         show this help message and exit
  -V, --version      show program's version number and exit
  --always-ok        Always returns OK.
  --insecure         This option explicitly allows insecure SSL connections.
  --no-proxy         Do not use a proxy.
  --test TEST        For unit tests. Needs "path-to-stdout-file,path-to-
                     stderr-file,expected-retc".
  --timeout TIMEOUT  Network timeout in seconds. Default: 8 (seconds)
  --url URL          UptimeRobot status page URL. Default:
                     https://status.linuxfabrik.io

Usage Examples

./uptimerobot --url=https://status.linuxfabrik.io

Output:

0/0/3 of 3 monitors are down/paused/up, 24h uptime: 99.976%

Name                      ! Type    ! State 
--------------------------+---------+-------
001 cloud.linuxfabrik.io  ! HTTP(s) ! [OK]  
001 office.linuxfabrik.io ! HTTP(s) ! [OK]  
001 ws.linuxfabrik.io     ! HTTP(s) ! [OK]

States

  • OK if all monitors are in "success" state.
  • WARN if any monitor is in "danger" state.
  • UNKNOWN for monitors in any other state.
  • --always-ok suppresses all alerts and always returns OK.

Perfdata / Metrics

Name Type Description
cnt_down Number Number of monitors in "down" state
cnt_paused Number Number of monitors in "paused" state
cnt_up Number Number of monitors in "up" state

Credits, License