4.7 Configuring the check_uptrack Nagios Plugin

4.7 Configuring the `check_uptrack` Nagios Plugin

4.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 at 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 by using 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 host name/IP address and port that you use to connect o the proxy server, respectively. The connection information you specify might be similar to the following:
```
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$
}