- Repository
- Munin (contrib)
- Last change
- 2020-07-15
- Graph Categories
- Family
- auto
- Capabilities
- Keywords
- Language
- Bash
- License
- GPL-2.0-only
- Authors
systemd_units
Name
systemd - Plugin to monitor systemd units state
Applicable Systems
Linux systems with systemd installed.
Configuration
No configuration is required for this plugin. You may optionally pass warning and critical values for any of the possible states (active, reloading, inactive, failed, activating, deactivating), and you may additionally pass both global and state-specific include/exclude filters to include only units you care about and/or exclude units you don’t care about.
(Note that for failed units, default warning and critical values are set to 0 and 10, respectively. No other states have default levels set.)
Value calculations for each state are made using the following algorithm (all filters performed using
grep -E
):
1. Global include rules are applied on the output of systemctl list-units --all --no-legend
;
2. Global exclude rules are then applied to the result of that;
3. Then, for each state, this global output is further filtered by include, then exclude rules for the state;
4. Then the result is filtered for the given state and the remaining units counted and listed.
An example configuration might be something like this:
[systemd_units] env.failed_warning 0 env.failed_critical 5 env.inactive_warning 10 env.inactive_critical 20 env.exclude boring env.inactive_exclude sleepy env.silence_active_extinfo 1
In the example above, we’ve overridden the default warning and critical levels for failed units, added warning and critical levels for inactive units, then filtered out boring units from all results and filtered out sleepy units from results for the inactive state. In addition to that, only more extensive info of non-active units are displayed in order to quickly see which units are failing and why in the webui. (By default, all extra info about all units is displayed.)
Author
Olivier Mehani <shtrom+munin@ssji.net> Kael Shipman kael.shipman@gmail.com
License
GPLv2
Magic Markers
#%# family=auto
#%# capabilities=autoconf
#!/bin/bash
# -*- sh -*-
: << =cut
=head1 NAME
systemd - Plugin to monitor systemd units state
=head1 APPLICABLE SYSTEMS
Linux systems with systemd installed.
=head1 CONFIGURATION
No configuration is required for this plugin. You may optionally pass warning and critical values for any
of the possible states (active, reloading, inactive, failed, activating, deactivating), and you may
additionally pass both global and state-specific include/exclude filters to include only units you care
about and/or exclude units you don't care about.
(Note that for failed units, default warning and critical values are set to 0 and 10, respectively. No other
states have default levels set.)
Value calculations for each state are made using the following algorithm (all filters performed using
C<grep -E>):
1. Global include rules are applied on the output of C<systemctl list-units --all --no-legend>;
2. Global exclude rules are then applied to the result of that;
3. Then, for each state, this global output is further filtered by include, then exclude rules for the state;
4. Then the result is filtered for the given state and the remaining units counted and listed.
An example configuration might be something like this:
=over 2
[systemd_units]
env.failed_warning 0
env.failed_critical 5
env.inactive_warning 10
env.inactive_critical 20
env.exclude boring
env.inactive_exclude sleepy
env.silence_active_extinfo 1
=back
In the example above, we've overridden the default warning and critical levels for failed units, added warning
and critical levels for inactive units, then filtered out boring units from all results and filtered out sleepy
units from results for the inactive state. In addition to that, only more extensive info of non-active units
are displayed in order to quickly see which units are failing and why in the webui. (By default, all extra info
about all units is displayed.)
=head1 AUTHOR
Olivier Mehani <shtrom+munin@ssji.net>
Kael Shipman <kael.shipman@gmail.com>
=head1 LICENSE
GPLv2
=head1 MAGIC MARKERS
#%# family=auto
#%# capabilities=autoconf
=cut
. "$MUNIN_LIBDIR/plugins/plugin.sh"
failed_warning="${failed_warning:-0}"
failed_critical="${failed_critical:-10}"
silence_active_extinfo="${silence_active_extinfo:-0}"
states="active \
reloading \
inactive \
failed \
activating \
deactivating"
include="${include:-.*}"
exclude="${exclude:-^$}"
autoconf() {
which systemctl >/dev/null && \
systemctl --state=failed --no-pager --no-legend >/dev/null 2>&1 && \
echo yes || \
echo "no (No systemctl or error running it)"
}
config () {
cat << EOF
graph_title Systemd units state
graph_args -l 0
graph_category system
graph_scale no
graph_vlabel units
EOF
for state in $states; do
echo "$state.label $state"
echo "$state.draw AREASTACK"
print_warning $state
print_critical $state
done
}
fetch () {
# Get all units, filtering by global include/exclude rules
local state_include_var state_include state_exclude_var state_exclude global_unit_list state_unit_list
global_unit_list=$(systemctl --no-pager --no-legend --all | grep -E "$include" | grep -Ev "$exclude" | awk '{print $1, $3}')
# For each state, echo the number of units and some extra info, filtering for state-specific include/excludes
for state in $states ; do
# Get state-specific include/excludes, if present
state_include_var="${state}_include"
state_include="${!state_include_var}"
state_exclude_var="${state}_exclude"
state_exclude="${!state_exclude_var}"
state_unit_list="$global_unit_list"
# Filter
if [ -n "$state_include" ]; then
state_unit_list="$(echo "$state_unit_list" | grep -E "$state_include")"
fi
if [ -n "$state_exclude" ]; then
state_unit_list="$(echo "$state_unit_list" | grep -Ev "$state_exclude")"
fi
# Count and output
count=$(echo "$state_unit_list" | grep -c "$state$")
echo "$state.value $count"
extinfo=$(echo "$state_unit_list" | grep "$state$" | cut -d " " -f 1 | tr '\n' ' ')
if [ "$silence_active_extinfo" = "0" ]; then
if [ -n "$extinfo" ]; then
echo "$state.extinfo" "$extinfo"
fi
else
if [ -n "$extinfo" ] && [ "$state" != "active" ]; then
echo "$state.extinfo" "$extinfo"
fi
fi
done
}
case $1 in
"autoconf")
autoconf
;;
"config")
config
;;
*)
fetch
;;
esac