Integrate with ADB cluster

Daria Barysheva

In order to determine that a new cluster should be monitored, it is necessary to integrate it with the previously created monitoring cluster and to add a separate Monitoring Clients service into it.

The steps for building integration between a monitoring cluster and ADB cluster are described below. All actions should be performed on the base of ADB cluster.

Step 1. Import monitoring settings

  1. From the CLUSTERS tab switch to the cluster configuring. To do this, click the row that contains the added cluster or click the icon in the Config column. Both methods open the cluster menu.

    config installed cluster
    Switching to cluster configuring

  2. Open the Import tab in the cluster menu.

  3. Select two components in the Graphite and Grafana panes. These components correspond to the related services of the previously created monitoring cluster.

  4. Click Save.

    mon import
    Integrating with the monitoring cluster

Step 2. Add a monitoring service

The steps for adding services to a cluster are listed below:

  1. From the CLUSTERS tab switch to the cluster configuring. To do this, click the row that contains the added cluster or click the icon in the Config column. Both methods open the cluster menu.

    config installed cluster
    Switching to cluster configuring

  2. Open the Services tab in the cluster menu and click Add services.

    monitoring add service
    Switching to services adding

  3. Select the service Monitoring Clients in the opened dialog and click Add.

    monitoring service card
    Choosing services

  4. As a result, the added services are displayed at the Services tab.

    monitoring services view
    The result of successful adding services to a cluster

Step 3. Distribution of monitoring components

The steps of adding components to hosts are listed below:

  1. From the CLUSTERS tab switch to the cluster configuring. To do this, click the row that contains the added cluster or click the icon in the Config column. Both methods open the cluster menu.

    config installed cluster
    Switching to cluster configuring

  2. Open the Hosts - Components tab in the cluster menu, add monitoring components to all cluster hosts, and click Save.

    monitoring components offline
    Distributing components between hosts

Step 4. Install a monitoring service

  1. Open the Services tab in the cluster menu. Click the icon in the Actions column and choose the Install action in the row that refers to the Monitoring Clients service. Verify the action in the opened window.

    monitoring install
    Switching to installing a monitoring service

  2. Wait until the installing process is completed. After the successful installation the monitoring service changes its state from created to monitored .

    NOTE
    In case of errors, you can find the logs at the JOBS tab.
    monitoring success
    The installing process is completed

Step 5. Verify results

To ensure that installation process is completed successfully, check the following:

  • System metrics are collected from the hosts of your cluster, not only from the host where the monitoring cluster has been deployed earlier.

  • Along with system metrics, service metrics are collected from the hosts of your cluster. For example, ADB provides the following metrics: TOTAL_SEGMENTS, UP_SEGMENTS, etc.

You can check it both in the Graphite and Grafana web-interface.

Graphite

  1. Enter in the browser bar the address of the host where the monitoring cluster is deployed. To specify the port number, use the value of the Web-interface TCP port parameter from the ip_and_ports section defined when configuring the Graphite service during the monitoring cluster installation. The value 80 (used by default) can be omitted.

  2. Expand a tree at the left side of the opened form. System and service metrics are displayed there, grouped by hosts. You can select some of these metrics to view their change dynamics in the form of a graph at the right side of the screen.

    monitoring graphite dark
    New hosts and service metrics are available in Graphite
    monitoring graphite light
    New hosts and service metrics are available in Graphite

Grafana

  1. Enter in the browser bar the address of the host where the monitoring cluster is deployed. To specify the port number, use the value of the Port parameter from the ip_and_ports section defined when configuring the Grafana service during the monitoring cluster installation (by default 3000).

  2. Select the Home menu item in the opened form.

  3. Notice that new dashboards are available. Select one of them to view the service metrics that are collected from your cluster.

    monitoring grafana main
    Switching to service metrics

  4. View available graphs.

    monitoring grafana dashboard
    Viewing service metrics
Found a mistake? Seleсt text and press Ctrl+Enter to report it