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

Help

usage: statuspal [-h] [-V] [--always-ok] [--insecure] [--no-proxy]
                 [--test TEST] [--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-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          Statuspal API URL pointing to the summary endpoint.
                     Default: https://statuspal.eu/api/v2/status_pages/exoscal
                     estatus/summary

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