check_socks

Nagios/Icinga plugin to monitor socks proxy

Script usage

Usage:
    --help     = Print this message
    -i         = Proxy IP address (default 127.0.0.1)
    -p         = Proxy port (default 1080)
    --target   = Url to check socks proxy (default https://www.google.com)
    --max-time = Maximum time in seconds that you allow the whole operation to take (default 10)

Requirements

curl must be installed on the host.

Nagios installation instructions

Installation

Copy check_socks file in plugin directory (usually /usr/lib/nagios/plugins, can be found in file /etc/nagios3/resource.cfg).

Make it executable

chmod +x /usr/lib/nagios/plugins/check_socks

Configuration

Define command

# 'check_socks' command definition
define command{
    command_name   check_socks
    command_line   /usr/lib/nagios/plugins/check_socks -i '$ARG1$' -p '$ARG2$'
}

Define service

# Define a service to check socks proxy
define service{
    use                             generic-service
    host_name                       hostname
    service_description             Socks proxy
    check_command                   check_socks!!
}

Replace and with your values

Icinga installation instructions

Installation

Copy check_socks file in plugin directory (usually /usr/lib/nagios/plugins, can be found in file /etc/icinga2/constants.conf).

/* The directory which contains the plugins from the Monitoring Plugins project. */
const PluginDir = "/usr/lib/nagios/plugins"

Make it executable

chmod +x /usr/lib/nagios/plugins/check_socks

Configuration

Define command

// https://github.com/Ekhozie/check_socks
object CheckCommand "socks" {
    command = [ PluginDir + "/check_socks" ]

    arguments = {
        "-i" = {
            value = "$socks_ip$"
            description = "Proxy IP address (default 127.0.0.1)"
        }
        "-p" = {
            value = "$socks_port$"
            description = "Proxy port (default 1080)"
        }
        "--target" = {
            value = "$socks_target$"
            description = "Url to check socks proxy (default https://www.google.com)"
        }
        "--max-time" = {
            value = "$socks_max_time$"
            description = "Maximum time in seconds that you allow the whole operation to take (default 10)"
        }
    }
}

Define service

template Service "socks-proxy" {
    import "generic-service"

    check_command = "socks"

    vars.socks_ip = ""
    vars.socks_port = ""

    assign where host.name == NodeName
}

Replace and with your values