From e620f9515b56a749038e8975c64125ed38d37ccd Mon Sep 17 00:00:00 2001 From: Alvar Penning Date: Wed, 13 Nov 2024 09:36:06 +0100 Subject: [PATCH] ITL: Add --exclude-process to check_procs For check_procs, both the Monitoring Plugins' implementation[0] and the Nagios Plugin[1] are supporting the "-X" or "--exclude-process" flag to exclude one or many processes by name. However, this flag is missing here in the Icinga Template Library. The Nagios Plugin implementation also comes with "-j" and "-g" for FreeBSD jails and Linux cgroups, respectively. But, to keep it compatible, I would ignore these for the moment. Closes #10226. [0]: https://www.monitoring-plugins.org/doc/man/check_procs.html [1]: https://nagios-plugins.org/doc/man/check_procs.html --- doc/10-icinga-template-library.md | 35 ++++++++++++++++--------------- itl/command-plugins.conf | 4 ++++ 2 files changed, 22 insertions(+), 17 deletions(-) diff --git a/doc/10-icinga-template-library.md b/doc/10-icinga-template-library.md index 249e43ff48b..079612d4285 100644 --- a/doc/10-icinga-template-library.md +++ b/doc/10-icinga-template-library.md @@ -1225,23 +1225,24 @@ of processes. Search filters can be applied to limit the processes to check. Custom variables passed as [command parameters](03-monitoring-basics.md#command-passing-parameters): -Name | Description ----------------------|-------------- -procs_warning | **Optional.** The process count warning threshold. Defaults to 250. -procs_critical | **Optional.** The process count critical threshold. Defaults to 400. -procs_metric | **Optional.** Check thresholds against metric. -procs_timeout | **Optional.** Seconds before plugin times out. -procs_traditional | **Optional.** Filter own process the traditional way by PID instead of /proc/pid/exe. Defaults to false. -procs_state | **Optional.** Only scan for processes that have one or more of the status flags you specify. -procs_ppid | **Optional.** Only scan for children of the parent process ID indicated. -procs_vsz | **Optional.** Only scan for processes with VSZ higher than indicated. -procs_rss | **Optional.** Only scan for processes with RSS higher than indicated. -procs_pcpu | **Optional.** Only scan for processes with PCPU higher than indicated. -procs_user | **Optional.** Only scan for processes with user name or ID indicated. -procs_argument | **Optional.** Only scan for processes with args that contain STRING. -procs_argument_regex | **Optional.** Only scan for processes with args that contain the regex STRING. -procs_command | **Optional.** Only scan for exact matches of COMMAND (without path). -procs_nokthreads | **Optional.** Only scan for non kernel threads. Defaults to false. +Name | Description +----------------------|-------------- +procs_warning | **Optional.** The process count warning threshold. Defaults to 250. +procs_critical | **Optional.** The process count critical threshold. Defaults to 400. +procs_metric | **Optional.** Check thresholds against metric. +procs_timeout | **Optional.** Seconds before plugin times out. +procs_traditional | **Optional.** Filter own process the traditional way by PID instead of /proc/pid/exe. Defaults to false. +procs_state | **Optional.** Only scan for processes that have one or more of the status flags you specify. +procs_ppid | **Optional.** Only scan for children of the parent process ID indicated. +procs_vsz | **Optional.** Only scan for processes with VSZ higher than indicated. +procs_rss | **Optional.** Only scan for processes with RSS higher than indicated. +procs_pcpu | **Optional.** Only scan for processes with PCPU higher than indicated. +procs_user | **Optional.** Only scan for processes with user name or ID indicated. +procs_argument | **Optional.** Only scan for processes with args that contain STRING. +procs_argument_regex | **Optional.** Only scan for processes with args that contain the regex STRING. +procs_command | **Optional.** Only scan for exact matches of COMMAND (without path). +procs_exclude_process | **Optional.** Exclude processes which match this comma separated list. +procs_nokthreads | **Optional.** Only scan for non kernel threads. Defaults to false. ### radius diff --git a/itl/command-plugins.conf b/itl/command-plugins.conf index 716dde75720..5fc9ab4356f 100644 --- a/itl/command-plugins.conf +++ b/itl/command-plugins.conf @@ -1842,6 +1842,10 @@ object CheckCommand "procs" { value = "$procs_command$" description = "Only scan for exact matches of COMMAND (without path)" } + "-X" = { + value = "$procs_exclude_process$" + description = "Exclude processes which match this comma separated list" + } "-k" = { set_if = "$procs_nokthreads$" description = "Only scan for non kernel threads"