Check uptime

Overview

The plugin can also display the last downtime timestamp and duration - the shorter the intervals at which it is run, the more accurate the downtime info will be.

Note that the plugin requires a time qualifier when specifying parameters, e.g. --warning=180D for 180 days (instead of --warning=180 as in older versions).

Fact Sheet

Fact

Value

Check Plugin Download

https://github.com/Linuxfabrik/monitoring-plugins/tree/main/check-plugins/uptime

Check Interval Recommendation

Once a minute

Can be called without parameters

Yes

Compiled for Windows

Yes

3rd Party Python modules

psutil

Uses SQLite DBs

$TEMP/linuxfabrik-monitoring-plugins-uptime.db

Help

usage: uptime [-h] [-V] [--always-ok] [-c CRIT] [-w WARN]

Check how long the system has been running. The plugin can also display the
last downtime timestamp and duration - the shorter the intervals at which it
is run, the more accurate the downtime info will be.

options:
  -h, --help           show this help message and exit
  -V, --version        show program's version number and exit
  --always-ok          Always returns OK.
  -c, --critical CRIT  Threshold for the uptime in a human readable format
                       (10m = 10 minutes; s = seconds, m = minutes, h = hours,
                       D = days, W = weeks, M = months, Y = years). Supports
                       Nagios ranges. Example: `:1Y` alerts if uptime is
                       greater than 1 year. Default: :1Y
  -w, --warning WARN   Threshold for the uptime in a human readable format
                       (10m = 10 minutes; s = seconds, m = minutes, h = hours,
                       D = days, W = weeks, M = months, Y = years). Supports
                       Nagios ranges. Example: `5m:180D` warns if uptime is
                       not between 5 minutes and 180 days. Default: 3m:180D

Usage Examples

Warn if more than 180 days, crit if more than 365 days up:

./uptime --warning=180D --critical=1Y

Output:

Up 2W 6h since 2024-03-30 08:08:01 (thresholds 180D/1Y)

Warn if less than 5 minutes up:

./uptime --warning=5m:

Output:

Up 4m since 2024-03-30 08:08:01 (thresholds 5m:/:1Y) [WARNING]

Warn if not in 5 minutes to 6 months and 5 days uptime. If more than 2 years up, return crit:

./uptime --warning=5m:6M5D --critical=2Y
# alternatively: ./uptime --warning='5m:6M 5D' --critical=2Y

Output over time:

Up 1m 39s since 2024-03-30 08:08:01 (thresholds 5m:6M5D/2Y) [WARNING]
Up 6M since 2024-03-30 08:08:01 (thresholds 5m:6M5D/2Y)
Up 6M 6D since 2024-03-30 08:08:01 (thresholds 5m:6M5D/2Y) [WARNING]

Output after planned/unplanned shutdown/power down and subsequent boot:

Up 1m 57s since 2024-11-22 14:44:31 (thresholds 3m:180D/:1Y) [WARNING].
Last power event at ~2024-11-22 14:44:18 and down for ~13s.

States

  • WARN or CRIT if system uptime is above a given threshold.

Perfdata / Metrics

Name

Type

Description

uptime

Seconds

Uptime in seconds

Credits, License