checkhttp2

A simple plugin to check https urls, including http/2, and SSL expiration.

This plugin is meant to be used with Nagios.

Compile for Linux (e.g. Digital Ocean Ubuntu 16.04):

env GOOS=linux GOARCH=amd64 go build -o checkhttp2 main.go

Installation

For Nagios 4 on Ubuntu 16.04, assuming that you followed these instructions, just place in /usr/local/nagios/libexec, and make sure the file is executable.

Usage

Help:

user@host# /usr/local/nagios/libexec/checkhttp2 -h

Usage of ./checkhttp2:
  -cert
        If set, perform scan SSL cert only
  -host string
        A valid internet site e.g. www.example.com
  -page string
        Specific page to scan
  -port int
        Port number (default 443)
  -protocol string
        Protocol - https or http (default "https")

Run the command from cli as follows:

checkhttp2 -host <hostname.com> [-protocol http|https] [-port 80|443] [-cert]

Example: to check status of www.google.com:

checkhttp2 -host www.google.com

Example: to check a specific page:

./checkhttp2 -host www.somesite.com -page /some/specific/page -port 443 -protocol https

Example: to check SSL expiration date for www.google.com:

checkhttp2 -host www.google.com -cert

Example: to check SSL expiration of somesite.com on port 5666:

checkhttp2 -host www.somesite.com -port 5666 -cert

Integration with Nagios 4

Add this to /usr/local/nagios/objects/commands.cfg to test HTTP/2 status:

define command {
   command_name    check_http2
   command_line    /usr/local/nagios/libexec/checkhttp2 -host $ARG1$
}

Add this to /usr/local/nagios/objects/commands.cfg to test a specfic page's HTTP/2 status:

define command {
   command_name    check_http2_page
   command_line /usr/local/nagios/libexec/checkhttp2 -host $ARG1$ -page $ARG2$
}

Add this to /usr/local/nagios/objects/commands.cfg to test SSL expiration status:

define command {
   command_name    check_ssl_expiry
   command_line    /usr/local/nagios/libexec/checkhttp2 -host $ARG1$ -cert
}

In individual files in /usr/local/nagios/etc/servers:

define service{
        use                     generic-service
        host_name               www.somesite.com
        service_description     Check HTTP2
        check_command           check_http2!www.somesite.com
}

define service{
        use                     generic-service
        host_name               www.somesite.com
        service_description     Check SSL Expiry
        check_command           check_ssl_exiry!www.somesite.com
        check_interval          1440
}

define service{
        use                     generic-service
        host_name               www.somesite.com
        service_description     Check Page
        check_command           check_http2_page!powersports.wheelsanddeals.ca!/some/page
}

Credits

The SSL check code is based on asyncrsc/ssl_scan. Nagios messaging is based on newrelic/go_nagios.

License

This software is licensed under the MIT License.