pmp-check-unix-memory - Alert on low memory, or when a process uses too much memory.


Usage: pmp-check-unix-memory [OPTIONS]
  -c CRIT     Critical threshold; default 95%.
  -d          Disable single process memory check; default enabled.
  -w WARN     Warning threshold; default 90%.
  --help      Print help and exit.
  --version   Print version and exit.
Options must be given as --option value, not --option=value or -Ovalue.
Use perldoc to read embedded documentation with more details.


This Nagios plugin examines the output of free and ps to look for two conditions. The first is when the system is running out of memory, and the second is when any single process uses too much memory. However, there is an option to disable the second condition. Both checks are compared to the same thresholds.

For example, on a system with 144GB of memory, with the default options, the plugin might produce the following warning:

WARN Memory: 94% used; largest process: mysqld (16675) = 133149.54MB (91%)

Both the total used memory (94%) and the virtual size of mysqld (91%) are over the warning threshold. If one of these tests evaluates to a higher severity than the other, the more serious result prevails.

The plugin is tested on GNU/Linux, but may also work on other Unix-like operating systems, if the output of ps and free can be recognized.


This plugin does not access MySQL.

This plugin executes the following UNIX commands that may need special privileges:

  • free
  • ps


Percona Monitoring Plugins pmp-check-unix-memory 1.0.5

Table Of Contents

Previous topic


Next topic

Percona Monitoring Plugins for Cacti

Contact Us

For free technical help, visit the Percona Community Forum.
To report bugs or submit feature requests, open a JIRA ticket.
For paid support and managed or professional services, contact Percona Sales.