summaryrefslogtreecommitdiffstats
path: root/plugins/check_dbi.c
diff options
context:
space:
mode:
Diffstat (limited to 'plugins/check_dbi.c')
-rw-r--r--plugins/check_dbi.c131
1 files changed, 70 insertions, 61 deletions
diff --git a/plugins/check_dbi.c b/plugins/check_dbi.c
index 611e0e7..f009944 100644
--- a/plugins/check_dbi.c
+++ b/plugins/check_dbi.c
@@ -10,7 +10,7 @@
10* 10*
11* This file contains the check_dbi plugin 11* This file contains the check_dbi plugin
12* 12*
13* Runs an arbitrary SQL command and checks the result. 13* Runs an arbitrary (SQL) command and checks the result.
14* 14*
15* 15*
16* This program is free software: you can redistribute it and/or modify 16* This program is free software: you can redistribute it and/or modify
@@ -38,10 +38,17 @@ const char *email = "nagiosplug-devel@lists.sourceforge.net";
38 38
39#include "netutils.h" 39#include "netutils.h"
40 40
41#include <assert.h>
42
41#include <dbi/dbi.h> 43#include <dbi/dbi.h>
42 44
43#include <stdarg.h> 45#include <stdarg.h>
44 46
47typedef enum {
48 METRIC_CONN_TIME,
49 METRIC_QUERY_RESULT,
50} np_dbi_metric_t;
51
45typedef struct { 52typedef struct {
46 char *key; 53 char *key;
47 char *value; 54 char *value;
@@ -52,11 +59,9 @@ int verbose = 0;
52 59
53char *warning_range = NULL; 60char *warning_range = NULL;
54char *critical_range = NULL; 61char *critical_range = NULL;
55thresholds *query_thresholds = NULL; 62thresholds *dbi_thresholds = NULL;
56 63
57char *conntime_warning_range = NULL; 64np_dbi_metric_t metric = METRIC_QUERY_RESULT;
58char *conntime_critical_range = NULL;
59thresholds *conntime_thresholds = NULL;
60 65
61char *np_dbi_driver = NULL; 66char *np_dbi_driver = NULL;
62driver_option_t *np_dbi_options = NULL; 67driver_option_t *np_dbi_options = NULL;
@@ -78,11 +83,8 @@ int do_query (dbi_conn, double *, double *);
78int 83int
79main (int argc, char **argv) 84main (int argc, char **argv)
80{ 85{
81 int conntime_status = STATE_UNKNOWN;
82 int status = STATE_UNKNOWN; 86 int status = STATE_UNKNOWN;
83 87
84 int exit_status = STATE_UNKNOWN;
85
86 dbi_driver driver; 88 dbi_driver driver;
87 dbi_conn conn; 89 dbi_conn conn;
88 90
@@ -198,7 +200,8 @@ main (int argc, char **argv)
198 if (verbose) 200 if (verbose)
199 printf("Time elapsed: %f\n", conn_time); 201 printf("Time elapsed: %f\n", conn_time);
200 202
201 conntime_status = get_status (conn_time, conntime_thresholds); 203 if (metric == METRIC_CONN_TIME)
204 status = get_status (conn_time, dbi_thresholds);
202 205
203 /* select a database */ 206 /* select a database */
204 if (np_dbi_database) { 207 if (np_dbi_database) {
@@ -212,36 +215,35 @@ main (int argc, char **argv)
212 } 215 }
213 } 216 }
214 217
215 /* execute query */ 218 if (np_dbi_query) {
216 status = do_query (conn, &query_val, &query_time); 219 /* execute query */
217 if (status != STATE_OK) 220 status = do_query (conn, &query_val, &query_time);
218 /* do_query prints an error message in this case */ 221 if (status != STATE_OK)
219 return status; 222 /* do_query prints an error message in this case */
223 return status;
220 224
221 status = get_status (query_val, query_thresholds); 225 if (metric == METRIC_QUERY_RESULT)
226 status = get_status (query_val, dbi_thresholds);
227 }
222 228
223 if (verbose) 229 if (verbose)
224 printf("Closing connection\n"); 230 printf("Closing connection\n");
225 dbi_conn_close (conn); 231 dbi_conn_close (conn);
226 232
227 /* 'conntime_status' is worse than 'status' (but not UNKOWN) */ 233 printf ("%s - connection time: %fs", state_text (status), conn_time);
228 if (((conntime_status < STATE_UNKNOWN) && (conntime_status > status)) 234 if (np_dbi_query)
229 /* 'status' is UNKNOWN and 'conntime_status' is not OK */ 235 printf (", '%s' returned %f in %fs", np_dbi_query, query_val, query_time);
230 || ((status >= STATE_UNKNOWN) && (conntime_status != STATE_OK))) 236
231 exit_status = conntime_status; 237 printf (" | conntime=%fs;%s;%s;0;", conn_time,
232 else 238 ((metric == METRIC_CONN_TIME) && warning_range) ? warning_range : "",
233 exit_status = status; 239 ((metric == METRIC_CONN_TIME) && critical_range) ? critical_range : "");
234 240 if (np_dbi_query)
235 printf ("%s - %s: connection time: %fs, %s: '%s' returned %f in %fs", 241 printf (" query=%f;%s;%s;; querytime=%fs;;;0;", query_val,
236 state_text (exit_status), 242 ((metric == METRIC_QUERY_RESULT) && warning_range) ? warning_range : "",
237 state_text (conntime_status), conn_time, 243 ((metric == METRIC_QUERY_RESULT) && critical_range) ? critical_range : "",
238 state_text (status), np_dbi_query, query_val, query_time); 244 query_time);
239 printf (" | conntime=%fs;%s;%s;0; query=%f;%s;%s;; querytime=%fs;;;0;\n", conn_time, 245 printf ("\n");
240 conntime_warning_range ? conntime_warning_range : "", 246 return status;
241 conntime_critical_range ? conntime_critical_range : "",
242 query_val, warning_range ? warning_range : "", critical_range ? critical_range : "",
243 query_time);
244 return exit_status;
245} 247}
246 248
247/* process command-line arguments */ 249/* process command-line arguments */
@@ -254,9 +256,7 @@ process_arguments (int argc, char **argv)
254 static struct option longopts[] = { 256 static struct option longopts[] = {
255 STD_LONG_OPTS, 257 STD_LONG_OPTS,
256 258
257 {"conntime-warning", required_argument, 0, 'W'}, 259 {"metric", required_argument, 0, 'm'},
258 {"conntime-critical", required_argument, 0, 'C'},
259
260 {"driver", required_argument, 0, 'd'}, 260 {"driver", required_argument, 0, 'd'},
261 {"option", required_argument, 0, 'o'}, 261 {"option", required_argument, 0, 'o'},
262 {"query", required_argument, 0, 'q'}, 262 {"query", required_argument, 0, 'q'},
@@ -265,7 +265,7 @@ process_arguments (int argc, char **argv)
265 }; 265 };
266 266
267 while (1) { 267 while (1) {
268 c = getopt_long (argc, argv, "Vvht:c:w:H:W:C:d:o:q:D:", 268 c = getopt_long (argc, argv, "Vvht:c:w:m:H:d:o:q:D:",
269 longopts, &option); 269 longopts, &option);
270 270
271 if (c == EOF) 271 if (c == EOF)
@@ -287,19 +287,20 @@ process_arguments (int argc, char **argv)
287 case 'w': /* warning range */ 287 case 'w': /* warning range */
288 warning_range = optarg; 288 warning_range = optarg;
289 break; 289 break;
290 case 'm':
291 if (! strcasecmp (optarg, "CONN_TIME"))
292 metric = METRIC_CONN_TIME;
293 else if (! strcasecmp (optarg, "QUERY_RESULT"))
294 metric = METRIC_QUERY_RESULT;
295 else
296 usage2 (_("Invalid metric"), optarg);
297 break;
290 case 't': /* timeout */ 298 case 't': /* timeout */
291 if (!is_intnonneg (optarg)) 299 if (!is_intnonneg (optarg))
292 usage2 (_("Timeout interval must be a positive integer"), optarg); 300 usage2 (_("Timeout interval must be a positive integer"), optarg);
293 else 301 else
294 timeout_interval = atoi (optarg); 302 timeout_interval = atoi (optarg);
295 303
296 case 'C': /* critical conntime range */
297 conntime_critical_range = optarg;
298 break;
299 case 'W': /* warning conntime range */
300 conntime_warning_range = optarg;
301 break;
302
303 case 'H': /* host */ 304 case 'H': /* host */
304 if (!is_host (optarg)) 305 if (!is_host (optarg))
305 usage2 (_("Invalid hostname/address"), optarg); 306 usage2 (_("Invalid hostname/address"), optarg);
@@ -352,8 +353,7 @@ process_arguments (int argc, char **argv)
352 } 353 }
353 } 354 }
354 355
355 set_thresholds (&query_thresholds, warning_range, critical_range); 356 set_thresholds (&dbi_thresholds, warning_range, critical_range);
356 set_thresholds (&conntime_thresholds, conntime_warning_range, conntime_critical_range);
357 357
358 return validate_arguments (); 358 return validate_arguments ();
359} 359}
@@ -364,8 +364,12 @@ validate_arguments ()
364 if (! np_dbi_driver) 364 if (! np_dbi_driver)
365 usage ("Must specify a DBI driver"); 365 usage ("Must specify a DBI driver");
366 366
367 if (! np_dbi_query) 367 if ((metric == METRIC_QUERY_RESULT) && (! np_dbi_query))
368 usage ("Must specify an SQL query to execute"); 368 usage ("Must specify a query to execute (metric == QUERY_RESULT)");
369
370 if ((metric != METRIC_CONN_TIME)
371 && (metric != METRIC_QUERY_RESULT))
372 usage ("Invalid metric specified");
369 373
370 return OK; 374 return OK;
371} 375}
@@ -377,7 +381,9 @@ print_help (void)
377 381
378 printf (COPYRIGHT, copyright, email); 382 printf (COPYRIGHT, copyright, email);
379 383
380 printf (_("This program checks a query result against threshold levels")); 384 printf (_("This program connects to an (SQL) database using DBI and checks the\n"
385 "specified metric against threshold levels. The default metric is\n"
386 "the result of the specified query.\n"));
381 387
382 printf ("\n\n"); 388 printf ("\n\n");
383 389
@@ -396,14 +402,14 @@ print_help (void)
396 printf (" %s\n", "-o, --option=STRING"); 402 printf (" %s\n", "-o, --option=STRING");
397 printf (" %s\n", _("DBI driver options")); 403 printf (" %s\n", _("DBI driver options"));
398 printf (" %s\n", "-q, --query=STRING"); 404 printf (" %s\n", "-q, --query=STRING");
399 printf (" %s\n", _("SQL query to execute")); 405 printf (" %s\n", _("query to execute"));
400 printf ("\n"); 406 printf ("\n");
401 407
402 printf (UT_WARN_CRIT_RANGE); 408 printf (UT_WARN_CRIT_RANGE);
403 printf (" %s\n", "-W, --conntime-warning=RANGE"); 409 printf (" %s\n", "-m, --metric=METRIC");
404 printf (" %s\n", _("Connection time warning range")); 410 printf (" %s\n", _("Metric to check thresholds against. Available metrics:"));
405 printf (" %s\n", "-C, --conntime-critical=RANGE"); 411 printf (" CONN_TIME - %s\n", _("time used for setting up the database connection"));
406 printf (" %s\n", _("Connection time critical range")); 412 printf (" QUERY_RESULT - %s\n", _("result (first column of first row) of the query"));
407 printf ("\n"); 413 printf ("\n");
408 414
409 printf (UT_TIMEOUT, DEFAULT_SOCKET_TIMEOUT); 415 printf (UT_TIMEOUT, DEFAULT_SOCKET_TIMEOUT);
@@ -411,10 +417,12 @@ print_help (void)
411 printf (UT_VERBOSE); 417 printf (UT_VERBOSE);
412 418
413 printf ("\n"); 419 printf ("\n");
414 printf (" %s\n", _("A DBI driver (-d option) and a query (-q option) are required.")); 420 printf (" %s\n", _("A DBI driver (-d option) is required. If the specified metric operates"));
415 printf (" %s\n", _("This plugin connects to an SQL database using libdbi and executes the")); 421 printf (" %s\n\n", _("on a query, one has to be specified (-q option)."));
416 printf (" %s\n", _("specified SQL query. The first column of the first row of the result")); 422
417 printf (" %s\n", _("will be used as the check result and, if specified, compared with the")); 423 printf (" %s\n", _("This plugin connects to an (SQL) database using libdbi and, optionally,"));
424 printf (" %s\n", _("executes the specified query. The first column of the first row of the"));
425 printf (" %s\n", _("result will be parsed and, in QUERY_RESULT mode, compared with the"));
418 printf (" %s\n", _("warning and critical ranges. The result from the query has to be numeric")); 426 printf (" %s\n", _("warning and critical ranges. The result from the query has to be numeric"));
419 printf (" %s\n\n", _("(strings representing numbers are fine).")); 427 printf (" %s\n\n", _("(strings representing numbers are fine)."));
420 428
@@ -429,9 +437,8 @@ void
429print_usage (void) 437print_usage (void)
430{ 438{
431 printf ("%s\n", _("Usage:")); 439 printf ("%s\n", _("Usage:"));
432 printf ("%s -d <DBI driver> [-o <DBI driver option> [...]] -q <SQL query>\n", progname); 440 printf ("%s -d <DBI driver> [-o <DBI driver option> [...]] [-q <query>]\n", progname);
433 printf (" [-H <host>] [-c <critical range>] [-w <warning range>]\n"); 441 printf (" [-H <host>] [-c <critical range>] [-w <warning range>] [-m <metric>]\n");
434 printf (" [-C <critical conntime range>] [-W <warning conntime range>]\n");
435} 442}
436 443
437double 444double
@@ -494,6 +501,8 @@ do_query (dbi_conn conn, double *res_val, double *res_time)
494 501
495 struct timeval timeval_start, timeval_end; 502 struct timeval timeval_start, timeval_end;
496 503
504 assert (np_dbi_query);
505
497 if (verbose) 506 if (verbose)
498 printf ("Executing query '%s'\n", np_dbi_query); 507 printf ("Executing query '%s'\n", np_dbi_query);
499 508