ClickHouse Cloud monitoring

[Edit this page](https://github.com/ClickHouse/clickhouse-docs/blob/main/docs/use-cases/observability/cloud-monitoring.md)

This guide provides enterprise teams evaluating ClickHouse Cloud with comprehensive information on monitoring and observability capabilities for production deployments. Enterprise customers frequently ask about out-of-the-box monitoring features, integration with existing observability stacks including tools like Datadog and AWS CloudWatch, and how ClickHouse’s monitoring compares to self-hosted deployments.

## Advanced observability dashboard[​](#advanced-observability "Direct link to Advanced observability dashboard")

ClickHouse Cloud provides comprehensive monitoring through built-in dashboard interfaces accessible via the Monitoring section. These dashboards visualize system and performance metrics in real-time without requiring additional setup and serve as the primary tools for real-time production monitoring within ClickHouse Cloud.

- **Advanced Dashboard**: The main dashboard interface accessible via Monitoring → Advanced dashboard provides real-time visibility into query rates, resource usage, system health, and storage performance. This dashboard doesn't require separate authentication, won't prevent instances from idling, and doesn't add query load to your production system. Each visualization is powered by customizable SQL queries, with out-of-the-box charts grouped into ClickHouse-specific, system health, and Cloud-specific metrics. You can extend monitoring by creating custom queries directly in the SQL console.

Note

Accessing these metrics doesn't issue a query to the underlying service and won't wake idle services.

Users looking to extend these visualizations can use the dashboards feature in ClickHouse Cloud, querying system tables directly.

- **Native advanced dashboard**: An alternative dashboard interface accessible through "You can still access the native advanced dashboard" within the Monitoring section. This opens in a separate tab with authentication and provides an alternative UI for system and service health monitoring. This dashboard allows advanced analytics, where you can modify the underlying SQL queries.

Both dashboards offer immediate visibility into service health and performance without external dependencies, distinguishing them from external debugging-focused tools like ClickStack.

For detailed dashboard features and available metrics, see the [advanced dashboard documentation](/docs/cloud/manage/monitor/advanced-dashboard).

## Query insights and resource monitoring[​](#query-insights "Direct link to Query insights and resource monitoring")

ClickHouse Cloud includes additional monitoring capabilities:

- Query Insights: Built-in interface for query performance analysis and troubleshooting
- Resource Utilization Dashboard: Tracks memory, CPU allocation, and data transfer patterns. CPU usage and memory usage graphs show the maximum utilization metric in a particular time period. The CPU usage graph shows a system-level CPU utilization metric (NOT a ClickHouse CPU utilization metric).

See the [query insights](/docs/cloud/get-started/query-insights) and [resource utilization](/docs/operations/monitoring#resource-utilization) documentation for detailed features.

## Prometheus-compatible metrics endpoint[​](#prometheus "Direct link to Prometheus-compatible metrics endpoint")

ClickHouse Cloud provides a Prometheus endpoint. This allows you to maintain current workflows, leverage existing team expertise, and integrate ClickHouse metrics into enterprise monitoring platforms including Grafana, Datadog, and other Prometheus-compatible tools.

The organization-level endpoint federates metrics from all services, while per-service endpoints provide granular monitoring. Key features include:

- Filtered metrics option: The optional filtered\_metrics=true parameter reduces payload from 1000+ available metrics to 125 'mission critical' metrics for cost optimization and easier monitoring focus
- Cached metric delivery: Uses materialized views refreshed every minute to minimize query load on production systems

Note

This approach respects service idling behavior, allowing for cost optimization when services aren't actively processing queries. This API endpoint relies on ClickHouse Cloud API credentials. For complete endpoint configuration details, see the cloud [Prometheus documentation](/docs/integrations/prometheus).

## Integration examples[​](#examples "Direct link to Integration examples")

External integration allows organizations to maintain established monitoring workflows, leverage existing team expertise with familiar tools, and integrate ClickHouse monitoring with broader infrastructure observability without disrupting current processes or requiring significant retraining investments.
Teams can apply existing alerting rules and escalation procedures to ClickHouse metrics, while correlating database performance with application and infrastructure health within a unified observability platform. This approach maximizes ROI on current monitoring setups and enables faster troubleshooting through consolidated dashboards and familiar tooling interfaces.

### Grafana Cloud monitoring[​](#grafana "Direct link to Grafana Cloud monitoring")

Grafana provides ClickHouse monitoring through both direct plugin integration and Prometheus-based approaches. The Prometheus endpoint integration maintains operational separation between monitoring and production workloads while enabling visualization within existing Grafana Cloud infrastructure. See [Grafana's ClickHouse documentation](https://grafana.com/docs/grafana-cloud/monitor-infrastructure/integrations/integration-reference/integration-clickhouse/) for configuration guidance.

### Datadog monitoring[​](#datadog "Direct link to Datadog monitoring")

Datadog is developing a dedicated API integration that will provide proper cloud service monitoring while respecting service idling behavior. In the interim, teams can use the OpenMetrics integration approach via ClickHouse Prometheus endpoints for operational separation and cost-efficient monitoring. For configuration guidance, see [Datadog's Prometheus and OpenMetrics integration documentation](https://docs.datadoghq.com/integrations/openmetrics/).

### ClickStack[​](#clickstack "Direct link to ClickStack")

ClickStack is ClickHouse's recommended observability solution for deep system analysis and debugging, providing a unified platform for logs, metrics, and traces using ClickHouse as the storage engine. This approach relies on HyperDX, the ClickStack UI, connecting directly to the system tables inside your ClickHouse instance.
HyperDX ships with a ClickHouse focused dashboard with tabs for Selects, Inserts, and Infrastructure. Teams can also use Lucene or SQL syntax to search system tables and logs, as well as create custom visualizations via Chart Explorer for detailed system analysis.
This approach is ideal for debugging complex issues, performance analysis, and deep system introspection rather than real-time production alerting.

Note

Note that this approach will wake idle services as HyperDX queries the system tables directly.

### ClickStack deployment options[​](#clickstack-deployment "Direct link to ClickStack deployment options")

- **HyperDX in Clickhouse Cloud** (private preview): HyperDX can be launched on any Clickhouse Cloud service.
- [Helm](/docs/use-cases/observability/clickstack/deployment/helm): Recommended for Kubernetes-based debugging environments. Supports integration with ClickHouse Cloud and allows for environment-specific configuration, resource limits, and scaling via `values.yaml`.
- [Docker Compose](/docs/use-cases/observability/clickstack/deployment/docker-compose): Deploys each component (ClickHouse, HyperDX, OTel collector, MongoDB) individually. You can modify the compose file to remove any unused components when integrating with ClickHouse Cloud, specifically ClickHouse and the Open Telemetry Collector.
- [HyperDX Only](/docs/use-cases/observability/clickstack/deployment/hyperdx-only): Standalone HyperDX container.