2.7 Configuring the check_uptrack Nagios Plugin

2.7 Configuring the `check_uptrack` Nagios Plugin

2.7.1 Using the Nagios Plugins

Note

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:

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
```
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.

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$
}