Chapter 1. Monitoring RHMAP with Nagios

To monitor the status of the RHMAP Core, MBaaS, and their components, you can use the Nagios monitoring software that comes prepackaged with an RHMAP installation.

Prerequisites

  • An OpenShift user account with access to the RHMAP Core or MBaaS project.

1.1. Accessing the Nagios Dashboard

  1. To obtain the URL for the Nagios dashboard, enter the following command:

    oc get route nagios --template "https://{{.spec.host}}"
    https://nagios-rhmap-core2.local.feedhenry.io
  2. Navigate to the URL to reach the Nagios dashboard login screen that prompts you for a user name and password:

    Nagios login prompt

  3. Retrieve the Nagios Dashboard user name and password by following the Section 1.2, “Retrieving Nagios Login Credentials” section of this guide.
  4. Enter the retrieved credentials into the login prompt.

Upon successful login, the Nagios Dashboard is displayed:

Nagios homepage

All Nagios service checks are located under the Services section of the dashboard which is located in the navigation bar on the left-hand side of the Nagios homepage, see example Services page below:

Nagios services page

For further details on using Nagios, refer to the Nagios documentation.

1.2. Retrieving Nagios Login Credentials

The Dashboard login credentials are stored as environment variables within the Nagios container. To access them, enter the following command:

oc env dc/nagios --list | grep NAGIOS

Sample output:

NAGIOS_USER=nagiosadmin
NAGIOS_PASSWORD=tser56mld6

The returned values are the login credentials to the Nagios dashboard.