First steps

In this section, the steps to be followed by the Administrator once WOCU-Monitoring is installed are explained. This documentation follows a practical approach to facilitate the understanding and monitoring of the operation.

Access to WOCU-Monitoring

1. Access the WOCU-Monitoring interface by entering the following address in your browser:

https://<yourserverip>/aggregator

2. When logging in using a self-signed certificate, the browser will return a warning by default. You need to accept this certificate in order to continue with the process. Learn more about managed certificates in the section: HTTPS administration.

../../_images/7_074_browser_warning.png

3. Enter your credentials in the login page. The default username and password are admin/admin, as long as not previously modified in the Initial configuration file.

../../_images/2_005a_cookies-banner-53.jpg

4. Once you have entered your credentials, click on the Log in button to access WOCU-Monitoring.

Creation of Realms

Once inside the application, the next step is to register a first Realm.

Attention

This guide will only focus on setting up the fields necessary to set up a Realm. More complete and detailed information can be found in here.

1. Click on the blue button + New Realm to start the creation process through the following form.

../../_images/2_093c_aggregator_home-view_add-new-realm_home-empty_0-48.jpg
  1. Complete the following fields to set up the first Realm:

    ../../_images/7_075_form_new_realm.png

Se destacan los campos a modificar.

2.1 Display Name: add wocu.

2.2 Import Tool: to add a first Import-Tool trigger the + function.

../../_images/7_077_add_new_import-tool.png

Se destacan los campos a modificar.

The fields to be modified for the registration of a new Import-Tool are:

2.2.1 Name: add WOCU IT.

2.2.2 Import tool host: añada wocu.

2.2.3 Path of CA file to validate SSL: copy the text indicated in the help information:

/opt/wocu/embedded/ssl/certs/wocuCA.pem

Next:

  • Confirm the changes made via the Create button.

  • Select the new Import-Tool in the selector to continue.

    ../../_images/7_094_select_new_import-tool.png

2.3 Monitoring Host: add wocu.

2.4 PNP4Nagios Protocol: select HTTPS.

2.5 PNP4Nagios Host: add wocu.

2.6 PNP4Nagios Port: add 443.

2.7 Metrics: to add a first database server, trigger the + function.

../../_images/7_078_add_new_metrics.png

Se destacan los campos a modificar.

The field to be modified for the registration of a new server is:

2.7.1 Metric name: add local.

Next:

  • Confirm the changes made via the Create button.

  • Select the new Metrics in the selector to continue.

    ../../_images/7_095_select_new_metrics.png

2.8 Metric Database: to create the database that will store metrics perform the following steps:

  • Run the following command in a new terminal:

    apt install -y curl && curl -X POST 'http://localhost:8086/query?u=root&p=root' -d 'q=CREATE DATABASE "localhost"'
    

    The database has been created. The answer should be as follows:

    {"results":[{"statement_id":0}]}
    
  • Back to the form, in the Metric Database field, add the same value used in the previous command: localhost.

    ../../_images/7_096_conf_metrics_database.png

2.9 Host Name: add localhost.

3. Once you have entered all the required data, save the form configuration using the Add Realm button.

Congratulations! The first Realm has been successfully created. The default WOCU-Monitoring main page is the Status view, where only the Global Panel will be operational with a single operational Host.

../../_images/7_081_initial_view_status.png

At this point there is only one team in the Realm. The next step will be to expand the infrastructure by adding new hosts.

Manual registration of a Host

Follow the steps below to install new Hosts to the WOCU Realm and expand the monitored network.

Attention

This guide will only focus on configuring the attributes needed to add a new Host. More complete and detailed information here.

1. Access the Configuration Module of the WOCU Realm and go to the Active Assets > Hosts section.

../../_images/7_082_path_to_hosts_active_assets.png

2. Click on the + Add Host button to start the process.

../../_images/7_090_add_host_button.png
  1. 3. Please complete the following form fields:

../../_images/7_084_add_hosts_form.png

Se destacan los campos a modificar.

3.1 Host Name: add wocu_01.

3.2 Address: register 127.0.0.1.

4. Once you have entered the data, save the configuration using the blue Create button.

5. You now have the first wocu_01 unit registered from the Configuration Module.

../../_images/7_083_new_host.png

6. To enforce monitoring of the new Host on the system, run Check.

../../_images/5_008_aggregator_use_cases-geomap-check-button_0-50.jpg

7. Confirm the action by clicking on the Restart WOCU button, located in the dialogue box reporting the status of the DB. The verification message confirms the optimal status of the system to proceed with the restart.

../../_images/7_093_wocu_check_response.png

8. Finally, access the Assets > Hosts section where all the monitored Realm teams are listed and locate wocu_01 via the search bar.

../../_images/7_086_host_in_assets_inventory.png

Although the new equipment is already registered, it has no data collected during its monitoring activity. Therefore, the next step will be to associate services to it.

Configuration of monitoring services

Follow the steps below to configure new monitoring services to the wocu_01 equipment.

1. Access the Configuration Module of the WOCU Realm and go to the Active Assets > Hosts section.

../../_images/7_082_path_to_hosts_active_assets.png

2. Locate the wocu_01 host in the list and click on the action Packs.

../../_images/7_085_packs_action.png

Find out more…

The configuration of services will be carried out through the application of Monitoring Packs. Further information can be found in our Pack Catalogue.

3. Search and select from the list: LINUX-SSH. The entry corresponding to the pack will turn a green background colour, indicating that it has been selected for linking.

../../_images/7_087_select_linux_pack.png

4. Confirm the selection using the Apply and exit button, and return to the global view Hosts.

../../_images/4_034d_import-tool_active-assets_hosts-monitoring-packs-buttons_0-46.jpg

5. You can see how in the Packs column there is a tag referring to the LINUX-SSH (newly configured) pack.

../../_images/7_088_linux_pack_applied.png

6. To make the new Host configuration effective on the system, re-run Check.

../../_images/5_008_aggregator_use_cases-geomap-check-button_0-50.jpg

7. Confirm the action by clicking on the Restart WOCU button, located in the dialogue box reporting the status of the DB. The verification message confirms the optimal status of the system to proceed with the restart.

../../_images/7_092_wocu_check_response.png

8. Go back to section Assets > Services to verify that the wocu_01 machine already has operational monitoring services (relative to the associated LINUX-SSH pack).

As can be seen, there are services already operational (OK and WARNING) and others in PENDING status, indicating that they are waiting to be executed after the next check.

../../_images/7_089_host_with_linux_services.png

From this interface, it is possible to obtain up-to-date information on each monitoring service. By clicking on the name of a specific service (Service column), a new Detailed view of Services associated to a Host will pop up with specific information on the current status, last executed checks, as well as other metric graphs provided during the checking tasks.

../../_images/7_091_modal_services.png

What now?


Note

If you have any comments you would like to share, please contact us at <info@wocu-monitoring.com>. We would be happy to receive your suggestions and consider them for future updates.

Below are various sections that may be of interest to you, once you have the first hosts configured.

  • Specific use cases: detailed information on specific functions is provided, as well as step-by-step descriptions of the operation to be followed.

  • Monitoring Packs: catalogue of packs classified by most common technologies, functions or manufacturers in the market.

  • API: serves the complete and detailed documentation of the WOCU-Monitoring API.

  • Release Notes: list of releases of new features, bug fixes and other significant changes, which accompany each version of WOCU-Monitoring.

  • User Manual: divided into three sections according to the most common tasks:

Now you can start taking full advantage of all the functionalities that WOCU-Monitoring has to offer.