Setting up Monitoring Sources

The Configuration Manager

On GNU/Linux and OS X systems, launch a terminal and run the following command:

$ realopinsight-manager -c

On Windows, you can use the command from a terminal or simply use the Start menu:

Start->RealOpInsight Monitoring Suite->RealOpInsight Configuration Manager

Once the login window loaded, sign in as administrator (login: ngrt4n_adm, default password: ngrt4n_adm).

../_images/realopinsight-login.png

Screenshot of the Login Window

After successful authentication, the configuration manager will be loaded.

../_images/realopinsight-ms-preferences1.png

Screenshot of the Configuration Manager

Source Parameters

The different properties of sources are described in the section dedicated to Source Parameters

Single-source configuration

Here are basic steps:

  1. Launch the Configuration Manager and set parameters according to the target monitoring system.
  2. Make sure to select the appropriate source type via the related combox on the form.
  3. Click on Apply Settings to save the changes.
  4. And finally, click on Close to quit the configuration window.

At any time, you can rerun the configuration manager to update settings. A quick access is enabled via the menu Console->Monitoring Settings from the Operations Console.

Multiple-source configuration

Here we assume that you are familiar with a basic configuration as described in the last section. There are also some important notices about sources management:

  • RealOpInsight can manage up to ten sources per service view simultaneously.
  • Each source has an identifier in the form of "Source"+Index, where Index corresponds to the identifier of the source (E.g. Source0, Source2).
  • When editing description file, every status to low level services needs to be associated to a source. This is achieved by prefixing the status data point with the related source identifier as follow: SourceIndex:device/status_item, note the colon : separator. For example, Source0:mysql-server01/Root Partition indicates the item allowing to monitor the root partition on the server named mysql-server from the monitoring server related to Source0.
  • It’s not required to set all the sources, but if a source is not set, every low level service related to that source will be automatically marked as UNKNOWN.
  • By convention, Source0 is considered as the default source. This means that when no source is associated to a status item, the status data is considered to related to Source0. Hence Source0:localhost/ping and localhost/ping refer to the same status data.

Let’s see how to set the sources. Here are basic steps:

  1. Launch the Configuration Manager and set the parameters according to the target monitoring system; see the description of ` configuration parameters`_.

  2. Then click on Add as Source (instead of on Apply Settings as for single source);

  3. Select the source index from the selection list that will appear. Note that if you set the index of a source that has been already set, that source will be overwritten without requiring confirmation.

    ../_images/realopinsight-select-source-index.png
  4. If you haven’t yet set the source type, you will be invited to set it.

    ../_images/realopinsight-select-source-type.png
  5. Restart at the first step to set another source. When all the sources you would want to define would have been completed, click on Close to quit the configuration window. You can now use the sources.

[1]http://mathias-kettner.de/checkmk_livestatus.html
[2]http://www.shinken-monitoring.org/wiki/livestatus_shinken