Check swap-usage

Overview

Displays amount of free and used swap space in the system, checks against used swap in percent.

Fact Sheet

Check Plugin Download

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

Check Interval Recommendation

Once a minute

Can be called without parameters

Yes

Available for

Python 2, Python 3, Windows

Requirements

Python module psutil

Help

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

Displays amount of free and used swap space in the system, checks against used
swap in percent.

optional arguments:
  -h, --help            show this help message and exit
  -V, --version         show program's version number and exit
  --always-ok           Always returns OK.
  -c CRIT, --critical CRIT
                        Set the critical threshold for swap usage (in
                        percent). Default: 90
  -w WARN, --warning WARN
                        Set the warning threshold for swap usage (in percent).
                        Default: 70

Usage Examples

./swap-usage --warning 70 --critical 90

Output:

38.6% - total: 11.7GiB, used: 4.5GiB, free: 7.2GiB
swapped in: 1.6GiB, swapped out: 11.9GiB

States

  • WARN or CRIT if swap usage is above a given threshold.

Perfdata / Metrics

  • Swap Usage (%)

  • Total Swap Space (Bytes)

  • Used (Bytes)

  • Free (Bytes)

  • Swap In (Bytes)

  • Swap Out (Bytes)

Credits, License