/***************************************************************************** * * Monitoring check_by_ssh plugin * * License: GPL * Copyright (c) 2000-2024 Monitoring Plugins Development Team * * Description: * * This file contains the check_by_ssh plugin * * * This program is free software: you can redistribute it and/or modify * it under the terms of the GNU General Public License as published by * the Free Software Foundation, either version 3 of the License, or * (at your option) any later version. * * This program is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the * GNU General Public License for more details. * * You should have received a copy of the GNU General Public License * along with this program. If not, see . * * *****************************************************************************/ const char *progname = "check_by_ssh"; const char *copyright = "2000-2024"; const char *email = "devel@monitoring-plugins.org"; #include "common.h" #include "utils.h" #include "netutils.h" #include "utils_cmd.h" #ifndef NP_MAXARGS # define NP_MAXARGS 1024 #endif static int process_arguments(int /*argc*/, char ** /*argv*/); static int validate_arguments(void); static void comm_append(const char * /*str*/); static void print_help(void); void print_usage(void); static unsigned int commands = 0; static unsigned int services = 0; static int skip_stdout = 0; static int skip_stderr = 0; static int warn_on_stderr = 0; static bool unknown_timeout = false; static char *remotecmd = NULL; static char **commargv = NULL; static int commargc = 0; static char *hostname = NULL; static char *outputfile = NULL; static char *host_shortname = NULL; static char **service; static bool passive = false; static bool verbose = false; int main(int argc, char **argv) { char *status_text; int cresult; int result = STATE_UNKNOWN; time_t local_time; FILE *file_pointer = NULL; output chld_out; output chld_err; remotecmd = ""; comm_append(SSH_COMMAND); setlocale(LC_ALL, ""); bindtextdomain(PACKAGE, LOCALEDIR); textdomain(PACKAGE); /* Parse extra opts if any */ argv = np_extra_opts(&argc, argv, progname); /* process arguments */ if (process_arguments(argc, argv) == ERROR) usage_va(_("Could not parse arguments")); /* Set signal handling and alarm timeout */ if (signal(SIGALRM, timeout_alarm_handler) == SIG_ERR) { usage_va(_("Cannot catch SIGALRM")); } alarm(timeout_interval); /* run the command */ if (verbose) { printf("Command: %s\n", commargv[0]); for (int i = 1; i < commargc; i++) printf("Argument %i: %s\n", i, commargv[i]); } result = cmd_run_array(commargv, &chld_out, &chld_err, 0); /* SSH returns 255 if connection attempt fails; include the first line of error output */ if (result == 255 && unknown_timeout) { printf(_("SSH connection failed: %s\n"), chld_err.lines > 0 ? chld_err.line[0] : "(no error output)"); return STATE_UNKNOWN; } if (verbose) { for (size_t i = 0; i < chld_out.lines; i++) printf("stdout: %s\n", chld_out.line[i]); for (size_t i = 0; i < chld_err.lines; i++) printf("stderr: %s\n", chld_err.line[i]); } if (skip_stdout == -1) /* --skip-stdout specified without argument */ skip_stdout = chld_out.lines; if (skip_stderr == -1) /* --skip-stderr specified without argument */ skip_stderr = chld_err.lines; /* UNKNOWN or worse if (non-skipped) output found on stderr */ if (chld_err.lines > (size_t)skip_stderr) { printf(_("Remote command execution failed: %s\n"), chld_err.line[skip_stderr]); if (warn_on_stderr) return max_state_alt(result, STATE_WARNING); return max_state_alt(result, STATE_UNKNOWN); } /* this is simple if we're not supposed to be passive. * Wrap up quickly and keep the tricks below */ if (!passive) { if (chld_out.lines > (size_t)skip_stdout) for (size_t i = skip_stdout; i < chld_out.lines; i++) puts(chld_out.line[i]); else printf(_("%s - check_by_ssh: Remote command '%s' returned status %d\n"), state_text(result), remotecmd, result); return result; /* return error status from remote command */ } /* * Passive mode */ /* process output */ if (!(file_pointer = fopen(outputfile, "a"))) { printf(_("SSH WARNING: could not open %s\n"), outputfile); exit(STATE_UNKNOWN); } local_time = time(NULL); commands = 0; for (size_t i = skip_stdout; i < chld_out.lines; i++) { status_text = chld_out.line[i++]; if (i == chld_out.lines || strstr(chld_out.line[i], "STATUS CODE: ") == NULL) die(STATE_UNKNOWN, _("%s: Error parsing output\n"), progname); if (service[commands] && status_text && sscanf(chld_out.line[i], "STATUS CODE: %d", &cresult) == 1) { fprintf(file_pointer, "[%d] PROCESS_SERVICE_CHECK_RESULT;%s;%s;%d;%s\n", (int)local_time, host_shortname, service[commands++], cresult, status_text); } } /* Multiple commands and passive checking should always return OK */ return result; } /* process command-line arguments */ int process_arguments(int argc, char **argv) { int c; char *p1; char *p2; int option = 0; static struct option longopts[] = {{"version", no_argument, 0, 'V'}, {"help", no_argument, 0, 'h'}, {"verbose", no_argument, 0, 'v'}, {"fork", no_argument, 0, 'f'}, {"timeout", required_argument, 0, 't'}, {"unknown-timeout", no_argument, 0, 'U'}, {"host", required_argument, 0, 'H'}, /* backward compatibility */ {"hostname", required_argument, 0, 'H'}, {"port", required_argument, 0, 'p'}, {"output", required_argument, 0, 'O'}, {"name", required_argument, 0, 'n'}, {"services", required_argument, 0, 's'}, {"identity", required_argument, 0, 'i'}, {"user", required_argument, 0, 'u'}, {"logname", required_argument, 0, 'l'}, {"command", required_argument, 0, 'C'}, {"skip", optional_argument, 0, 'S'}, /* backwards compatibility */ {"skip-stdout", optional_argument, 0, 'S'}, {"skip-stderr", optional_argument, 0, 'E'}, {"warn-on-stderr", no_argument, 0, 'W'}, {"proto1", no_argument, 0, '1'}, {"proto2", no_argument, 0, '2'}, {"use-ipv4", no_argument, 0, '4'}, {"use-ipv6", no_argument, 0, '6'}, {"ssh-option", required_argument, 0, 'o'}, {"quiet", no_argument, 0, 'q'}, {"configfile", optional_argument, 0, 'F'}, {0, 0, 0, 0}}; if (argc < 2) return ERROR; for (c = 1; c < argc; c++) if (strcmp("-to", argv[c]) == 0) strcpy(argv[c], "-t"); while (1) { c = getopt_long(argc, argv, "Vvh1246fqt:UH:O:p:i:u:l:C:S::E::n:s:o:F:", longopts, &option); if (c == -1 || c == EOF) break; switch (c) { case 'V': /* version */ print_revision(progname, NP_VERSION); exit(STATE_UNKNOWN); case 'h': /* help */ print_help(); exit(STATE_UNKNOWN); case 'v': /* help */ verbose = true; break; case 't': /* timeout period */ if (!is_integer(optarg)) usage_va(_("Timeout interval must be a positive integer")); else timeout_interval = atoi(optarg); break; case 'U': unknown_timeout = true; break; case 'H': /* host */ hostname = optarg; break; case 'p': /* port number */ if (!is_integer(optarg)) usage_va(_("Port must be a positive integer")); comm_append("-p"); comm_append(optarg); break; case 'O': /* output file */ outputfile = optarg; passive = true; break; case 's': /* description of service to check */ p1 = optarg; service = realloc(service, (++services) * sizeof(char *)); while ((p2 = index(p1, ':'))) { *p2 = '\0'; service[services - 1] = p1; service = realloc(service, (++services) * sizeof(char *)); p1 = p2 + 1; } service[services - 1] = p1; break; case 'n': /* short name of host in the monitoring configuration */ host_shortname = optarg; break; case 'u': comm_append("-l"); comm_append(optarg); break; case 'l': /* login name */ comm_append("-l"); comm_append(optarg); break; case 'i': /* identity */ comm_append("-i"); comm_append(optarg); break; case '1': /* Pass these switches directly to ssh */ comm_append("-1"); break; case '2': /* 1 to force version 1, 2 to force version 2 */ comm_append("-2"); break; case '4': /* -4 for IPv4 */ comm_append("-4"); break; case '6': /* -6 for IPv6 */ comm_append("-6"); break; case 'f': /* fork to background */ comm_append("-f"); break; case 'C': /* Command for remote machine */ commands++; if (commands > 1) xasprintf(&remotecmd, "%s;echo STATUS CODE: $?;", remotecmd); xasprintf(&remotecmd, "%s%s", remotecmd, optarg); break; case 'S': /* skip n (or all) lines on stdout */ if (optarg == NULL) skip_stdout = -1; /* skip all output on stdout */ else if (!is_integer(optarg)) usage_va(_("skip-stdout argument must be an integer")); else skip_stdout = atoi(optarg); break; case 'E': /* skip n (or all) lines on stderr */ if (optarg == NULL) skip_stderr = -1; /* skip all output on stderr */ else if (!is_integer(optarg)) usage_va(_("skip-stderr argument must be an integer")); else skip_stderr = atoi(optarg); break; case 'W': /* exit with warning if there is an output on stderr */ warn_on_stderr = 1; break; case 'o': /* Extra options for the ssh command */ comm_append("-o"); comm_append(optarg); break; case 'q': /* Tell the ssh command to be quiet */ comm_append("-q"); break; case 'F': /* ssh configfile */ comm_append("-F"); comm_append(optarg); break; default: /* help */ usage5(); } } c = optind; if (hostname == NULL) { if (c <= argc) { die(STATE_UNKNOWN, _("%s: You must provide a host name\n"), progname); } hostname = argv[c++]; } if (strlen(remotecmd) == 0) { for (; c < argc; c++) if (strlen(remotecmd) > 0) xasprintf(&remotecmd, "%s %s", remotecmd, argv[c]); else xasprintf(&remotecmd, "%s", argv[c]); } if (commands > 1 || passive) xasprintf(&remotecmd, "%s;echo STATUS CODE: $?;", remotecmd); if (remotecmd == NULL || strlen(remotecmd) <= 1) usage_va(_("No remotecmd")); comm_append(hostname); comm_append(remotecmd); return validate_arguments(); } void comm_append(const char *str) { if (++commargc > NP_MAXARGS) die(STATE_UNKNOWN, _("%s: Argument limit of %d exceeded\n"), progname, NP_MAXARGS); if ((commargv = (char **)realloc(commargv, (commargc + 1) * sizeof(char *))) == NULL) die(STATE_UNKNOWN, _("Can not (re)allocate 'commargv' buffer\n")); commargv[commargc - 1] = strdup(str); commargv[commargc] = NULL; } int validate_arguments(void) { if (remotecmd == NULL || hostname == NULL) return ERROR; if (passive && commands != services) die(STATE_UNKNOWN, _("%s: In passive mode, you must provide a service name for each command.\n"), progname); if (passive && host_shortname == NULL) die(STATE_UNKNOWN, _("%s: In passive mode, you must provide the host short name from the monitoring configs.\n"), progname); return OK; } void print_help(void) { print_revision(progname, NP_VERSION); printf("Copyright (c) 1999 Karl DeBisschop \n"); printf(COPYRIGHT, copyright, email); printf(_("This plugin uses SSH to execute commands on a remote host")); printf("\n\n"); print_usage(); printf(UT_HELP_VRSN); printf(UT_EXTRA_OPTS); printf(UT_HOST_PORT, 'p', "none"); printf(UT_IPv46); printf(" %s\n", "-1, --proto1"); printf(" %s\n", _("tell ssh to use Protocol 1 [optional]")); printf(" %s\n", "-2, --proto2"); printf(" %s\n", _("tell ssh to use Protocol 2 [optional]")); printf(" %s\n", "-S, --skip-stdout[=n]"); printf(" %s\n", _("Ignore all or (if specified) first n lines on STDOUT [optional]")); printf(" %s\n", "-E, --skip-stderr[=n]"); printf(" %s\n", _("Ignore all or (if specified) first n lines on STDERR [optional]")); printf(" %s\n", "-W, --warn-on-stderr]"); printf(" %s\n", _("Exit with an warning, if there is an output on STDERR")); printf(" %s\n", "-f"); printf(" %s\n", _("tells ssh to fork rather than create a tty [optional]. This will always return OK if ssh is executed")); printf(" %s\n", "-C, --command='COMMAND STRING'"); printf(" %s\n", _("command to execute on the remote machine")); printf(" %s\n", "-l, --logname=USERNAME"); printf(" %s\n", _("SSH user name on remote host [optional]")); printf(" %s\n", "-i, --identity=KEYFILE"); printf(" %s\n", _("identity of an authorized key [optional]")); printf(" %s\n", "-O, --output=FILE"); printf(" %s\n", _("external command file for monitoring [optional]")); printf(" %s\n", "-s, --services=LIST"); printf(" %s\n", _("list of monitoring service names, separated by ':' [optional]")); printf(" %s\n", "-n, --name=NAME"); printf(" %s\n", _("short name of host in the monitoring configuration [optional]")); printf(" %s\n", "-o, --ssh-option=OPTION"); printf(" %s\n", _("Call ssh with '-o OPTION' (may be used multiple times) [optional]")); printf(" %s\n", "-F, --configfile"); printf(" %s\n", _("Tell ssh to use this configfile [optional]")); printf(" %s\n", "-q, --quiet"); printf(" %s\n", _("Tell ssh to suppress warning and diagnostic messages [optional]")); printf(UT_WARN_CRIT); printf(UT_CONN_TIMEOUT, DEFAULT_SOCKET_TIMEOUT); printf(" %s\n", "-U, --unknown-timeout"); printf(" %s\n", _("Make connection problems return UNKNOWN instead of CRITICAL")); printf(UT_VERBOSE); printf("\n"); printf(" %s\n", _("The most common mode of use is to refer to a local identity file with")); printf(" %s\n", _("the '-i' option. In this mode, the identity pair should have a null")); printf(" %s\n", _("passphrase and the public key should be listed in the authorized_keys")); printf(" %s\n", _("file of the remote host. Usually the key will be restricted to running")); printf(" %s\n", _("only one command on the remote server. If the remote SSH server tracks")); printf(" %s\n", _("invocation arguments, the one remote program may be an agent that can")); printf(" %s\n", _("execute additional commands as proxy")); printf("\n"); printf(" %s\n", _("To use passive mode, provide multiple '-C' options, and provide")); printf(" %s\n", _("all of -O, -s, and -n options (servicelist order must match '-C'options)")); printf("\n"); printf("%s\n", _("Examples:")); printf(" %s\n", "$ check_by_ssh -H localhost -n lh -s c1:c2:c3 -C uptime -C uptime -C uptime -O /tmp/foo"); printf(" %s\n", "$ cat /tmp/foo"); printf(" %s\n", "[1080933700] PROCESS_SERVICE_CHECK_RESULT;flint;c1;0; up 2 days"); printf(" %s\n", "[1080933700] PROCESS_SERVICE_CHECK_RESULT;flint;c2;0; up 2 days"); printf(" %s\n", "[1080933700] PROCESS_SERVICE_CHECK_RESULT;flint;c3;0; up 2 days"); printf(UT_SUPPORT); } void print_usage(void) { printf("%s\n", _("Usage:")); printf(" %s -H -C [-fqvU] [-1|-2] [-4|-6]\n" " [-S [lines]] [-E [lines]] [-W] [-t timeout] [-i identity]\n" " [-l user] [-n name] [-s servicelist] [-O outputfile]\n" " [-p port] [-o ssh-option] [-F configfile]\n", progname); }