2.7 Configuring the check_uptrack Nagios Plugin

Note

The Nagios software is not included with the python-ksplice-uptrack package. For information about obtaining and using Nagios, got to the official Nagios website: http://www.nagios.org.

To configure the check_uptrack Nagios plugin:

  1. Set the username and api_key variables in the configuration file /etc/uptrack-api.conf under an [uptrack] section heading, for example:

    [uptrack]
    username = jo.admin@mydom.com
    api_key  = 3af3c2c1ec407feb0fdc9fc1d8c4460c
  2. If you access the Internet via a proxy, specify the connection information in the [uptrack] section of /etc/uptrack-api.conf:

    https_proxy = [protocol://][username:password@]proxy[:port] 

    where protocol is http or https, username and password authenticate you with the proxy (if required), and proxy and port are the host name or IP address and port number used to connect to the proxy.

    For example:

    https_proxy = http://proxy.example.com:3128/

    The proxy must support HTTPS connections.

  3. Configure the check_uptrack plugin in the Nagios configuration file, usually /usr/local/nagios/etc/nagios.cfg. The following minimal configuration alows you to run the plugin:

    # Dummy host with which to associate the Uptrack service
    define host {
           host_name                       uptrack-service
           notifications_enabled           0
           max_check_attempts              1
           notification_interval           0
           check_period                    never
           contacts                        server-admins
    }
    
    define service {
           host_name                       uptrack-service
           service_description             Ksplice Uptrack Update Status
           check_command                   check_uptrack
           notifications_enabled           1
           normal_check_interval           60
           retry_check_interval            15
           max_check_attempts              4
           notification_options            w,c,r
           contacts                        server-admins
    }
    
    define command {
           command_name     check_uptrack
           command_line     /usr/lib/nagios/plugins/check_uptrack
    }
    
    define command {
           command_name     check_uptrack_opts
           command_line     /usr/lib/nagios/plugins/check_uptrack -w $ARG1$ -c $ARG2$
    }