clickcheck

Crates.ioclickcheck
lib.rsclickcheck
version0.3.0
created_at2025-06-15 16:41:17.344841+00
updated_at2025-06-29 11:59:45.899283+00
descriptionTool to analyze ClickHouse system tables, to detect potential issues for DBAs.
homepagehttps://github.com/St0rmPetrel/clickcheck
repositoryhttps://github.com/St0rmPetrel/clickcheck
max_upload_size
id1713445
size154,028
Telman (St0rmPetrel)

documentation

https://docs.rs/clickcheck

README

clickcheck

clickcheck — инструмент для анализа ClickHouse: Помогает DBA быстро обнаруживать и устранять проблемы.

На текущий момент ищет тяжелые запросы и ошибки. В потенциале будет также искать неэффективные запросы, аномалии, пики нагрузки, рост хранилища и другие проблемы.


🚀 Ключевые возможности

  • Анализ query_log: группировка запросов по fingerprint
  • Многоформатный вывод: текст, JSON, YAML
  • Управление профилями подключения (контексты)
  • Сбор данных со всех нод кластера (или указанных) с последующей агрегацией на стороне clickcheck

🛠️ Установка

cargo install clickcheck

⚙️ Использование

Используйте --help для подробной справки по каждой команде:

clickcheck --help
clickcheck queries --help
clickcheck errors --help
clickcheck context --help

Пример

clickcheck context set profile ch-hello -U 'https://my-ch-hello-node-1:8443' -U 'https://my-ch-hello-node-2:8443' -u 'hello_user' -i
# Вводим ClickHouse hello_user password:
clickcheck context set profile ch-bye -U 'https://my-ch-bye-node-1:8443' -u 'bye_user' -i
# Вводим ClickHouse bye_user password:

# Выставляем context по умолчанию
clickcheck context set current ch-hello

# Смотрим топ 5 тяжелых запросов на кластере ch-hello
clickcheck queries --last 1hour
# Смотрим топ 5 ошибок на ch-hello
clickcheck errors

# Смотрим топ 5 тяжелых запросов на кластере ch-bye
clickcheck queries --last 1hour --context ch-bye
Commit count: 31

cargo fmt