[Nagiosplug-help] Checking for a process

[Karl DeBisschop]

On Thu, 2003-01-30 at 05:47, Voon, Ton wrote:
> David,
> 
> I'm looking at the help now and I don't fully understand it either:

I wrote it, so blame goes to me.

1) range refers to range of acceptable values, anything outside the
range generates an error

2) range is specified min:max

3) if you specify max:min, then everything inside the range is critical.

When I first created the concept of ranges (for check_snmp, IIRC) there
seemed a strong reason that you had to specify the acceptable range in
default usage. I don't remember the logic. Perhaps it only survives in
long-lost archives.

Of course, changing now would be rather painful anyway, so it's probably
moot.

Anyway, the help text tries to say items 1 thru 3 above. Can the list
suggest improvements?

> <quote>
> check_snmp (nagios-plugins 1.3.0-beta2) 1.5
> The nagios plugins come with ABSOLUTELY NO WARRANTY. You may redistribute
> copies of the plugins under the terms of the GNU General Public License.
> For more information about these matters, see the file named COPYING.
> Copyright (c) 1999-2002 Ethan Galstad <nagios at nagios.org>
> 
> Check the number of currently running processes and generates WARNING or
> CRITICAL states if the process count is outside the specified threshold
> ranges. The process count can be filtered by process owner, parent process
> PID, current state (e.g., 'Z'), or may be the total number of running
> processes
> 
> Usage:
>  check_procs -w <range> -c <range> [-s state] [-p ppid] [-u user]
>              [-a argument-array] [-C command]
>  check_procs --version
>  check_procs --help
> 
> Required Arguments:
>  -w, --warning=RANGE
>     generate warning state if process count is outside this range
>  -c, --critical=RANGE
>     generate critical state if process count is outside this range
> 
> Optional Filters:
>  -s, --state=STATUSFLAGS
>     Only scan for processes that have, in the output of `ps`, one or
>     more of the status flags you specify (for example R, Z, S, RS,
>     RSZDT, plus others based on the output of your 'ps' command).
>  -p, --ppid=PPID
>     Only scan for children of the parent process ID indicated.
>  -u, --user=USER
>     Only scan for proceses with user name or ID indicated.
>  -a, --argument-array=STRING
>     Only scan for ARGS that match up to the length of the given STRING
>  -C, --command=COMMAND
>     Only scan for exact matches to the named COMMAND.
> 
> RANGEs are specified 'min:max' or 'min:' or ':max' (or 'max'). If
> specified 'max:min', a warning status will be generated if the
> count is inside the specified range
> </quote>
> 
> I'll get the program name at the top fixed ;-)
> 
> I think the final paragraph is the confusing one. I think the corrections
> should be "If specified 'min:max'" and "outside the specified range".
> 
> What would you want it to read?
> 
> Ton
> 
> > -----Original Message-----
> > From:	David Corbin [SMTP:dcorbin at machturtle.com]
> > Sent:	Thursday, January 30, 2003 12:01 AM
> > To:	Voon, Ton
> > Cc:	nagiosplug-help at lists.sourceforge.net
> > Subject:	Re: [Nagiosplug-help] Checking for a process
> > 
> > Yep.  That was it.  It's all a matter of how a range is specified, which 
> > doesn't seem to be documented  in the help.
> > 
> > Voon, Ton wrote:
> > 
> > >David,
> > >
> > >I think this should do what you want:
> > >
> > >check_procs -c 1:1 -C fetchmailx
> > >
> > >Be aware that the -C is not a pattern-match: it must be the full name of
> > the
> > >command. Run "check_procs -v" to see the ps command used and it should be
> > >the process name in the last column.
> > >
> > >Ton
> > >
> > >-----Original Message-----
> > >From: David Corbin [mailto:dcorbin at machturtle.com]
> > >Sent: 29 January 2003 12:23
> > >To: Voon, Ton
> > >Cc: nagiosplug-help at lists.sourceforge.net
> > >Subject: Re: [Nagiosplug-help] Checking for a process
> > >
> > >
> > >I don't mean to be stupid, but ....  It's clear I don't understand  the 
> > >command line arguments.  I've tried playing with several combinations of 
> > >arguments, but they all yield "OK".   What should the arguments be to 
> > >verify that exactly one instance of the process is running?  (I think 
> > >I've got the -C part right, it's the rest that's causing me grief).
> > >
> > >oboe:/usr/local/nagios/libexec# ./check_procs -w 1-1 -c 1-1 -C fetchmailx
> > >OK - 0 processes running with command name fetchmailx
> > >
> > >Thanks
> > >David
> > >
> > >Voon, Ton wrote:
> > >
> > >  
> > >
> > >>check_procs ;-)
> > >>
> > >>-----Original Message-----
> > >>From: David Corbin [mailto:dcorbin at machturtle.com]
> > >>Sent: 29 January 2003 11:55
> > >>To: nagiosplug-help at lists.sourceforge.net
> > >>Subject: [Nagiosplug-help] Checking for a process
> > >>
> > >>
> > >>Is there a plugin that is designed to check that a particular process is
> > 
> > >>running?
> > >>
> > >>Thanks
> > >>David
> > >>
> > >> 
> > >>
> > >>    
> > >>
> > >
> > >
> > >
> > >
> > >-------------------------------------------------------
> > >This SF.NET email is sponsored by:
> > >SourceForge Enterprise Edition + IBM + LinuxWorld = Something 2 See!
> > >http://www.vasoftware.com
> > >_______________________________________________
> > >Nagiosplug-help mailing list
> > >Nagiosplug-help at lists.sourceforge.net
> > >https://lists.sourceforge.net/lists/listinfo/nagiosplug-help
> > >
> > >
> > >This private and confidential e-mail has been sent to you by Egg.
> > >The Egg group of companies includes Egg Banking plc
> > >(registered no. 2999842), Egg Financial Products Ltd (registered
> > >no. 3319027) and Egg Investments Ltd (registered no. 3403963) which
> > >carries out investment business on behalf of Egg and is regulated
> > >by the Financial Services Authority.  
> > >Registered in England and Wales. Registered offices: 1 Waterhouse Square,
> > >138-142 Holborn, London EC1N 2NA.
> > >If you are not the intended recipient of this e-mail and have
> > >received it in error, please notify the sender by replying with
> > >'received in error' as the subject and then delete it from your
> > >mailbox.
> > >
> > >  
> > >
> > 
> > 
> > 
> 
> 
> This private and confidential e-mail has been sent to you by Egg.
> The Egg group of companies includes Egg Banking plc
> (registered no. 2999842), Egg Financial Products Ltd (registered
> no. 3319027) and Egg Investments Ltd (registered no. 3403963) which
> carries out investment business on behalf of Egg and is regulated
> by the Financial Services Authority.  
> Registered in England and Wales. Registered offices: 1 Waterhouse Square,
> 138-142 Holborn, London EC1N 2NA.
> If you are not the intended recipient of this e-mail and have
> received it in error, please notify the sender by replying with
> 'received in error' as the subject and then delete it from your
> mailbox.
> 
> 
> 
> -------------------------------------------------------
> This SF.NET email is sponsored by:
> SourceForge Enterprise Edition + IBM + LinuxWorld = Something 2 See!
> http://www.vasoftware.com
> _______________________________________________
> Nagiosplug-help mailing list
> Nagiosplug-help at lists.sourceforge.net
> https://lists.sourceforge.net/lists/listinfo/nagiosplug-help