---
title: "Monitoring clusters, node groups, and ClickHouse® nodes"
sidebar_label: "Monitoring clusters, node groups, and nodes"
sidebar_position: 10
description: "How to monitor the status of clusters, node groups, and nodes"
---

import {CustomTable} from '@selectel/docux/components';
import Formbricks from '@theme/MDXComponents/Formbricks';
import Monitoring from '@site/i18n/en/docusaurus-plugin-content-docs/current/_partials/managed-databases/postgresql/monitoring.mdx';

# Monitoring clusters, node groups, and ClickHouse® nodes

In ClickHouse® cloud databases, you can monitor the status of a cluster, [node groups](/managed-databases/clickhouse/about-node-groups.mdx), and nodes in the control panel.

You can:

* [view cluster status](#view-cluster-state);
* [view cluster and node group statuses](#view-cluster-and-node-group-statuses);
* [view node statuses in node groups](#view-cluster-node-statuses).

The cluster status indicates the health of its nodes. The statuses show operations performed on the cluster, node groups, and nodes. You can [view the operation history](#view-operations).

For a more detailed analysis, you can [view cluster node metrics](#view-cluster-node-metrics) as charts in the dashboard.

When analyzing charts, keep in mind that the time in the dashboard corresponds to the time on your device and does not depend on the region where the cluster is hosted.

:::note

For example, you have created a cluster in Tashkent, in the uz-1 pool. On the device from which you logged into the Control Panel, the Moscow time zone is set. The time on the metrics charts will be displayed in the Moscow time zone.

:::

## View cluster status \{#view-cluster-state}

1. In the [dashboard](https://my.selectel.ru/vpc/default/dbaas/), click **Products** in the top menu and select **Managed Databases**.

2. Open the **Active** tab.

3. View the status in the cluster card.

   <CustomTable>
     <table>
       <tbody>
         <tr>
           <th>Running</th><td>The cluster is working properly</td>
         </tr>

         <tr>
           <th>Degraded</th>

           <td>
             One or more nodes are unavailable or operating with limitations. Check the [node statuses](#view-cluster-node-statuses). If you cannot determine the causes yourself, [create a ticket](https://my.selectel.ru/tickets/create/)
           </td>
         </tr>

         <tr>
           <th>Down</th>

           <td>
             All cluster nodes are unavailable, [create a ticket](https://my.selectel.ru/tickets/create/)
           </td>
         </tr>

         <tr>
           <th>Unknown</th>

           <td>
             The cluster is being created or its status is unknown. If this status appears for a cluster with a status other than `CREATING`, [create a ticket](https://my.selectel.ru/tickets/create/)
           </td>
         </tr>
       </tbody>
     </table>
   </CustomTable>

## View cluster and node group statuses \{#view-cluster-and-node-group-statuses}

1. In the [dashboard](https://my.selectel.ru/vpc/default/dbaas/), click **Products** in the top menu and select **Managed Databases**.

2. Open the **Active** tab.

3. In the cluster card, view the [cluster statuses](#cluster-statuses) and [node group statuses](#node-group-statuses).

### Cluster statuses \{#cluster-statuses}

<CustomTable>
  <table>
    <tbody>
      <tr>
        <th>CREATING</th><td>The cluster is being created</td>
      </tr>

      <tr>
        <th>ACTIVE</th><td>The cluster is active; no operations are being performed on it</td>
      </tr>

      <tr>
        <th>UPDATING</th><td>The cluster is being updated</td>
      </tr>

      <tr>
        <th>RESIZING</th>

        <td>
          The cluster is being scaled
        </td>
      </tr>

      <tr>
        <th>REBUILDING</th><td>Cluster nodes are being recreated</td>
      </tr>

      <tr>
        <th>LOCKING</th><td>The cluster is being locked</td>
      </tr>

      <tr>
        <th>LOCKED</th>

        <td>
          The cluster is locked.

          This status may appear due to [resource blocking if there are insufficient funds on your balance](/managed-databases/about/payment.mdx#insufficient-funds). To unblock the cluster, [top up your balance](/balance-and-payments/manage/top-up-balance.mdx).

          If you cannot determine the cause of the lock yourself, [create a ticket](https://my.selectel.ru/tickets/create/)
        </td>
      </tr>

      <tr>
        <th>UNLOCKING</th><td>The cluster is being unlocked</td>
      </tr>

      <tr>
        <th>DELETING</th><td>The cluster is being deleted</td>
      </tr>

      <tr>
        <th>DELETED</th><td>The cluster has been deleted</td>
      </tr>

      <tr>
        <th>MAINTENANCE</th><td>The cluster is undergoing maintenance</td>
      </tr>

      <tr>
        <th>ERROR</th><td>An error has occurred, [create a ticket](https://my.selectel.ru/tickets/create/)</td>
      </tr>
    </tbody>
  </table>
</CustomTable>

### Node group statuses \{#node-group-statuses}

<CustomTable>
  <table>
    <tbody>
      <tr>
        <th>CREATING</th><td>The node group is being created</td>
      </tr>

      <tr>
        <th>ACTIVE</th><td>The node group is active; no operations are being performed on it</td>
      </tr>

      <tr>
        <th>UPDATING</th><td>The node group is being updated</td>
      </tr>

      <tr>
        <th>RESIZING</th>

        <td>
          The node group is scaling. When this operation is performed, the same status is assigned to the cluster and to the nodes of the scaling group. Other node groups in the cluster, except for ClickHouse® Keeper, are assigned the `UPDATING` status
        </td>
      </tr>

      <tr>
        <th>DELETING</th>

        <td>
          The node group is being deleted. When this operation is performed, other node groups in the cluster, except for ClickHouse® Keeper, are assigned the `UPDATING` status
        </td>
      </tr>

      <tr>
        <th>DELETED</th><td>The node group has been deleted</td>
      </tr>

      <tr>
        <th>ERROR</th><td>An error has occurred, [create a ticket](https://my.selectel.ru/tickets/create/)</td>
      </tr>
    </tbody>
  </table>
</CustomTable>

## View node statuses in node groups \{#view-cluster-node-statuses}

1. In the [dashboard](https://my.selectel.ru/vpc/default/dbaas/), click **Products** in the top menu and select **Managed Databases**.

2. Open the **Active** tab.

3. Open the cluster page → **Connection** tab.

4. In the **Connection addresses** block, check the **Status** column in the node line.

   <CustomTable>
     <table>
       <tbody>
         <tr>
           <th>CREATING</th><td>The node is being created</td>
         </tr>

         <tr>
           <th>ACTIVE</th><td>The node is active; no operations are being performed on it</td>
         </tr>

         <tr>
           <th>UPDATING</th><td>The node is being updated</td>
         </tr>

         <tr>
           <th>RESIZING</th>

           <td>
             The node is scaling. This status appears when the node group containing the node is being scaled
           </td>
         </tr>

         <tr>
           <th>DELETING</th><td>The node is being deleted</td>
         </tr>

         <tr>
           <th>DELETED</th><td>The node has been deleted</td>
         </tr>

         <tr>
           <th>DISK FULL</th>

           <td>
             The node disk is full, the node is in read-only mode. To make the node work in read-write mode, clear the disk or [scale the node group](/managed-databases/clickhouse/resize-cluster.mdx#resize-node-group) and choose a configuration with a larger disk size than the previous configuration
           </td>
         </tr>

         <tr>
           <th>DOWN</th>

           <td>
             The node is unavailable, [create a ticket](https://my.selectel.ru/tickets/create/)
           </td>
         </tr>

         <tr>
           <th>ERROR</th><td>An error has occurred, [create a ticket](https://my.selectel.ru/tickets/create/)</td>
         </tr>
       </tbody>
     </table>
   </CustomTable>

## View operation history \{#view-operations}

1. In the [dashboard](https://my.selectel.ru/vpc/default/dbaas/), click **Products** in the top menu and select **Managed Databases**.
2. Open the **Active** tab.
3. Open the cluster page → **Operation history** tab.
4. View the operations.

## View cluster node metrics \{#view-cluster-node-metrics}

1. In the [dashboard](https://my.selectel.ru/vpc/default/dbaas/), click **Products** in the top menu and select **Managed Databases**.
2. Open the **Active** tab.
3. Open the cluster page → **Monitoring** tab.
4. Select a node group.
5. If there are multiple nodes in the group, select the node whose metrics you want to see.
6. View the available [cluster node metrics](#cluster-node-metrics).

### Cluster node metrics in the dashboard \{#cluster-node-metrics}

<CustomTable>
  <table data-sticky>
    <tbody>
      <tr>
        <th>Memory</th><td>Occupied memory excluding OS cache and buffers, in percent or gigabytes</td>
      </tr>

      <tr>
        <th>vCPU</th><td>Percentage of cluster node core utilization</td>
      </tr>

      <tr>
        <th>CPU iowait</th><td>Percentage of time the processor spent waiting for input/output</td>
      </tr>

      <tr>
        <th>Disk</th>

        <td>
          Occupied disk space in percent or gigabytes. This accounts for the portion of disk space reserved for system needs that is unavailable for database placement. For more information about reserving disk space, see the guide [Using disk space in a ClickHouse® cluster](/managed-databases/clickhouse/use-disk-space.mdx)
        </td>
      </tr>

      <tr>
        <th>Load Average</th>

        <td>
          Average system load over a period of time. It shows how many processes are being processed by the cluster cores. The indicator is presented as three values: for one minute, five minutes, and 15 minutes. These values should not exceed the number of cores on the node
        </td>
      </tr>

      <tr>
        <th>OOM</th>

        <td>
          Number of processes that terminated with an `Out of Memory` error due to insufficient RAM
        </td>
      </tr>

      <tr>
        <th>Disk load</th>

        <td>
          Read and write speed in KB/s or number of read/write operations per second
        </td>
      </tr>

      <tr>
        <th>Network load</th><td>Number of bits or packets sent and received via the network interface</td>
      </tr>
    </tbody>
  </table>
</CustomTable>

ClickHouse® is a registered trademark of ClickHouse, Inc. https://clickhouse.com.

<Formbricks />