Repository
Munin (contrib)
Last change
2020-10-06
Graph Categories
Family
auto
Capabilities
Keywords
Language
Shell

procbyuser

Name

procbyuser - Plugin to monitor the amount of processes owned by a user

Installation

Place in /etc/munin/plugins/ (or link it there using ln -s)

Configuration

Add this to your /etc/munin/plugin-conf.d/munin-node:

[procbyuser]
user root               # required if /proc can't be read from by any user!
env.USERS root yann     # defaults to ALL, i.e. display all users. 'root' is counted as one of the 'others'
env.OTHER_FIELD others  # enable 'others'-list, set the label/field name

Authors

Copyright (C) 2019 pcy pcy@ulyssis.org

Based on the plugin “cpubyuser”.

Magic Markers

#%# family=auto
#%# capabilities=autoconf
#!/bin/sh
# -*- sh -*-

: << =cut

=head1 NAME

procbyuser - Plugin to monitor the amount of processes owned by a user

=head1 INSTALLATION

Place in /etc/munin/plugins/ (or link it there using ln -s)

=head1 CONFIGURATION

Add this to your /etc/munin/plugin-conf.d/munin-node:

 [procbyuser]
 user root               # required if /proc can't be read from by any user!
 env.USERS root yann     # defaults to ALL, i.e. display all users. 'root' is counted as one of the 'others'
 env.OTHER_FIELD others  # enable 'others'-list, set the label/field name

=head1 AUTHORS

Copyright (C) 2019 pcy <pcy@ulyssis.org>

Based on the plugin "cpubyuser".

=head1 MAGIC MARKERS

 #%# family=auto
 #%# capabilities=autoconf

=cut

. "$MUNIN_LIBDIR/plugins/plugin.sh"

[ -z "$USERS" ] && USERS=ALL
if [ "$USERS" = "ALL" ]; then
	USERS="$(ps ax --format uname | tail +2 | sort -u | grep -v -e '^root$')"
fi

if [ "$1" = "autoconf" ]; then
	echo "yes"
fi

if [ "$1" = "config" ]; then
	echo "graph_args -r --lower-limit 0"
	echo "graph_title Processes per user"
	echo "graph_category processes"
	echo "graph_info This graph shows the amount of processes owned by a user."
	echo "graph_vlabel processes"
	echo "graph_scale no"
	echo "graph_period second"
	user_fields="$(for user in $USERS; do clean_fieldname "$user" | tr '\n' ' '; done)"
	echo "graph_order $user_fields $(clean_fieldname "$OTHER_FIELD")"
	for user in $USERS "$OTHER_FIELD"; do
		if [ -n "$user" ]; then
			user_field="$(clean_fieldname "$user")"
			echo "${user_field}.label $user"
			echo "${user_field}.info processes of user $user"
			echo "${user_field}.type GAUGE"
			echo "${user_field}.draw AREASTACK"
		fi
	done
	exit
fi

OTHER_PRINT=""
[ -z "$OTHER_FIELD" ] || OTHER_PRINT="print \"$(clean_fieldname "$OTHER_FIELD")\", others_sum;"

ps ax -o user:42= -o cmd= | \
	awk -v USERS="$USERS" '
		!($2 ~ /^\[/) { NUSER[$1]=NUSER[$1]+1 } # filter away kernel threads
		END {
			others_sum = 0
			split(USERS, user_array)
			for (user in NUSER) {
				m = match(USERS,user)
				if (m != 0) {
					_user=user
					gsub(/[-.]/,"_",_user);
					print _user, (NUSER[user])
				} else
					others_sum += NUSER[user]
			}
			'"$OTHER_PRINT"'
		}' | while read -r user count; do
			# apply fieldname cleanup
			echo "$(clean_fieldname "$user").value $count"
		done