Для мониторинга развертывания ClickHouse в Datadog ClickHouse предлагает несколько интеграций для разных вариантов развертывания. У каждой из них есть свои особенности и компромиссы: одни разрабатываются ClickHouse, другие — Datadog. Интеграции перечислены в рекомендуемом порядке.
Интеграция ClickHouse Cloud с API Datadog
Рекомендуемый способ передачи метрик уровня сервиса из ClickHouse Cloud в Datadog.
Вы подключаете свой аккаунт Datadog к ClickHouse Cloud с помощью OAuth-рукопожатия (Connect Accounts в плитке интеграции Datadog). Затем ClickHouse Cloud отправляет метрики уровня сервиса в Datadog вместо того, чтобы Datadog напрямую опрашивал сервис.
- Только в ClickHouse Cloud — не подходит для OSS ClickHouse
- Datadog не считает эти метрики пользовательскими
- Не предотвращает переход сервиса в состояние простоя
- Поставляется с предварительно настроенным набором панелей мониторинга и мониторов
Информацию по шагам онбординга см. в руководстве Datadog по интеграции ClickHouse Cloud.
Интеграция Prometheus с ClickHouse Cloud
Самый распространённый и универсальный способ собирать телеметрию на уровне сервиса и организации в ClickHouse Cloud.
Настройте Datadog Agent с помощью интеграции OpenMetrics для периодического опроса ClickHouse Cloud API и сбора метрик. Подробные сведения о настройке см. на странице интеграции Prometheus.
- Только в ClickHouse Cloud — не подходит для OSS ClickHouse
- В Datadog эти метрики учитываются как пользовательские метрики
- Не предотвращает переход сервиса в режим простоя
Интеграция ClickHouse с Datadog Agent
Это самый распространённый способ передачи данных из сервисов OSS ClickHouse в Datadog. Он также работает с ClickHouse Cloud, но с некоторыми оговорками.
Datadog Agent периодически опрашивает экземпляр ClickHouse и собирает метрики и журналы. Эта интеграция включает предварительно настроенный набор панелей мониторинга.
OSS ClickHouse: журналы и метрики поддерживаются полностью.
ClickHouse Cloud (частичная поддержка):
- Только метрики — журналы не поддерживаются
- Требуется
datadog-cluster-agent вместо datadog-agent
- Не позволит сервису перейти в режим простоя
Database Monitoring (DBM) для ClickHouse разрабатывает и поддерживает Datadog. Для этого Datadog Agent настраивается на сбор данных из системных таблиц экземпляра ClickHouse, что позволяет получать информацию о производительности на уровне запросов, аналогичную той, что встроенно доступна в ClickHouse Cloud Console. ClickHouse не участвует в этой интеграции — по всем проблемам обращайтесь в Datadog, а не в ClickHouse.
- Метрики бесплатны; отдельно оплачиваются журналы и ингестия данных из системных таблиц
- OSS ClickHouse: полностью поддерживается
- ClickHouse Cloud (частичная поддержка): требует
datadog-cluster-agent вместо datadog-agent; не даст сервису перейти в режим простоя
Сообщество ClickHouse разработало комплексные решения для мониторинга, интегрируемые с популярными стеками обсервабилити. ClickHouse Monitoring предоставляет полноценное решение для мониторинга с преднастроенными дашбордами. Этот проект с открытым исходным кодом предлагает быстрый старт для команд, которые хотят внедрить мониторинг ClickHouse, опираясь на устоявшиеся лучшие практики и проверенные конфигурации дашбордов.
Как и другие подходы к прямому мониторингу базы данных, это решение выполняет запросы напрямую к системным таблицам ClickHouse, из-за чего инстансы не могут переходить в состояние простоя, что негативно сказывается на оптимизации затрат.
API Billing & Usage позволяет программно получать доступ к данным о биллинге и использовании вашей организации в Cloud. Это полезно при создании собственных панелей мониторинга затрат или интеграции данных о биллинге в существующие процессы финансовой отчетности.
Полное справочное описание API см. в документации Billing API. Последнее изменение 24 июля 2026 г.