NEWS: Mention "contrib" removal
[monitoring-plugins.git] / plugins-scripts / check_ntp.pl
blob5c87e0a66e66ba003b9d3b6597c0d0fd086a9993
1 #!/usr/bin/perl -w
3 # (c)1999 Ian Cass, Knowledge Matters Ltd.
4 # Read the GNU copyright stuff for all the legalese
6 # Check NTP time servers plugin. This plugin requires the ntpdate utility to
7 # be installed on the system, however since it's part of the ntp suite, you
8 # should already have it installed.
11 # Nothing clever done in this program - its a very simple bare basics hack to
12 # get the job done.
14 # Things to do...
15 # check @words[9] for time differences greater than +/- x secs & return a
16 # warning.
18 # (c) 1999 Mark Jewiss, Knowledge Matters Limited
19 # 22-9-1999, 12:45
21 # Modified script to accept 2 parameters or set defaults.
22 # Now issues warning or critical alert is time difference is greater than the
23 # time passed.
25 # These changes have not been tested completely due to the unavailability of a
26 # server with the incorrect time.
28 # (c) 1999 Bo Kersey, VirCIO - Managed Server Solutions <bo@vircio.com>
29 # 22-10-99, 12:17
31 # Modified the script to give useage if no parameters are input.
33 # Modified the script to check for negative as well as positive
34 # time differences.
36 # Modified the script to work with ntpdate 3-5.93e Wed Apr 14 20:23:03 EDT 1999
38 # Modified the script to work with ntpdate's that return adjust or offset...
41 # Script modified 2000 June 01 by William Pietri <william@bianca.com>
43 # Modified script to handle weird cases:
44 # o NTP server doesn't respond (e.g., has died)
45 # o Server has correct time but isn't suitable synchronization
46 # source. This happens while starting up and if contact
47 # with master has been lost.
49 # Modifed to run under Embedded Perl (sghosh@users.sf.net)
50 # - combined logic some blocks together..
52 # Added ntpdate check for stratum 16 desynch peer (James Fidell) Feb 03, 2003
54 # ntpdate - offset is in seconds
55 # changed ntpdc to ntpq - jitter/dispersion is in milliseconds
57 # Patch for for regex for stratum1 refid.
59 require 5.004;
60 use POSIX;
61 use strict;
62 use Getopt::Long;
63 use vars qw($opt_V $opt_h $opt_H $opt_t $opt_w $opt_c $opt_O $opt_j $opt_k $verbose $PROGNAME $def_jitter $ipv4 $ipv6);
64 use lib utils.pm;
65 use utils qw($TIMEOUT %ERRORS &print_revision &support);
67 $PROGNAME="check_ntp";
69 sub print_help ();
70 sub print_usage ();
72 $ENV{'PATH'}='';
73 $ENV{'BASH_ENV'}='';
74 $ENV{'ENV'}='';
76 # defaults in sec
77 my $DEFAULT_OFFSET_WARN = 60; # 1 minute
78 my $DEFAULT_OFFSET_CRIT = 120; # 2 minutes
79 # default in millisec
80 my $DEFAULT_JITTER_WARN = 5000; # 5 sec
81 my $DEFAULT_JITTER_CRIT = 10000; # 10 sec
83 Getopt::Long::Configure('bundling');
84 GetOptions
85 ("V" => \$opt_V, "version" => \$opt_V,
86 "h" => \$opt_h, "help" => \$opt_h,
87 "v" => \$verbose, "verbose" => \$verbose,
88 "4" => \$ipv4, "use-ipv4" => \$ipv4,
89 "6" => \$ipv6, "use-ipv6" => \$ipv6,
90 "w=f" => \$opt_w, "warning=f" => \$opt_w, # offset|adjust warning if above this number
91 "c=f" => \$opt_c, "critical=f" => \$opt_c, # offset|adjust critical if above this number
92 "O" => \$opt_O, "zero-offset" => \$opt_O, # zero-offset bad
93 "j=s" => \$opt_j, "jwarn=i" => \$opt_j, # jitter warning if above this number
94 "k=s" => \$opt_k, "jcrit=i" => \$opt_k, # jitter critical if above this number
95 "t=s" => \$opt_t, "timeout=i" => \$opt_t,
96 "H=s" => \$opt_H, "hostname=s" => \$opt_H);
98 if ($opt_V) {
99 print_revision($PROGNAME,'@NP_VERSION@');
100 exit $ERRORS{'OK'};
103 if ($opt_h) {
104 print_help();
105 exit $ERRORS{'OK'};
108 # jitter test params specified
109 if (defined $opt_j || defined $opt_k ) {
110 $def_jitter = 1;
113 $opt_H = shift unless ($opt_H);
114 my $host = $1 if ($opt_H && $opt_H =~ m/^([0-9]+\.[0-9]+\.[0-9]+\.[0-9]+|[a-zA-Z][-a-zA-Z0-9]+(\.[a-zA-Z][-a-zA-Z0-9]+)*)$/);
115 unless ($host) {
116 print "No target host specified\n";
117 print_usage();
118 exit $ERRORS{'UNKNOWN'};
121 my ($timeout, $owarn, $ocrit, $jwarn, $jcrit);
123 $timeout = $TIMEOUT;
124 ($opt_t) && ($opt_t =~ /^([0-9]+)$/) && ($timeout = $1);
126 $owarn = $DEFAULT_OFFSET_WARN;
127 ($opt_w) && ($opt_w =~ /^([0-9.]+)$/) && ($owarn = $1);
129 $ocrit = $DEFAULT_OFFSET_CRIT;
130 ($opt_c) && ($opt_c =~ /^([0-9.]+)$/) && ($ocrit = $1);
132 $jwarn = $DEFAULT_JITTER_WARN;
133 ($opt_j) && ($opt_j =~ /^([0-9]+)$/) && ($jwarn = $1);
135 $jcrit = $DEFAULT_JITTER_CRIT;
136 ($opt_k) && ($opt_k =~ /^([0-9]+)$/) && ($jcrit = $1);
138 if ($ocrit < $owarn ) {
139 print "Critical offset should be larger than warning offset\n";
140 print_usage();
141 exit $ERRORS{"UNKNOWN"};
144 if ($def_jitter) {
145 if ($opt_k < $opt_j) {
146 print "Critical jitter should be larger than warning jitter\n";
147 print_usage();
148 exit $ERRORS{'UNKNOWN'};
153 my $stratum = -1;
154 my $ignoreret = 0;
155 my $answer = undef;
156 my $offset = undef;
157 my $jitter = undef;
158 my $syspeer = undef;
159 my $candidate = 0;
160 my @candidates;
161 my $msg; # first line of output to print if format is invalid
163 my $state = $ERRORS{'UNKNOWN'};
164 my $ntpdate_error = $ERRORS{'UNKNOWN'};
165 my $jitter_error = $ERRORS{'UNKNOWN'};
167 # some systems don't have a proper ntpq (migrated from ntpdc)
168 my $have_ntpq = undef;
169 if ($utils::PATH_TO_NTPQ && -x $utils::PATH_TO_NTPQ ) {
170 $have_ntpq = 1;
171 }else{
172 $have_ntpq = 0;
175 # Just in case of problems, let's not hang Nagios
176 $SIG{'ALRM'} = sub {
177 print ("ERROR: No response from ntp server (alarm)\n");
178 exit $ERRORS{"UNKNOWN"};
180 alarm($timeout);
182 # Determine protocol to be used for ntpdate and ntpq
183 my $ntpdate = $utils::PATH_TO_NTPDATE;
184 my $ntpq = $utils::PATH_TO_NTPQ;
185 if ($ipv4) {
186 $ntpdate .= " -4";
187 $ntpq .= " -4";
189 elsif ($ipv6) {
190 $ntpdate .= " -6";
191 $ntpq .= " -6";
193 # else don't use any flags
197 ### First, check ntpdate
201 if (!open (NTPDATE, $ntpdate . " -q $host 2>&1 |")) {
202 print "Could not open $ntpdate: $!\n";
203 exit $ERRORS{"UNKNOWN"};
206 my $out;
207 while (<NTPDATE>) {
208 #print if ($verbose); # noop
209 $msg = $_ unless ($msg);
210 $out .= "$_ ";
212 if (/stratum\s(\d+)/) {
213 $stratum = $1;
216 if (/(offset|adjust)\s+([-.\d]+)/i) {
217 $offset = $2;
219 # An offset of 0.000000 with an error is probably bogus. Actually,
220 # it's probably always bogus, but let's be paranoid here.
221 # Has been reported that 0.0000 happens in a production environment
222 # on Solaris 8 so this check should be taken out - SF tracker 1150777
223 if (defined $opt_O ) {
224 if ($offset == 0) { undef $offset;}
227 $ntpdate_error = defined ($offset) ? $ERRORS{"OK"} : $ERRORS{"CRITICAL"};
228 print "ntperr = $ntpdate_error \n" if $verbose;
232 if (/no server suitable for synchronization found/) {
233 if ($stratum == 16) {
234 $ntpdate_error = $ERRORS{"WARNING"};
235 $msg = "Desynchronized peer server found";
236 $ignoreret=1;
238 else {
239 $ntpdate_error = $ERRORS{"CRITICAL"};
240 $msg = "No suitable peer server found - ";
245 $out =~ s/\n//g;
246 close (NTPDATE) ||
247 die $! ? "$out - Error closing $ntpdate pipe: $!"
248 : "$out - Exit status: $? from $ntpdate\n";
250 # declare an error if we also get a non-zero return code from ntpdate
251 # unless already set to critical
252 if ( $? && !$ignoreret ) {
253 print "stderr = $? : $! \n" if $verbose;
254 $ntpdate_error = $ntpdate_error == $ERRORS{"CRITICAL"} ? $ERRORS{"CRITICAL"} : $ERRORS{"UNKNOWN"} ;
255 print "ntperr = $ntpdate_error : $!\n" if $verbose;
260 ### Then scan xntpq/ntpq if it exists
261 ### and look in the 11th column for jitter
263 # Field 1: Tally Code ( Space, 'x','.','-','+','#','*','o')
264 # Only match for '*' which implies sys.peer
265 # or 'o' which implies pps.peer
266 # If both exist, the last one is picked.
267 # Field 2: address of the remote peer
268 # Field 3: Refid of the clock (0.0.0.0 if unknown, WWWV/PPS/GPS/ACTS/USNO/PCS/... if Stratum1)
269 # Field 4: stratum (0-15)
270 # Field 5: Type of the peer: local (l), unicast (u), multicast (m)
271 # broadcast (b); not sure about multicast/broadcast
272 # Field 6: last packet receive (in seconds)
273 # Field 7: polling interval
274 # Field 8: reachability resgister (octal)
275 # Field 9: delay
276 # Field 10: offset
277 # Field 11: dispersion/jitter
279 # According to bug 773588 Some solaris xntpd implementations seemto match on
280 # "#" even though the docs say it exceeds maximum distance. Providing patch
281 # here which will generate a warining.
283 if ($have_ntpq) {
285 if ( open(NTPQ, $ntpq . " -np $host 2>&1 |") ) {
286 while (<NTPQ>) {
287 print $_ if ($verbose);
288 if ( /timed out/ ){
289 $have_ntpq = 0 ;
290 last ;
292 # number of candidates on <host> for sys.peer
293 if (/^(\*|\+|\#|o])/) {
294 ++$candidate;
295 push (@candidates, $_);
296 print "Candidate count= $candidate\n" if ($verbose);
299 # match sys.peer or pps.peer
300 if (/^(\*|o)(\S+)\s+(\S+)\s+(\S+)\s+(\S+)\s+(\S+)\s+(\S+)\s+(\S+)\s+(\S+)\s+(\S+)\s+(\S+)/) {
301 $syspeer = $2;
302 $stratum = $4;
303 $jitter = $11;
304 print "match $_ \n" if $verbose;
305 if ($jitter > $jcrit) {
306 print "Jitter_crit = $11 :$jcrit\n" if ($verbose);
307 $jitter_error = $ERRORS{'CRITICAL'};
308 } elsif ($jitter > $jwarn ) {
309 print "Jitter_warn = $11 :$jwarn\n" if ($verbose);
310 $jitter_error = $ERRORS{'WARNING'};
311 } else {
312 $jitter_error = $ERRORS{'OK'};
314 } else {
315 print "No match!\n" if $verbose;
316 $jitter = '(not parsed)';
320 close NTPQ ||
321 die $! ? "Error closing $ntpq pipe: $!"
322 : "Exit status: $? from $ntpq\n";
324 # if we did not match sys.peer or pps.peer but matched # candidates only
325 # generate a warning
326 # based on bug id 773588
327 unless (defined $syspeer) {
328 if ($#candidates >=0) {
329 foreach my $c (@candidates) {
330 $c =~ /^(#)([-0-9.\s]+)\s+([-0-9A-Za-z_().]+)\s+([-0-9.]+)\s+([lumb-]+)\s+([-0-9m.]+)\s+([-0-9.]+)\s+([-0-9.]+)\s+([-0-9.]+)\s+([-0-9.]+)\s+([-0-9.]+)/;
331 $syspeer = $2;
332 $stratum = $4;
333 $jitter = $11;
334 print "candidate match $c \n" if $verbose;
335 if ($jitter > $jcrit) {
336 print "Candidate match - Jitter_crit = $11 :$jcrit\n" if ($verbose);
337 $jitter_error = $ERRORS{'CRITICAL'};
338 }elsif ($jitter > $jwarn ) {
339 print "Candidate match - Jitter_warn = $11 :$jwarn \n" if ($verbose);
340 $jitter_error = $ERRORS{'WARNING'};
341 } else {
342 $jitter_error = $ERRORS{'WARNING'};
352 if ($ntpdate_error != $ERRORS{'OK'}) {
353 $state = $ntpdate_error;
354 if ($ntpdate_error == $ERRORS{'WARNING'} ) {
355 $answer = $msg;
357 else {
358 $answer = $msg . "Server for ntp probably down";
361 if (defined($offset) && abs($offset) > $ocrit) {
362 $state = $ERRORS{'CRITICAL'};
363 $answer = "Server Error and offset $offset sec > +/- $ocrit sec";
364 } elsif (defined($offset) && abs($offset) > $owarn) {
365 $answer = "Server error and offset $offset sec > +/- $owarn sec";
366 } elsif (defined($jitter) && abs($jitter) > $jcrit) {
367 $answer = "Server error and jitter $jitter msec > +/- $jcrit msec";
368 } elsif (defined($jitter) && abs($jitter) > $jwarn) {
369 $answer = "Server error and jitter $jitter msec > +/- $jwarn msec";
372 } elsif ($have_ntpq && $jitter_error != $ERRORS{'OK'}) {
373 $state = $jitter_error;
374 $answer = "Jitter $jitter too high";
375 if (defined($offset) && abs($offset) > $ocrit) {
376 $state = $ERRORS{'CRITICAL'};
377 $answer = "Jitter error and offset $offset sec > +/- $ocrit sec";
378 } elsif (defined($offset) && abs($offset) > $owarn) {
379 $answer = "Jitter error and offset $offset sec > +/- $owarn sec";
380 } elsif (defined($jitter) && abs($jitter) > $jcrit) {
381 $answer = "Jitter error and jitter $jitter msec > +/- $jcrit msec";
382 } elsif (defined($jitter) && abs($jitter) > $jwarn) {
383 $answer = "Jitter error and jitter $jitter msec > +/- $jwarn msec";
386 } elsif( !$have_ntpq ) { # no errors from ntpdate and no ntpq or ntpq timed out
387 if (abs($offset) > $ocrit) {
388 $state = $ERRORS{'CRITICAL'};
389 $answer = "Offset $offset sec > +/- $ocrit sec";
390 } elsif (abs($offset) > $owarn) {
391 $state = $ERRORS{'WARNING'};
392 $answer = "Offset $offset sec > +/- $owarn sec";
393 } elsif (( abs($offset) > $owarn) && $def_jitter ) {
394 $state = $ERRORS{'WARNING'};
395 $answer = "Offset $offset sec > +/- $owarn sec, ntpq timed out";
396 } elsif ( $def_jitter ) {
397 $state = $ERRORS{'WARNING'};
398 $answer = "Offset $offset secs, ntpq timed out";
399 } else{
400 $state = $ERRORS{'OK'};
401 $answer = "Offset $offset secs";
406 } else { # no errors from ntpdate or ntpq
407 if (abs($offset) > $ocrit) {
408 $state = $ERRORS{'CRITICAL'};
409 $answer = "Offset $offset sec > +/- $ocrit sec, jitter $jitter msec";
410 } elsif (abs($jitter) > $jcrit ) {
411 $state = $ERRORS{'CRITICAL'};
412 $answer = "Jitter $jitter msec> +/- $jcrit msec, offset $offset sec";
413 } elsif (abs($offset) > $owarn) {
414 $state = $ERRORS{'WARNING'};
415 $answer = "Offset $offset sec > +/- $owarn sec, jitter $jitter msec";
416 } elsif (abs($jitter) > $jwarn ) {
417 $state = $ERRORS{'WARNING'};
418 $answer = "Jitter $jitter msec> +/- $jwarn msec, offset $offset sec";
420 } else {
421 $state = $ERRORS{'OK'};
422 $answer = "Offset $offset secs, jitter $jitter msec, peer is stratum $stratum";
427 foreach my $key (keys %ERRORS) {
428 if ($state==$ERRORS{$key}) {
429 # print ("NTP $key: $answer");
430 print ("NTP $key: $answer|offset=$offset, jitter=" . $jitter/1000 . ",peer_stratum=$stratum\n");
431 last;
434 exit $state;
437 ####
438 #### subs
440 sub print_usage () {
441 print "Usage: $PROGNAME -H <host> [-46] [-O] [-w <warn>] [-c <crit>] [-j <warn>] [-k <crit>] [-v verbose]\n";
444 sub print_help () {
445 print_revision($PROGNAME,'@NP_VERSION@');
446 print "Copyright (c) 2003 Bo Kersey/Karl DeBisschop\n";
447 print "\n";
448 print_usage();
449 print "
450 Checks the local timestamp offset versus <host> with ntpdate
451 Checks the jitter/dispersion of clock signal between <host> and its sys.peer with ntpq\n
452 -O (--zero-offset)
453 A zero offset on \"ntpdate\" will generate a CRITICAL.\n
454 -w (--warning)
455 Clock offset in seconds at which a warning message will be generated.\n Defaults to $DEFAULT_OFFSET_WARN.
456 -c (--critical)
457 Clock offset in seconds at which a critical message will be generated.\n Defaults to $DEFAULT_OFFSET_CRIT.
458 -j (--jwarn)
459 Clock jitter in milliseconds at which a warning message will be generated.\n Defaults to $DEFAULT_JITTER_WARN.
460 -k (--jcrit)
461 Clock jitter in milliseconds at which a critical message will be generated.\n Defaults to $DEFAULT_JITTER_CRIT.
463 If jitter/dispersion is specified with -j or -k and ntpq times out, then a
464 warning is returned.\n
465 -4 (--use-ipv4)
466 Use IPv4 connection
467 -6 (--use-ipv6)
468 Use IPv6 connection
469 \n";
470 support();