This page is not applicable to ClickHouse Cloud. The procedure documented here is automated in ClickHouse Cloud services.
You can monitor:
- Utilization of hardware resources.
- ClickHouse server metrics.
ClickHouse also monitors the state of hardware resources by itself such as:
- Load and temperature on processors.
- Utilization of storage system, RAM and network.
This data is collected in the
ClickHouse Server Metrics
ClickHouse server has embedded instruments for self-state monitoring.
To track server events use server logs. See the logger section of the configuration file.
- Different metrics of how the server uses computational resources.
- Common statistics on query processing.
You can find metrics in the system.metrics, system.events, and system.asynchronous_metrics tables.
You can configure ClickHouse to export metrics to Graphite. See the Graphite section in the ClickHouse server configuration file. Before configuring export of metrics, you should set up Graphite by following their official guide.
You can configure ClickHouse to export metrics to Prometheus. See the Prometheus section in the ClickHouse server configuration file. Before configuring export of metrics, you should set up Prometheus by following their official guide.
Additionally, you can monitor server availability through the HTTP API. Send the
HTTP GET request to
/ping. If the server is available, it responds with
To monitor servers in a cluster configuration, you should set the max_replica_delay_for_distributed_queries parameter and use the HTTP resource
/replicas_status. A request to
200 OK if the replica is available and is not delayed behind the other replicas. If a replica is delayed, it returns
503 HTTP_SERVICE_UNAVAILABLE with information about the gap.