]> git.somenet.org - root/pub/somesible.git/blob - roles/base/munin-node/files/default/plugins.somesible/threads
[roles/server/mail/postfix] setup postfix mail server
[root/pub/somesible.git] / roles / base / munin-node / files / default / plugins.somesible / threads
1 #!/bin/sh
2 # -*- sh -*-
3 #
4 ################################################
5 ### Managed by someone's ansible provisioner ###
6 ################################################
7 # Part of: https://git.somenet.org/root/pub/somesible.git
8 # 2017-2024 by someone <someone@somenet.org>
9 #
10
11 set -e
12
13 : << =cut
14
15 =head1 NAME
16
17 threads - Plugin to monitor threads and thread states. - copy of threads, with another ps option. commented out all but linux.
18
19 =head1 ABOUT
20
21 This plugin requires munin-server version 1.2.5 or 1.3.3 (or higher).
22
23 This plugin is backwards compatible with the old threads-plugins found on
24 SunOS, Linux and *BSD (i.e. the history is preserved).
25
26 All fields have colours associated with them which reflect the type of process
27 (sleeping/idle = blue, running = green, stopped/zombie/dead = red, etc.)
28
29 =head1 CONFIGURATION
30
31 No configuration for this plugin.
32
33 =head1 AUTHOR
34
35 Copyright (C) 2006 Lars Strand
36
37 =head1 LICENSE
38
39 GNU General Public License, version 2
40
41 =begin comment
42
43 This file is part of Munin.
44
45 This program is free software; you can redistribute it and/or modify it under
46 the terms of the GNU General Public License as published by the Free Software
47 Foundation; version 2 dated June, 1991.
48
49 This program is distributed in the hope that it will be useful, but WITHOUT ANY
50 WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A
51 PARTICULAR PURPOSE.  See the GNU General Public License for more details.
52
53 You should have received a copy of the GNU General Public License along with
54 this program; if not, write to the Free Software Foundation, Inc., 51 Franklin
55 Street, Fifth Floor, Boston, MA 02110-1301 USA.
56
57 =end comment
58
59 =head1 MAGIC MARKERS
60
61 =begin comment
62
63 These magic markers are used by munin-node-configure when installing
64 munin-node.
65
66 =end comment
67
68  #%# family=auto
69  #%# capabilities=autoconf
70
71 =cut
72
73 # Search for program in $PATH unless predefined.
74 awk=${awk:-awk}
75 ps=${ps:-ps}
76
77 # Find operating system
78 OPERSYS=${OPERSYS:-$(uname | cut -f 1 -d _)}
79 [ -z "$OPERSYS" ] && echo >&2 "Failed to detect environment via uname" && exit 1
80
81 if [ "$1" = "autoconf" ]; then
82     case "$OPERSYS" in
83         Linux) #|SunOS|FreeBSD|OpenBSD|NetBSD|Darwin|CYGWIN) - some edit: disable all but linux.
84             if ! "$ps" >/dev/null 2>/dev/null; then
85                 echo "no (ps=$ps failed)"
86             elif ! echo | "$awk" '{ print "Hei" }' >/dev/null 2>/dev/null; then
87                 echo "no (awk=$awk failed)"
88             else
89                 echo yes
90             fi
91             exit 0
92             ;;
93         *)
94             echo "no (unknown OS)"
95             exit 0
96             ;;
97     esac
98 fi
99
100 . "$MUNIN_LIBDIR/plugins/plugin.sh"
101
102 # Define colours
103 RUNNABLE='22ff22'         # Green
104 SLEEPING='0022ff'         # Blue
105 STOPPED='cc0000'          # Darker red
106 ZOMBIE='990000'           # Darkest red
107 UNINTERRUPTIBLE='ffa500'  # Orange
108 IDLE='4169e1'             # Royal blue
109 PAGING='00aaaa'           # Darker turquoise
110 INTERRUPT='ff00ff'        # Fuchsia
111 LOCK='ff3333'             # Lighter red
112 RUNNING='00ff7f'          # Spring green
113 DEAD='ff0000'             # Red
114 SUSPENDED='ff1493'        # Deep pink
115 TOTAL='c0c0c0'            # Silver
116
117 # Taken from ps(1)
118 # R - Linux, SunOS, FreeBSD, OpenBSD, NetBSD, OSX, HP-UX      (runable)
119 # S - Linux, SunOS, FreeBSD*, OpenBSD*, NetBSD*, OSX*, HP-UX  (sleeping)
120 # T - Linux, SunOS, FreeBSD, OpenBSD, NetBSD, OSX, HP-UX      (stopped)
121 # Z - Linux, SunOS, FreeBSD, OpenBSD, NetBSD, OSX, HP-UX      (zombie/terminated)
122 # D - Linux, FreeBSD, OpenBSD, NetBSD                         (uninterruptible)
123 # I - FreeBSD, OpenBSD, NetBSD, OSX, HP-UX                    (idle/intermediate)
124 # W - Linux*, FreeBSD*, HP-UX                                 (paging/interrupt/waiting)
125 # L - FreeBSD                                                 (lock)
126 # O - SunOS                                                   (running)
127 # X - Linux, HP-UX*                                           (dead)
128 # U - OSX, NetBSD*                                            (uninterruptible/suspended)
129 # 0 - HP-UX                                                   (nonexistent)
130 # *) Differ meaning
131
132 if [ "$1" = "config" ]; then
133     echo "graph_title Threads"
134     echo "graph_info This graph shows the number of threads"
135     echo "graph_category system"
136     echo "graph_args --base 1000 -l 0"
137     echo "graph_vlabel Number of threads"
138
139     # OS specific flags
140     if [ "$OPERSYS" = "Linux" ]; then
141         echo "graph_order sleeping idle stopped zombie dead paging uninterruptible runnable threads"
142         echo "dead.label dead"
143         echo "dead.draw STACK"
144         echo "dead.colour $DEAD"
145         echo "dead.info The number of dead threads."
146         print_warning dead
147         print_critical dead
148         echo "paging.label paging"
149         echo "paging.draw STACK"
150         echo "paging.colour $PAGING"
151         echo "paging.info The number of paging threads (<2.6 kernels only)."
152         print_warning paging
153         print_critical paging
154
155     elif [ "$OPERSYS" = "SunOS" ]; then
156         echo "graph_order sleeping stopped zombie runnable running total"
157         echo "running.label running"
158         echo "running.draw STACK"
159         echo "running.colour $RUNNING"
160         echo "running.info The number of threads that are running on a processor."
161         print_warning running
162         print_critical running
163         # Be backwards compatible.
164         echo "total.label total"
165         echo "total.draw LINE1"
166         echo "total.colour $TOTAL"
167         echo "total.info The total number of threads."
168         print_warning total
169         print_critical total
170
171     elif [ "$OPERSYS" = "FreeBSD" ]; then
172         echo "graph_order sleeping idle stopped zombie lock uninterruptible interrupt runnable threads"
173         echo "lock.label lock"
174         echo "lock.draw STACK"
175         echo "lock.colour $LOCK"
176         echo "lock.info The number of threads that are waiting to acquire a lock."
177         print_warning lock
178         print_critical lock
179         echo "interrupt.label interrupt"
180         echo "interrupt.draw STACK"
181         echo "interrupt.colour $INTERRUPT"
182         echo "interrupt.info The number of idle interrupt threads."
183         print_warning interrupt
184         print_critical interrupt
185
186     elif [ "$OPERSYS" = "OpenBSD" ]; then
187         echo "graph_order sleeping idle stopped zombie uninterruptible runnable threads"
188
189     elif [ "$OPERSYS" = "NetBSD" ]; then
190         echo "graph_order sleeping idle stopped zombie uninterruptible suspended runnable threads"
191         echo "suspended.label suspended"
192         echo "suspended.draw STACK"
193         echo "suspended.colour $SUSPENDED"
194         echo "suspended.info The number of threads that are suspended."
195         print_warning suspended
196         print_critical suspended
197
198     elif [ "$OPERSYS" = "Darwin" ]; then
199         echo "graph_order sleeping idle stopped zombie uninterruptible running threads"
200         echo "uninterruptible.label uninterruptible"
201         echo "uninterruptible.draw STACK"
202         echo "uninterruptible.colour $UNINTERRUPTIBLE"
203         echo "uninterruptible.info The number of uninterruptible threads (usually IO)."
204         print_warning uninterruptible
205         print_critical uninterruptible
206     elif [ "$OPERSYS" = "HP-UX" ]; then
207         echo "graph_order sleeping intermediate stopped terminated waiting growing nonexistent runnable threads"
208         echo "waiting.label waiting"
209         echo "waiting.draw STACK"
210         echo "waiting.colour $INTERRUPT"
211         echo "waiting.info The number of waiting threads."
212         print_warning waiting
213         print_critical waiting
214         echo "terminated.label terminated"
215         echo "terminated.draw STACK"
216         echo "terminated.colour $ZOMBIE"
217         echo "terminated.info The number of threads that are terminated."
218         print_warning terminated
219         print_critical terminated
220         echo "growing.label growing"
221         echo "growing.draw STACK"
222         echo "growing.colour $RUNNING"
223         echo "growing.info The number of growing threads."
224         print_warning growing
225         print_critical growing
226         echo "intermediate.label intermediate"
227         echo "intermediate.draw STACK"
228         echo "intermediate.colour $IDLE"
229         echo "intermediate.info The number of intermediate threads."
230         print_warning intermediate
231         print_critical intermediate
232         echo "nonexistent.label nonexistent"
233         echo "nonexistent.draw STACK"
234         echo "nonexistent.colour $LOCK"
235         echo "nonexistent.info The number of nonexistent threads."
236         print_warning nonexistent
237         print_critical nonexistent
238     fi
239
240     # Common flags for some OS
241     if [ "$OPERSYS" = "FreeBSD" ] || [ "$OPERSYS" = "OpenBSD" ] ||
242     [ "$OPERSYS" = "NetBSD" ] || [ "$OPERSYS" = "Darwin" ]; then
243         echo "idle.label idle"
244         echo "idle.draw STACK"
245         echo "idle.colour $IDLE"
246         echo "idle.info The number of threads that are idle (sleeping for longer than about 20 seconds)."
247         print_warning idle
248         print_critical idle
249         echo "sleeping.label sleeping"
250         echo "sleeping.draw AREA"
251         echo "sleeping.colour $SLEEPING"
252         echo "sleeping.info The number of threads that are sleeping for less than about 20 seconds."
253         print_warning sleeping
254         print_critical sleeping
255     elif [ "$OPERSYS" = "Linux" ]; then
256         echo "idle.label idle"
257         echo "idle.draw STACK"
258         echo "idle.colour $IDLE"
259         echo "idle.info The number of idle kernel threads (>= 4.2 kernels only)."
260         print_warning idle
261         print_critical idle
262         echo "sleeping.label sleeping"
263         echo "sleeping.draw AREA"
264         echo "sleeping.colour $SLEEPING"
265         echo "sleeping.info The number of sleeping threads."
266         print_warning sleeping
267         print_critical sleeping
268     elif [ "$OPERSYS" = "SunOS" ] || [ "$OPERSYS" = "HP-UX" ]; then
269         echo "sleeping.label sleeping"
270         echo "sleeping.draw AREA"
271         echo "sleeping.colour $SLEEPING"
272         echo "sleeping.info The number of sleeping threads."
273         print_warning sleeping
274         print_critical sleeping
275     fi
276
277     if [ "$OPERSYS" = "Linux" ] || [ "$OPERSYS" = "FreeBSD" ] ||
278     [ "$OPERSYS" = "OpenBSD" ] || [ "$OPERSYS" = "NetBSD" ]; then
279         echo "uninterruptible.label uninterruptible"
280         echo "uninterruptible.draw STACK"
281         echo "uninterruptible.colour $UNINTERRUPTIBLE"
282         echo "uninterruptible.info The number of uninterruptible threads (usually IO)."
283         print_warning uninterruptible
284         print_critical uninterruptible
285     fi
286
287     # Common (non-cygwin) flags
288     if [ "$OPERSYS" != "CYGWIN" ]; then
289         echo "stopped.label stopped"
290         echo "stopped.draw STACK"
291         echo "stopped.colour $STOPPED"
292         echo "stopped.info The number of stopped or traced threads."
293         print_warning stopped
294         print_critical stopped
295
296         echo "runnable.label runnable"
297         echo "runnable.draw STACK"
298         echo "runnable.colour $RUNNABLE"
299         echo "runnable.info The number of runnable threads (on the run queue)."
300         print_warning runnable
301         print_critical runnable
302     fi
303
304     if [ "$OPERSYS" != "CYGWIN" ] && [ "$OPERSYS" != "HP-UX" ]; then
305         echo "zombie.label zombie"
306         echo "zombie.draw STACK"
307         echo "zombie.colour $ZOMBIE"
308         echo "zombie.info The number of defunct ('zombie') threads (process terminated and parent not waiting)."
309         print_warning zombie
310         print_critical zombie
311     fi
312
313     if [ "$OPERSYS" != "SunOS" ]; then
314     # Not using 'graph_total' due to backwards compability. SunOS uses 'total'.
315         #echo 'graph_total total'
316         echo "threads.label total"
317         echo "threads.draw LINE1"
318         echo "threads.colour $TOTAL"
319         echo "threads.info The total number of threads."
320     print_warning threads
321     print_critical threads
322     fi
323
324     exit 0
325 fi
326
327 if [ "$OPERSYS" = "Linux" ]; then
328     # shellcheck disable=SC2016
329     "$ps" --no-header -eTo s | "$awk" '
330 { threads++; stat[$1]++ }
331 END {
332 print "threads.value "        0+threads;
333 print "uninterruptible.value "  0+stat["D"];
334 print "runnable.value "         0+stat["R"];
335 print "sleeping.value "         0+stat["S"];
336 print "idle.value "             0+stat["I"];
337 print "stopped.value "          0+stat["T"];
338 print "paging.value "           0+stat["W"];
339 print "dead.value "             0+stat["X"];
340 print "zombie.value "           0+stat["Z"];
341 }'
342
343 #elif [ "$OPERSYS" = "SunOS" ]; then
344 #    # shellcheck disable=SC2016
345 #    "$ps" -e -o s | "$awk" '
346 #{ total++; stat[$1]++ }
347 #END {
348 #print "total.value "    0+total;
349 #print "running.value "  0+stat["O"];
350 #print "sleeping.value " 0+stat["S"];
351 #print "runnable.value " 0+stat["R"];
352 #print "stopped.value "  0+stat["T"];
353 #print "zombie.value "   0+stat["Z"];
354 #}'
355 #elif [ "$OPERSYS" = "FreeBSD" ]; then
356 #    # shellcheck disable=SC2016
357 #    "$ps" -axo state= | sed -e 's/^\(.\).*/\1/' | "$awk" '
358 #{ threads++; stat[$1]++ }
359 #END {
360 #print "threads.value "        0+threads;
361 #print "uninterruptible.value "  0+stat["D"];
362 #print "idle.value "             0+stat["I"];
363 #print "lock.value "             0+stat["G"];
364 #print "runnable.value "         0+stat["R"];
365 #print "sleeping.value "         0+stat["S"];
366 #print "stopped.value "          0+stat["T"];
367 #print "interrupt.value "        0+stat["W"];
368 #print "zombie.value "           0+stat["Z"];
369 #}'
370 #elif [ "$OPERSYS" = "OpenBSD" ]; then
371 #    # First line is header. Remove it.
372 #    # shellcheck disable=SC2016
373 #    "$ps" -axo state= | sed '1d' | sed -e 's/^\(.\).*/\1/' | "$awk" '
374 #{ threads++; stat[$1]++ }
375 #END {
376 #print "threads.value "        0+threads;
377 #print "uninterruptible.value "  0+stat["D"];
378 #print "idle.value "             0+stat["I"];
379 #print "runnable.value "         0+stat["R"];
380 #print "sleeping.value "         0+stat["S"];
381 #print "stopped.value "          0+stat["T"];
382 #print "zombie.value "           0+stat["Z"];
383 #}'
384 #elif [ "$OPERSYS" = "NetBSD" ]; then
385 #    # First line is header. Remove it.
386 #    # shellcheck disable=SC2016
387 #    "$ps" -axo state= | sed '1d' | sed -e 's/^\(.\).*/\1/' | "$awk" '
388 #{ threads++; stat[$1]++ }
389 #END {
390 #print "threads.value "        0+threads;
391 #print "uninterruptible.value "  0+stat["D"];
392 #print "idle.value "             0+stat["I"];
393 #print "suspended.value "        0+stat["U"];
394 #print "runnable.value "         0+stat["R"];
395 #print "sleeping.value "         0+stat["S"];
396 #print "stopped.value "          0+stat["T"];
397 #print "zombie.value "           0+stat["Z"];
398 #}'
399 #
400 #elif [ "$OPERSYS" = "Darwin" ]; then
401 #    # First line is header. Remove it.
402 #    # shellcheck disable=SC2016
403 #    "$ps" -axo state= | sed '1d' | sed -e 's/^\(.\).*/\1/' | "$awk" '
404 #{ threads++; stat[$1]++ }
405 #END {
406 #print "threads.value "        0+threads;
407 #print "uninterruptible.value "  0+stat["U"];
408 #print "idle.value "             0+stat["I"];
409 #print "runnable.value "         0+stat["R"];
410 #print "sleeping.value "         0+stat["S"];
411 #print "stopped.value "          0+stat["T"];
412 #print "zombie.value "           0+stat["Z"];
413 #}'
414 #
415 #elif [ "$OPERSYS" = "CYGWIN" ]; then
416 #    # First line is header. Remove it. Also remove WINPID duplicates.
417 #    # shellcheck disable=SC2016
418 #    "$ps" -aW | sed '1d' | cut -c 30-36 | sort -u | "$awk" '
419 #{ threads++; }
420 #END {
421 #print "threads.value "        0+threads;
422 #}'
423 #
424 #elif [ "$OPERSYS" = "HP-UX" ]; then
425 #    # First line is header. Remove it.
426 #    # shellcheck disable=SC2016
427 #    "$ps" -el | sed '1d' | "$awk" '{print $2}' | "$awk" '
428 #{ threads++; stat[$1]++ }
429 #END {
430 #print "threads.value "        0+threads;
431 #print "nonexistent.value "      0+stat["0"];
432 #print "sleeping.value "         0+stat["S"];
433 #print "waiting.value "          0+stat["W"];
434 #print "runnable.value "         0+stat["R"];
435 #print "intermediate.value "     0+stat["I"];
436 #print "terminated.value "       0+stat["Z"];
437 #print "stopped.value "          0+stat["T"];
438 #print "growing.value "          0+stat["X"];
439 #}'
440
441 fi