2.7 Configuring the check_uptrack Nagios Plugin


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

Configure the check_uptrack Nagios plugin as follows:

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

    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 that are used to connect to the proxy, as shown in the following 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, which is usually /usr/local/nagios/etc/nagios.cfg.

    The following minimal configuration enables 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$