- Repository
- Munin (contrib)
- Last change
- 2020-03-26
- Graph Categories
- Family
- manual
- Capabilities
- Keywords
- Language
- Shell
- License
- GPL-2.0-only
multimemory
Name
multimemory - Munin plugin to monitor memory usage of processes. Which processes are configured in client-conf.d
Applicable Systems
Any system with a compatible ps command.
Configuration
There is no default configuration. This is an example:
[multimemory]
env.os freebsd
env.names apache2 mysqld php-cgi
Set env.os to freebsd if you are running this script on a machine which does not have GNU sed installed (FreeBSD / OpenBSD / Solaris …), else set it to linux.
The names are used to grep with directly, after cleaning. So, this plugin only supports very basic pattern matching. To fix: see multips
Interpretation
This plugin adds up the RSS of all processes matching the regex given as the process name, as reported by ps.
Magic Markers
#%# family=manual
#%# capabilities=autoconf
Version
0.3 light improvement in FreeBSD part of ps parsing 0.2 second release, it should now work on machines without GNU sed 0.1 first release, based on: multimemory.in 1590 2008-04-17 18:21:31Z matthias As distributed in Debian.
Bugs
None known
Author
Originally: matthias? Modified by: github.com/dominics github.com/yhager Thanks to: wix
License
GPLv2
#!/bin/sh
# -*- sh -*-
: <<=cut
=head1 NAME
multimemory - Munin plugin to monitor memory usage of processes. Which processes
are configured in client-conf.d
=head1 APPLICABLE SYSTEMS
Any system with a compatible ps command.
=head1 CONFIGURATION
There is no default configuration. This is an example:
[multimemory]
env.os freebsd
env.names apache2 mysqld php-cgi
Set env.os to freebsd if you are running this script on a machine which does not have
GNU sed installed (FreeBSD / OpenBSD / Solaris ...), else set it to linux.
The names are used to grep with directly, after cleaning. So, this plugin
only supports very basic pattern matching. To fix: see multips
=head1 INTERPRETATION
This plugin adds up the RSS of all processes matching the
regex given as the process name, as reported by ps.
=head1 MAGIC MARKERS
#%# family=manual
#%# capabilities=autoconf
=head1 VERSION
0.3 light improvement in FreeBSD part of ps parsing
0.2 second release, it should now work on machines without GNU sed
0.1 first release, based on:
multimemory.in 1590 2008-04-17 18:21:31Z matthias
As distributed in Debian.
=head1 BUGS
None known
=head1 AUTHOR
Originally: matthias?
Modified by: github.com/dominics github.com/yhager
Thanks to: wix
=head1 LICENSE
GPLv2
=cut
if [ -z "$MUNIN_LIBDIR" ]; then
MUNIN_LIBDIR="`dirname $(dirname "$0")`"
fi
. $MUNIN_LIBDIR/plugins/plugin.sh
if [ "$1" = "autoconf" ]; then
echo yes
exit 0
fi
if [ -z "$names" -o -z "$os" ]; then
echo "Configuration required"
exit 1
fi
if [ "$1" = "config" ]; then
echo graph_title Total memory usage
echo 'graph_category processes'
echo 'graph_args --base 1024 --vertical-label memory -l 0'
for name in $names; do
fieldname=$(clean_fieldname $name)
REGEX='\<'"$name"'\>'
echo "$fieldname.label $name"
echo "$fieldname.draw LINE2"
echo "$fieldname.info Processes matching this regular expression: /$REGEX/"
done
exit 0
fi
for name in $names; do
fieldname=$(clean_fieldname $name)
printf "$fieldname.value "
if [ "$os" = "freebsd" ]; then
ps awxo rss,command | grep -w $name | grep -v grep | /usr/bin/awk '{ total += $1 } END { print total * 1024 }'
else
ps auxww | grep -w $name | grep -v grep | sed -re 's/[ ]{1,}/ /g' | /usr/bin/cut -d ' ' -f 6 | /usr/bin/awk '{ total = total + $1 } END { print total * 1024 }'
fi
done