Service Monitoring System

{{toc}}

h1. Assign Service to Host

A service should be grouped under a specify service group to ease the configuration tasks.

*[Important]* Prepare the following information before begin:

* *host name* - the host name of the host to be assigned

* *service group* - the group name of the service to be monitored

List of available services:

* [[Assign Service to Host#Assign-DB2-service|DB2]]

* [[Assign Service to Host#Assign-Third-Party-Service|Third Party Service]]

* [[Assign Service to Host#Assign-eCosway-Service|eCosway Application]]

* [[Assign Service to Host#Assign-Jboss-Service|Jboss]]

* [[Assign Service to Host#Assign-Server-Resources-Service|Server Resources]] 

h2. Assign DB2 service

Assumes that the target DB2 host has a @nagios@ user and the user has the monitor related privileges assigned.

The currently available commands for DB2 service are:

* *db2_connect_cmd* - check the time taken to establish connection to DB2

You may need the following additional information:

* *database name* - the name of the database to be monitored

* *warning threshold* - the warning threshold of this service in seconds unit, e.g. 3 for seconds

* *critical threshold* - the critical threshold of this service in seconds unit, e.g. 5 for seconds

h3. Steps

# login to the nagios server with @nagios@ user

# edit the @/usr/local/nagios/etc/ecosway/services/db2_services.cfg@

<pre>

nagios$ vi /usr/local/nagios/etc/ecosway/services/db2_services.cfg

</pre>

* Template:

<pre>

define service{

        use                     db2-service

        service_description     describe your service here

        host_name               host name

        check_command           db2_connect_cmd!database name!warning threshold!critical threshold

        }

</pre>

* Example:

<pre>

define service{

        use                     db2-service

        service_description     DB2 Connect - MY_STORE database

        host_name               cwydb1

        check_command           db2_connect_cmd!my_store!3!5

        }

</pre>

h2. Assign Third Party Service

This service is using *NRPE* addon and *check_http* command. Therefore, you may refer to the [[Documentation#Install-NRPE-optional|NRPE]] for the configuration details.

I will assume that you have the following things configured on the remote host and got the @NRPE@ up and running in the background:

* Remote Host: @/usr/local/nagios/etc/nrpe.cfg@

<pre>

... skip 

# UPS

command[check_ups_sav]=/usr/local/nagios/libexec/check_http -I onlinetools.ups.com -S -u /webservices/XAV -w 10 -c 12

command[check_ups_rate]=/usr/local/nagios/libexec/check_http -I onlinetools.ups.com -S -u /webservices/Rate -w 10 -c 12

# Avalara

command[check_avatax]=/usr/local/nagios/libexec/check_http -I avatax.avalara.net -S -u / -w 10 -c 12 -e "HTTP/1.1 403 Forbidden"

# Authorize.net

command[check_authorize]=/usr/local/nagios/libexec/check_http -I secure.authorize.net -S -u /gateway/transact.dll -w 10 -c 12

... skip

</pre>

h3. Steps

# login to the nagios server with @nagios@ user

# edit @/usr/local/nagios/etc/ecosway/services/ex_services.cfg@

<pre>

nagios$ vi /usr/local/nagios/etc/ecosway/services/ex_services.cfg

</pre>

* assume that you'd like to monitor @Avatax@; the @check_avatax@ remote command would be used for this example.

* Template:

<pre>

define service{

        use                             ex-service

        host_name                       host name

        service_description             put your description here

        check_command                   check_nrpe!put the remote check command here

        }

</pre>

* Example:

<pre>

define service{

        use                             ex-service

        host_name                       cwyapp1

        service_description             Avalara - Avatax

        check_command                   check_nrpe!check_avatax

        }

</pre>

h2. Assign eCosway Service

h2. Assign Jboss Service

h2. Assign Server Resources Service

TODO