> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-mintlify-8a08bda2.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Monitoring your ClickHouse Cloud deployment

> Overview of monitoring and observability capabilities for ClickHouse Cloud

<h2 id="overview">
  Overview
</h2>

This guide provides enterprise teams with information on monitoring and observability capabilities for production deployments of ClickHouse Cloud. 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.

Users can use the following methods to monitor their ClickHouse deployment:

| Section                                                                                | Description                                                                                                    | Wakes idle services? | Setup required           |
| -------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------- | -------------------- | ------------------------ |
| [Cloud Console dashboards](/products/cloud/features/monitoring/cloud-console)          | Day-to-day monitoring with built-in dashboards for service health, resource utilization, and query performance | No                   | None                     |
| [Notifications](/products/cloud/features/monitoring/notifications)                     | Alerts for scaling events, errors, mutations, and billing                                                      | No                   | None (customizable)      |
| [Prometheus endpoint](/products/cloud/features/monitoring/prometheus)                  | Export metrics to Grafana, Datadog, or other Prometheus-compatible tools                                       | No                   | API key + scraper config |
| [System table queries](/products/cloud/features/monitoring/system-tables)              | Deep debugging and custom analysis via direct SQL queries against `system` tables                              | Yes                  | SQL queries              |
| [Community and partner integrations](/products/cloud/features/monitoring/integrations) | Datadog agent integration, community monitoring tools, and the Billing & Usage API                             | Varies               | Tool-specific            |
| [Advanced dashboard reference](/products/cloud/features/monitoring/advanced-dashboard) | Detailed reference for each advanced dashboard visualization, including troubleshooting examples               | No                   | None                     |

<h2 id="quick-start">
  Quick start
</h2>

Open the ClickHouse Cloud console to the **Monitoring** tab. This [blog](https://clickhouse.com/blog/common-getting-started-issues-with-clickhouse) captures common things to watch out for when getting started.

For most users, the [Cloud Console dashboards](/products/cloud/features/monitoring/cloud-console) provide everything needed to monitor service health, resource utilization, and query performance without any configuration. If you need to integrate with an external monitoring stack, start with the [Prometheus-compatible metrics endpoint](/products/cloud/features/monitoring/prometheus).

<h2 id="system-impact">
  System impact considerations
</h2>

The above approaches use a mixture of either relying on Prometheus endpoints, being managed by ClickHouse Cloud, or [querying system tables](/products/cloud/features/monitoring/system-tables) directly. The latter of these options relies on querying the production ClickHouse service, which adds query load to the system under observation and prevents ClickHouse Cloud instances from [idling](/products/cloud/features/autoscaling/overview) which can impact costs. Additionally, if the production system fails, monitoring may also be affected, since the two are coupled.

Querying system tables directly works well for deep introspection and debugging but is less appropriate for real-time production monitoring. The [Cloud Console dashboards](/products/cloud/features/monitoring/cloud-console) and the [Prometheus endpoint](/products/cloud/features/monitoring/prometheus) both use pre-scraped metrics that do not wake idle services, making them better suited for ongoing production monitoring. Consider these trade-offs between detailed system analysis capabilities and operational overhead.