• Table of contents
• 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

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¶

1. login to the nagios server with nagios user
2. 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¶

1. login to the nagios server with nagios user
2. 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¶

1. login to the nagios server with nagios user
2. 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¶

1. login to nagios server with nagios user
2. 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¶

1. login to nagios server with nagios user
2. 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

1. login to nagios server with nagios user
2. 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).

1. login to the Nagios server using nagios user
2. 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
          }