Skip to content

Check statuspal

Overview

Monitors a Statuspal status page, checking overall status, service states, active incidents, and scheduled maintenances.

List of public Statuspal sites - Europe:

List of public Statuspal sites - USA:

Important Notes:

  • Statuspal has EU (statuspal.eu) and US (statuspal.io) endpoints
  • You need to provide the URL to the Statuspal API summary endpoint
  • API Documentation: https://www.statuspal.io/api-docs/v2

Data Collection:

  • Fetches JSON from the Statuspal API v2 summary endpoint
  • Recursively flattens nested service trees into a dotted hierarchy (e.g. Global.DNS)
  • Lists active incidents with their latest update, and upcoming/ongoing maintenances

Fact Sheet

Fact Value
Check Plugin Download https://github.com/Linuxfabrik/monitoring-plugins/tree/main/check-plugins/statuspal
Nagios/Icinga Check Name check_statuspal
Check Interval Recommendation Every minute
Can be called without parameters Yes
Runs on Cross-platform
Compiled for Windows No (runs with Python interpreter)

Help

usage: statuspal [-h] [-V] [--always-ok] [--insecure] [--no-perfdata]
                 [--no-proxy] [--proxy PROXY] [--timeout TIMEOUT] [--url URL]

Monitors a Statuspal status page, including overall status, service states,
active incidents, and scheduled maintenances. Alerts on degraded services,
ongoing incidents, or emergency maintenance windows.

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-perfdata      Suppress the performance data section from the output.
                     The status message and the exit code are unaffected, so
                     alerting keeps working while trending data is dropped.
  --no-proxy         Do not use a proxy, not even one the environment names.
                     Overrides `--proxy`.
  --proxy PROXY      Proxy to reach the target through. The scheme defaults to
                     `http` when omitted. Overrides the proxy the environment
                     names (`http_proxy`, `https_proxy`, `all_proxy`) together
                     with the exceptions it lists in `no_proxy`, and is itself
                     overridden by `--no-proxy`. Without either parameter the
                     environment applies. Credentials belong into the
                     environment variable rather than here, because a command-
                     line argument is visible to every user on the host.
                     Example: `--proxy=http://proxy.example.com:3128`.
  --timeout TIMEOUT  Network timeout in seconds. Default: 8 (seconds)
  --url URL          Statuspal API URL pointing to the summary endpoint.
                     Default: https://statuspal.eu/api/v2/status_pages/exoscal
                     estatus/summary

Documentation:
https://linuxfabrik.github.io/monitoring-plugins/check-plugins/statuspal/

Usage Examples

./statuspal --url=https://statuspal.eu/api/v2/status_pages/exoscalestatus/summary

Output:

Major incidents @ Exoscale (exoscale.com, TZ Europe/Zurich): [Network] Transient network disturbance / Situation has been resolved, we're monitoring the situation (2023-10-10 09:03:06) (see https://exoscalestatus.com/incidents/81315)

Service                            ! State
-----------------------------------+-------
Global.DNS                         ! [OK]
Global.Portal                      ! [OK]
CH-GVA-2                           ! [OK]
CH-GVA-2.API                       ! [OK]
AT-VIE-1.Network Load Balancer NLB ! [CRITICAL]
AT-VIE-1.Object Storage SOS        ! [OK]
AT-VIE-2                           ! [CRITICAL]

Upcoming Maintenance                                ! Type      ! Start               ! End
----------------------------------------------------+-----------+---------------------+----------
Core Network Architecture - Internal routing update ! scheduled ! 2023-09-20 07:00:00 ! open end

./statuspal --url=https://statuspal.io/api/v2/status_pages/ascentlogistics/summary

Output:

Major incidents @ Ascent Global Logistics (ascentlogistics.com, TZ America/Detroit): Service PEAK - Customer API  Production seems to be down / According to our monitoring system this service has become unresponsive, we're investigating. (2022-04-20 18:27:16)

Service                               ! State
--------------------------------------+------------
Ascent Websites.Main Ascent Website   ! [OK]
PEAK.PEAK - Customer API  Integration ! [CRITICAL]
PEAK.PEAK - Customer API  Production  ! [CRITICAL]
Global IT Monitoring                  ! [CRITICAL]

States

  • OK if all services are operational.
  • WARN if minor incidents or degraded performance are found.
  • CRIT if major incidents or emergency maintenance are found.
  • --always-ok suppresses all alerts and always returns OK.

Perfdata / Metrics

Name Type Description
cnt_crit Number Number of critical events
cnt_warn Number Number of warning events

Credits, License