Check fortios-memory-usage


Returns the current system-wide memory utilization as a percentage from a Forti Appliance like FortiGate running FortiOS, using the FortiOS REST API. The authentication is done via a single API token (Token-based authentication), not via Session-based authentication, which is stated as „legacy“.


  • This plugin tries to check against the global configured memory-use-threshold-green and memory-use-threshold-red first; only if there is no value, the check’s command line values are used.

Fact Sheet

Check Plugin Download

Check Interval Recommendation

Once a minute

Can be called without parameters


Available for

Python 2, Python 3, Windows




usage: fortios-memory-usage [-h] [-V] [--always-ok] [-c CRIT] -H HOSTNAME
                            [--insecure] [--no-proxy] --password PASSWORD
                            [--timeout TIMEOUT] [-w WARN]

Displays amount of used memory in percent, and checks against configured or
given thresholds.

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 memory usage (in
                        percent). Default: 88
  -H HOSTNAME, --hostname HOSTNAME
                        FortiOS-based Appliance address, optional including
                        port ("").
  --insecure            This option explicitly allows to perform "insecure"
                        SSL connections. Default: False
  --no-proxy            Do not use a proxy. Default: False
  --password PASSWORD   FortiOS REST API Single Access Token.
  --timeout TIMEOUT     Network timeout in seconds. Default: 3 (seconds)
  -w WARN, --warning WARN
                        Set the warning threshold for memory usage (in
                        percent). Default: 82

Usage Examples

./fortios-memory-usage --hostname --password mypass --warning=50 --critical=70




  • OK if overall memory-usage is below the thresholds.

  • Otherwise CRIT or WARN.

Perfdata / Metrics

  • usage_percent: The overall memory usage.

Credits, License