For AI agents: A markdown version of this page is available at https://docs.datadoghq.com/integrations/clickhouse-cloud.md. A documentation index is available at /llms.txt.

ClickHouse Cloud

Supported OS Linux

Integration version1.0.0

To find out if this integration is available in your organization, see your Datadog Integrations page or ask your organization administrator.

To initiate an exception request to enable this integration for your organization, email support@ddog-gov.com.

ClickHouse Cloud dashboard in Datadog

Overview

ClickHouse is an open-source, column-oriented SQL database built for high-performance analytics and real-time data processing at scale.

This integration brings ClickHouse Cloud observability natively into Datadog, giving teams a unified view of their data infrastructure without the overhead of separate monitoring tools. It collects comprehensive telemetry across infrastructure and resources, storage health and data layout, and query and data operations.

By consolidating ClickHouse metrics alongside the rest of your stack in Datadog, teams can correlate database behavior with broader system events, set proactive alerts, and reduce mean time to resolution when performance issues arise.

Setup

  1. Navigate to the ClickHouse Cloud integration tile in Datadog.
  2. Click Connect Accounts. You are redirected to the ClickHouse Cloud console.
  3. Select the ClickHouse Cloud deployments that you want to monitor in Datadog.

Data Collected

Metrics

clickhouse_cloud.asynchronous_metrics.MaxPartCountForPartition
(gauge)		Maximum number of parts in any partition
Shown as object
clickhouse_cloud.asynchronous_metrics.NumberOfDatabases
(gauge)		Total number of databases on the ClickHouse server
Shown as object
clickhouse_cloud.asynchronous_metrics.NumberOfTables
(gauge)		Total number of tables on the ClickHouse server
Shown as table
clickhouse_cloud.asynchronous_metrics.OSMemoryTotal
(gauge)		Total system memory available
Shown as byte
clickhouse_cloud.asynchronous_metrics.OSSystemTimeNormalized
(gauge)		Normalized system CPU time usage (0-1 scale)
Shown as percent
clickhouse_cloud.asynchronous_metrics.OSUserTimeNormalized
(gauge)		Normalized user CPU time usage (0-1 scale)
Shown as percent
clickhouse_cloud.asynchronous_metrics.TotalBytesOfMergeTreeTables
(gauge)		Total data size of all MergeTree tables
Shown as byte
clickhouse_cloud.asynchronous_metrics.TotalPartsOfMergeTreeTables
(gauge)		Total number of parts in all MergeTree tables
Shown as object
clickhouse_cloud.events.FailedQuery.count
(count)		Count of failed queries executed
Shown as query
clickhouse_cloud.events.FailedSelectQuery.count
(count)		Count of failed SELECT queries executed
Shown as query
clickhouse_cloud.events.InsertQuery.count
(count)		Count of INSERT queries executed
Shown as query
clickhouse_cloud.events.InsertQueryTimeMicroseconds
(gauge)		Total time spent on INSERT queries
Shown as microsecond
clickhouse_cloud.events.LogError.total
(gauge)		Total number of server error log entries
Shown as error
clickhouse_cloud.events.Merge.count
(count)		Count of merge operations performed
Shown as merge
clickhouse_cloud.events.MergeTreeDataWriterUncompressedBytes.count
(count)		Total uncompressed bytes written by MergeTree
Shown as byte
clickhouse_cloud.events.MergedRows.count
(count)		Total rows merged during merge operations
Shown as row
clickhouse_cloud.events.MergedUncompressedBytes.count
(count)		Total uncompressed bytes merged
Shown as byte
clickhouse_cloud.events.NetworkReceiveBytes.count
(count)		Total network bytes received
Shown as byte
clickhouse_cloud.events.NetworkSendBytes.count
(count)		Total network bytes sent
Shown as byte
clickhouse_cloud.events.OSCPUVirtualTimeMicroseconds
(gauge)		Total CPU virtual time consumed
Shown as microsecond
clickhouse_cloud.events.Query.count
(count)		Total count of queries executed
Shown as query
clickhouse_cloud.events.QueryTimeMicroseconds
(gauge)		Total time spent on queries
Shown as microsecond
clickhouse_cloud.events.SelectQuery.count
(count)		Count of SELECT queries executed
Shown as query
clickhouse_cloud.events.SelectQueryTimeMicroseconds
(gauge)		Total time spent on SELECT queries
Shown as microsecond
clickhouse_cloud.events.SelectedBytes.count
(count)		Total bytes selected or read from disk
Shown as byte
clickhouse_cloud.metrics.HTTPConnection
(gauge)		Current number of HTTP connections
Shown as connection
clickhouse_cloud.metrics.MemoryTracking
(gauge)		Current memory allocated by ClickHouse process
Shown as byte
clickhouse_cloud.metrics.MergesMutationsMemoryTracking
(gauge)		Current memory used by merge and mutation processes
Shown as byte
clickhouse_cloud.metrics.PartMutation
(gauge)		Current number of parts being mutated
Shown as object
clickhouse_cloud.metrics.PartsActive
(gauge)		Current number of active parts in MergeTree tables
Shown as object
clickhouse_cloud.metrics.PartsCompact
(gauge)		Current number of compact parts in MergeTree tables
Shown as object
clickhouse_cloud.metrics.PartsDeleting
(gauge)		Current number of parts being deleted
Shown as object
clickhouse_cloud.metrics.PartsOutdated
(gauge)		Current number of outdated parts waiting for deletion
Shown as object
clickhouse_cloud.metrics.PartsPreActive
(gauge)		Current number of pre-active parts in MergeTree tables
Shown as object
clickhouse_cloud.metrics.PartsTemporary
(gauge)		Current number of temporary parts in MergeTree tables
Shown as object
clickhouse_cloud.metrics.PartsWide
(gauge)		Current number of wide parts in MergeTree tables
Shown as object
clickhouse_cloud.metrics.TCPConnection
(gauge)		Current number of TCP connections
Shown as connection

Uninstallation

In ClickHouse Cloud

  1. Log in to your ClickHouse Cloud organization.
  2. Select a service and navigate to the Settings page.
  3. In the Integrations section, click Remove Datadog Integration.

In Datadog

  1. Navigate to the ClickHouse Cloud integration tile.
  2. Click Uninstall to remove the out-of-the-box dashboard.

Support

Need help? Open a support case from the ClickHouse Cloud console or contact ClickHouse support.