ClickHouse

Расширение Ключ-АСТРОМ для мониторинга ClickHouse

Python-расширение Extensions 2.0 для мониторинга серверов ClickHouse через HTTP-интерфейс.

Требования

• АктивныйШлюз с включённым выполнением расширений.
• С АктивногоШлюза должен быть доступен HTTP- или HTTPS-интерфейс ClickHouse.
• Пользователь ClickHouse с правами чтения системных таблиц мониторинга.

Какие данные собираются

Коллектор получает все числовые значения из следующих таблиц:

Таблица ClickHouse	Префикс метрик Ключ-АСТРОМ	Назначение
system.metrics	clickhouse.metrics.*	Текущие значения: выполняемые запросы, слияния, память и другие показатели
system.events	clickhouse.events.*	Накопительные счётчики запросов, строк, байтов, CPU и операций ввода-вывода
system.asynchronous_metrics	clickhouse.asynchronous.*	CPU, память, MergeTree и другие системные показатели

Дополнительно расширение отправляет:

Метрика	Описание
clickhouse.topology	Служебная метрика для создания сущности хоста
clickhouse.host.availability	Результат проверки /ping: 1 — доступен, 0 — недоступен
clickhouse.host.replica_status	Результат /replicas_status: 1 — реплика исправна, 0 — недоступна или отстаёт
clickhouse.host.uptime	Время работы сервера в секундах

Метрика OSIOWaitMicroseconds формируется ClickHouse только при включённом Linux task_delayacct.

При необходимости включите его на сервере ClickHouse:

sudo sysctl -w kernel.task_delayacct=1

Для постоянного применения добавьте параметр в конфигурацию sysctl согласно правилам вашей ОС.

Создание пользователя ClickHouse

Пример пользователя с минимальными правами чтения:

CREATE USER astromkey
IDENTIFIED WITH sha256_password BY 'ЗАМЕНИТЕ_ПАРОЛЬ';

GRANT SELECT ON system.metrics TO astromkey;
GRANT SELECT ON system.events TO astromkey;
GRANT SELECT ON system.asynchronous_metrics TO astromkey;

История изменений

Версия	Изменения
1.0.26	Версия расширения для Ключ-АСТРОМ 1.285+. Добавлен удалённый мониторинг ClickHouse через HTTP- и HTTPS-интерфейсы. Добавлены метрики доступности сервера, состояния реплик и времени работы. Добавлен сбор показателей из системных таблиц ClickHouse.