Skip to main content

Useful queries for troubleshooting

A collection of handy queries for troubleshooting ClickHouse, including monitoring table sizes, long-running queries, and errors.

Useful queries for troubleshooting

In no particular order, here are some handy queries for troubleshooting ClickHouse and figuring out what is happening.

We also have a great blog with some essential queries for monitoring ClickHouse.

View which settings have been changed from the default

Get the size of all your tables

The response looks like:

Row count and average day size of your table

Compression columns percentage as well as the size of primary index in memory

You can see how compressed your data is by column. This query also returns the size of your primary indexes in memory - useful to know because primary indexes must fit in memory.

Number of queries sent by client in the last 10 minutes

Feel free to increase or decrease the time interval in the toIntervalMinute(10) function:

Number of parts in each partition

Finding long running queries

This can help find queries that are stuck:

Using the query id of the worst running query, we can get a stack trace that can help when debugging.

View the most recent errors

The response looks like:

Top 10 queries that are using the most CPU and memory

How much disk space are my projection using

Show disk storage, number of parts, number of rows in system.parts and marks across databases

List details of recently written new parts

The details include when they got created, how large they are, how many rows, and more:

· 4 min read