--- title: ClickHouse Cloud description: >- Monitor ClickHouse Cloud deployments with real-time metrics for storage, throughput, connections, and resource usage. breadcrumbs: Docs > Integrations > ClickHouse Cloud --- # ClickHouse Cloud Supported OS Integration version1.0.0 {% callout %} # Important note for users on the following Datadog sites: us2.ddog-gov.com {% alert level="info" %} To find out if this integration is available in your organization, see your [Datadog Integrations](https://app.datadoghq.com/integrations) page or ask your organization administrator. To initiate an exception request to enable this integration for your organization, email [support@ddog-gov.com](mailto:support@ddog-gov.com). {% /alert %} {% /callout %} ClickHouse Cloud dashboard in Datadog ## Overview{% #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{% #setup %} 1. Navigate to the ClickHouse Cloud integration tile in Datadog. 1. Click **Connect Accounts**. You are redirected to the ClickHouse Cloud console. 1. Select the ClickHouse Cloud deployments that you want to monitor in Datadog. ## Data Collected{% #data-collected %} ### Metrics{% #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{% #uninstallation %} ### In ClickHouse Cloud{% #in-clickhouse-cloud %} 1. Log in to your ClickHouse Cloud organization. 1. Select a service and navigate to the **Settings** page. 1. In the **Integrations** section, click **Remove Datadog Integration**. ### In Datadog{% #in-datadog %} 1. Navigate to the **ClickHouse Cloud** integration tile. 1. Click **Uninstall** to remove the out-of-the-box dashboard. ## Support{% #support %} Need help? Open a support case from the ClickHouse Cloud console or contact [ClickHouse support](mailto:support@clickhouse.com).