Skip to main content
С Grafana вы можете просматривать все свои данные и делиться ими через панели мониторинга. Для подключения к ClickHouse Grafana требуется плагин, который легко установить через интерфейс Grafana.

​
1. Соберите сведения о подключении

Чтобы подключиться к ClickHouse по native TCP, вам понадобится следующая информация: Сведения о подключении для вашего сервиса ClickHouse Cloud доступны в консоли ClickHouse Cloud. Выберите сервис, к которому хотите подключиться, и нажмите Connect:
Кнопка подключения сервиса ClickHouse Cloud
Выберите Native — сведения будут показаны в примере команды clickhouse-client.
Сведения о подключении Native TCP для ClickHouse Cloud
Если вы используете самоуправляемый ClickHouse, сведения о подключении задаются администратором ClickHouse.

​
2. Создание пользователя только для чтения

При подключении ClickHouse к инструменту визуализации данных, например Grafana, рекомендуется создать пользователя только для чтения, чтобы защитить данные от нежелательных изменений. Grafana не проверяет безопасность запросов. Запросы могут содержать любой SQL-оператор, включая DELETE и INSERT. Чтобы настроить пользователя только для чтения, выполните следующие действия:
  1. Создайте профиль пользователя readonly, следуя руководству Создание пользователей и ролей в ClickHouse.
  2. Убедитесь, что у пользователя readonly достаточно прав для изменения настройки max_execution_time, необходимой для клиента clickhouse-go.
  3. Если вы используете общедоступный экземпляр ClickHouse, не рекомендуется задавать readonly=2 в профиле readonly. Вместо этого оставьте readonly=1 и установите для max_execution_time тип ограничения changeable_in_readonly, чтобы разрешить изменение этой настройки.

​
3. Установите плагин ClickHouse для Grafana

Прежде чем Grafana сможет подключиться к ClickHouse, необходимо установить соответствующий плагин Grafana. Если вы уже вошли в Grafana, выполните следующие действия:
  1. На странице Connections на боковой панели выберите вкладку Add new connection.
  2. Найдите ClickHouse и нажмите на подписанный плагин от Grafana Labs:
    Выберите плагин ClickHouse на странице Connections
  3. На следующем экране нажмите кнопку Install:
    Установите плагин ClickHouse

​
4. Настройте источник данных ClickHouse

  1. После завершения установки нажмите кнопку Add new data source. (Источник данных также можно добавить на вкладке Data sources на странице Connections.)
    Создать источник данных ClickHouse
  2. Прокрутите страницу вниз и найдите тип источника данных ClickHouse или воспользуйтесь строкой поиска на странице Add data source. Выберите источник данных ClickHouse — откроется следующая страница:
Страница конфигурации подключения
  1. Введите настройки сервера и учетные данные. Основные параметры:
  • Server host address: имя хоста вашего сервиса ClickHouse.
  • Server port: порт вашего сервиса ClickHouse. Он зависит от конфигурации сервера и используемого протокола.
  • Protocol: протокол, используемый для подключения к вашему сервису ClickHouse.
  • Secure connection: включите этот параметр, если вашему серверу требуется защищенное подключение.
  • Username и Password: введите учетные данные пользователя ClickHouse. Если вы еще не настраивали пользователей, попробуйте использовать default в качестве имени пользователя. Рекомендуется настроить пользователя только для чтения.
Дополнительные параметры см. в документации конфигурация плагина.
  1. Нажмите кнопку Save & test, чтобы проверить, может ли Grafana подключиться к вашему сервису ClickHouse. Если все прошло успешно, вы увидите сообщение Data source is working:
    Выберите Save & test

​
5. Следующие шаги

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

​
Обновление версий плагина

Начиная с v4, конфигурации и запросы можно обновлять по мере выхода новых версий. Конфигурации и запросы из v3 мигрируются в v4 при открытии. Хотя старые конфигурации и панели мониторинга загружаются в v4, результаты миграции не сохраняются, пока вы снова не сохраните их в новой версии. Если при открытии старой конфигурации/запроса возникнут какие-либо проблемы, отмените изменения и сообщите о проблеме на GitHub. Плагин не может откатиться к предыдущим версиям, если конфигурация/запрос были созданы в более новой версии.
Последнее изменение 12 июня 2026 г.