Actions

History

Table of contents
Assign Service to Host

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; the particular host name must exists in
- /usr/local/nagios/etc/ecosway/hosts/hosts.cfg
- /usr/local/nagios/etc/jmx4perl/servers.cfg
service group - the group name of the service to be monitored

List of available services:

DB2
Third Party Service
eCosway Application
Jboss
Server Resources

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

Steps¶

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

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

Template:

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
        }

Example:

define service{
        use                     db2-service
        service_description     DB2 Connect - MY_STORE database
        host_name               cwydb1
        check_command           db2_connect_cmd!my_store!3!5
        }

Assign Third Party Service¶

This service is using NRPE addon and check_http command. Therefore, you may refer to the 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

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

Steps¶

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

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

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

Template:

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
        }

Example:

define service{
        use                             ex-service
        host_name                       cwyapp1
        service_description             Avalara - Avatax
        check_command                   check_nrpe!check_avatax
        }

Assign eCosway Service¶

This services are configured to run on remote host. However, this services could configure to run on nagios server instead.

To monitor this, the NRPE addon and check_http commnd will be used. You could refer to the NRPE for the configuration details. Besides that, the following configuration must exist on the remote host:

/usr/local/nagios/etc/nrpe.cfg

... skip

command[check_dotcom]=/usr/local/nagios/libexec/check_http -H 192.168.2.66 -I 127.0.0.1 -u /ecosway/mall_main.jsp -w 5 -c 7

... skip

Steps¶

edit /usr/local/nagios/etc/ecosway/services/ecos_services.cfg

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

Template:

define service{
        use                             ecos-service
        host_name                       host name
        service_description             put the description here
        check_command                   check_nrpe!the remote check command
        }

Example:

define service{
        use                             ecos-service
        host_name                       cwyapp1
        service_description             Dot Com Mall
        check_command                   check_nrpe!check_dotcom
        }

Assign Jboss Service¶

This service uses the Jmx4Perl addon. Below is the list of configured check commands (ask the administrator to add more command when necessary):

j4p_memory_heap - the utilized memory heap in Jboss instance
j4p_perm_gen - the utilized perm gen in Jboss instance
j4p_cpool_used - the number of utilized connections in Jboss's connection pool

Steps - j4p_memory_heap¶

edit /usr/local/nagios/etc/ecosway/services/jboss_services.cfg

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

Template:

define service{
        use                     jboss-service
        service_description     put the description here
        host_name               add or append the host name here, separate by commas
        check_command           j4p_cmd!j4p_memory_heap
        }

Example:

define service{
        use                     jboss-service
        service_description     Jboss Heap Memory
        host_name               cwyrnd3-server,cwydb1,cwyapp1
        check_command           j4p_cmd!j4p_memory_heap
        }

Steps - j4p_perm_gen¶

edit /usr/local/nagios/etc/ecosway/services/jboss_services.cfg

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

Template:

define service{
        use                     jboss-service
        service_description     put the description here
        host_name               add or append host name here, separate by commas
        check_command           j4p_cmd!j4p_perm_gen
        }

Example:

define service{
        use                     jboss-service
        service_description     Jboss Perm Gen
        host_name               cwyrnd3-server,cwydb1,cwyapp1
        check_command           j4p_cmd!j4p_perm_gen
        }

Steps - j4p_cpool_used¶

SHOULD NOT reuse the existing service definition as the data source name could be unique across different hosts.

Prepare the following information before continue:

data source name - the name of the database connection pool

edit /usr/local/nagios/etc/ecosway/services/jboss_services.cfg

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

Template:

define service{
        use                     jboss-service
        service_description     put the description here
        host_name               host name
        check_command           j4p_cmd!j4p_cpool_used!data source name
        }

Example:

define service{
        use                     jboss-service
        service_description     Connection Pool - DB2DS
        host_name               cwyapp1
        check_command           j4p_cmd!j4p_cpool_used!DB2DS
        }

Assign Server Resources Service¶

This service is using NRPE addon to monitor remote hosts' services, e.g. average load, swap files, and etc.

List of configured remote services:

Average Load - check the system current load
Swap File Used - check the swap space used
Disk Space Used - check the amount of disk space used

[Important] The NRPE addon must be configured and running on the particular remote machine(s).

login to the Nagios server using nagios user
edit the /usr/local/nagios/etc/ecosway/services/os_services.cfg
```
vi /usr/local/nagios/etc/ecosway/services/os_services.cfg
```

reuse the existing service definition if exists
list of available check command:
- check_load
- check_swap
- check_hda1

Template:

define service{
        use                             os-service
        host_name                       cwydb1,put the host name here
        service_description             Current Load
        check_command                   check_nrpe!check_load
        }

define service{
        use                             os-service         
        host_name                       cwydb1,put the host name here
        service_description             Swap Usage
        check_command                   check_nrpe!check_swap
        }

define service{
        use                             os-service         
        host_name                       cwydb1,put the host name here
        service_description             Root Partition
        check_command                   check_nrpe!check_hda1
        }

Example:

define service{
        use                             os-service         
        host_name                       cwydb1,cwyapp1
        service_description             Current Load
        check_command                   check_nrpe!check_load
        }

define service{
        use                             os-service         
        host_name                       cwydb1,cwyapp1
        service_description             Swap Usage
        check_command                   check_nrpe!check_swap
        }

define service{
        use                             os-service         
        host_name                       cwydb1,cwyapp1
        service_description             Root Partition
        check_command                   check_nrpe!check_hda1
        }

Files (0)

Updated by chin-yeh about 14 years ago · 15 revisions

Project

General

Profile

Service Monitoring System

Wiki

Assign Service to Host¶

Assign DB2 service¶

Steps¶

Assign Third Party Service¶

Steps¶

Assign eCosway Service¶

Steps¶

Assign Jboss Service¶

Steps - j4p_memory_heap¶

Steps - j4p_perm_gen¶

Steps - j4p_cpool_used¶

Assign Server Resources Service¶