NAME

multips_memory - Munin plugin to monitor memory usage of processes. Which processes are configured in a file in plugin-conf.d.

APPLICABLE SYSTEMS

Any system with a compatible SysV style ps command that understands

  ps -eo rss,comm

CONFIGURATION

You must specify what process names to monitor:

  [multips_memory]
     env.names apache2 mysqld php-cgi

The names are are matched with awk. Any regular expression meta characters in each of the words on the names list are "active" in the regular expression.

The by default RSS is monitored, but other sizes provided by your ps is directly usable (the plugin assumes all sizes reported by ps is in KB). Candidates on Linux are rss, size, resident, share, vsize. See your ps man page for more information especially with regards to interpretation of the values. You can change what is monitored by

  [multips_memory]
      env.monitor vsize

You cannot specify multiple sizes. The plugin handles only one.

If for some reason you want separate graphs, you can make separately named symlinks in the plugins directory on the node (most often either /etc/munin/plugins or /etc/opt/munin/plugins), eg. multips_memory_rss and multips_memory_vsize as symlinks to multips_memory and configure them thus:

  [multips_memory*]
      env.names apache2 mysqld php-cgi

  [multips_memory_rss]
      env.monitor rss

  [multips_memory_vsize]
      env.monitor vsize

They can of course also have different process names as well. Eg. one list for the "LAMP" stack and one for the Java/Oracle stack in separate graphs.

INTERPRETATION

This plugin adds up the RSS (or other memory size if configured) of all processes matching the process name, as reported by ps.

MAGIC MARKERS

  #%# family=manual
  #%# capabilities=autoconf

VERSION

  0.1 first release, based on multips as distributed in Debian.

  $Id $

BUGS AND RESTRICTIONS

Only the executable name is matched against (ps -eo comm)1, and it must be a full string match to the executable base name, not substring, unless you enter a name such as ".*apache" since RE meta characters in the names are active.

You cannot specify multiple sizes. The plugin handles only one.

AUTHOR

Originally: Unknown.

Made into multimemory by: github.com/dominics github.com/yhager.

Renamed to multips_memory when included in official munin trunk.

Thanks to: wix

Some further work to make more generic by Nicolai Langfeldt

LICENSE

GPLv2