All Products
Search
Document Center

ApsaraDB for ClickHouse:View cluster monitoring information

Last Updated:Dec 01, 2025

View the monitoring information for an ApsaraDB for ClickHouse cluster to understand its resource usage. This topic describes how to view monitoring information for an ApsaraDB for ClickHouse cluster.

Prerequisites

  • The cluster is a Community-compatible Edition or Enterprise Edition instance.

  • Alerts for ApsaraDB for ClickHouse rely on the alert management service of Application Real-Time Monitoring Service (ARMS). If you are a Resource Access Management (RAM) user, you must have the AliyunARMSFullAccess permission to manage ARMS. For more information about how to grant permissions, see Grant permissions to a RAM user.

Usage notes

  • You cannot view the monitoring information of Enterprise Edition clusters in the CloudMonitor console.

  • For Community-compatible Edition clusters purchased before December 1, 2021, you can click the Upgrade ClickHouse button on the Cluster Monitoring page to manually enable Managed Service for Prometheus.

    Important

    This operation restarts the ClickHouse and ZooKeeper nodes. We recommend that you perform this operation during off-peak hours or when data writes are stopped.

Procedure

Use the ApsaraDB for ClickHouse console

  1. Log on to the ApsaraDB for ClickHouse console.

  2. In the upper-left corner of the page, select the region where the target cluster is located.

  3. On the Clusters page, select the Clusters of Community-compatible Edition tab or the Enterprise Edition Clusters tab, and then click the ID of the target cluster.

  4. In the navigation pane on the left, click Monitoring and Alerting.

  5. Select Cluster Monitoring.

    Note

Use the CloudMonitor console

  1. Log on to the CloudMonitor console.

  2. In the navigation pane on the left, choose Cloud Resource Monitoring > Cloud Service Monitoring.

  3. On the Cloud Service Monitoring page, click Database.

  4. In the Database area, select the product name.

    Product Name

    Description

    clickhouse

    ApsaraDB for ClickHouse Community-compatible Edition clusters purchased before December 1, 2021.

    ClickHouse Community-compatible Edition

    ApsaraDB for ClickHouse Community-compatible Edition clusters purchased after December 1, 2021.

  5. In the upper-left corner of the page, select the region where the cluster is located.

  6. Click the ID of the target cluster to view its metrics.

    Note

FAQ

Q: Why do the CPU utilization and memory usage vary significantly among nodes?

If your cluster is a master-replica or single-replica multi-node cluster, when you perform multiple write operations, the write node's CPU and memory usage will be higher than other nodes. After data is synchronized to other nodes, CPU and memory usage will become more balanced.

Q: Why are there gaps in the monitoring data?

The common causes are as follows:

  • The query triggers an out-of-memory (OOM) error.

  • Modifying the configuration triggers a restart.

  • You restart the instance after you increase or decrease the quota.

Related API operations

CreateMonitorDataReport - Creates a monitoring data report

DescribeDBClusterPerformance - Queries performance data

References

If you are unfamiliar with CloudMonitor, see What is CloudMonitor?.