> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-mintlify-fbfa8bee.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
> Введение в работу с ClickHouse в Grafana
# Плагин источника данных ClickHouse для Grafana
export const ClickHouseSupportedBadge = () => {
return
Поддерживается в ClickHouse
;
};
export const Image = ({img, alt, size}) => {
return
;
};
С Grafana вы можете просматривать все свои данные и делиться ими через панели мониторинга.
Для подключения к ClickHouse Grafana требуется плагин, который легко установить через интерфейс Grafana.
## 1. Соберите сведения о подключении
Чтобы подключиться к ClickHouse по native TCP, вам понадобится следующая информация:
| Параметры | Описание |
| ------------------------- | ------------------------------------------------------------------------------------------------------------------- |
| `HOST` and `PORT` | Обычно используется порт 9440 при использовании TLS или 9000 без TLS. |
| `DATABASE NAME` | По умолчанию доступна база данных `default`; используйте имя базы данных, к которой хотите подключиться. |
| `USERNAME` and `PASSWORD` | По умолчанию используется имя пользователя `default`. Используйте имя пользователя, подходящее для вашего сценария. |
Сведения о подключении для вашего сервиса ClickHouse Cloud доступны в консоли ClickHouse Cloud.
Выберите сервис, к которому хотите подключиться, и нажмите **Connect**:
Выберите **Native** — сведения будут показаны в примере команды `clickhouse-client`.
Если вы используете самоуправляемый ClickHouse, сведения о подключении задаются администратором ClickHouse.
## 2. Создание пользователя только для чтения
При подключении ClickHouse к инструменту визуализации данных, например Grafana, рекомендуется создать пользователя только для чтения, чтобы защитить данные от нежелательных изменений.
Grafana не проверяет безопасность запросов. Запросы могут содержать любой SQL-оператор, включая `DELETE` и `INSERT`.
Чтобы настроить пользователя только для чтения, выполните следующие действия:
1. Создайте профиль пользователя `readonly`, следуя руководству [Создание пользователей и ролей в ClickHouse](/ru/concepts/features/security/access-rights).
2. Убедитесь, что у пользователя `readonly` достаточно прав для изменения настройки `max_execution_time`, необходимой для [клиента clickhouse-go](https://github.com/ClickHouse/clickhouse-go).
3. Если вы используете общедоступный экземпляр ClickHouse, не рекомендуется задавать `readonly=2` в профиле `readonly`. Вместо этого оставьте `readonly=1` и установите для `max_execution_time` тип ограничения [changeable\_in\_readonly](/ru/concepts/features/configuration/settings/constraints-on-settings), чтобы разрешить изменение этой настройки.
## 3. Установите плагин ClickHouse для Grafana
Прежде чем Grafana сможет подключиться к ClickHouse, необходимо установить соответствующий плагин Grafana. Если вы уже вошли в Grafana, выполните следующие действия:
1. На странице **Connections** на боковой панели выберите вкладку **Add new connection**.
2. Найдите **ClickHouse** и нажмите на подписанный плагин от Grafana Labs:
3. На следующем экране нажмите кнопку **Install**:
## 4. Настройте источник данных ClickHouse
1. После завершения установки нажмите кнопку **Add new data source**. (Источник данных также можно добавить на вкладке **Data sources** на странице **Connections**.)
2. Прокрутите страницу вниз и найдите тип источника данных **ClickHouse** или воспользуйтесь строкой поиска на странице **Add data source**. Выберите источник данных **ClickHouse** — откроется следующая страница:
3. Введите настройки сервера и учетные данные. Основные параметры:
* **Server host address:** имя хоста вашего сервиса ClickHouse.
* **Server port:** порт вашего сервиса ClickHouse. Он зависит от конфигурации сервера и используемого протокола.
* **Protocol**: протокол, используемый для подключения к вашему сервису ClickHouse.
* **Secure connection**: включите этот параметр, если вашему серверу требуется защищенное подключение.
* **Username** и **Password**: введите учетные данные пользователя ClickHouse. Если вы еще не настраивали пользователей, попробуйте использовать `default` в качестве имени пользователя. Рекомендуется [настроить пользователя только для чтения](#2-making-a-read-only-user).
Дополнительные параметры см. в документации [конфигурация плагина](/ru/integrations/connectors/data-visualization/grafana/config).
4. Нажмите кнопку **Save & test**, чтобы проверить, может ли Grafana подключиться к вашему сервису ClickHouse. Если все прошло успешно, вы увидите сообщение **Data source is working**:
## 5. Следующие шаги
Ваш источник данных теперь готов к использованию! Подробнее о том, как составлять запросы с помощью [конструктора запросов](/ru/integrations/connectors/data-visualization/grafana/query-builder), см. в документации.
Подробнее о конфигурации см. в разделе [конфигурация плагина](/ru/integrations/connectors/data-visualization/grafana/config).
Если вам нужна дополнительная информация, которой нет в этой документации, посетите [репозиторий плагина на GitHub](https://github.com/grafana/clickhouse-datasource).
## Обновление версий плагина
Начиная с v4, конфигурации и запросы можно обновлять по мере выхода новых версий.
Конфигурации и запросы из v3 мигрируются в v4 при открытии. Хотя старые конфигурации и панели мониторинга загружаются в v4, результаты миграции не сохраняются, пока вы снова не сохраните их в новой версии. Если при открытии старой конфигурации/запроса возникнут какие-либо проблемы, отмените изменения и [сообщите о проблеме на GitHub](https://github.com/grafana/clickhouse-datasource/issues).
Плагин не может откатиться к предыдущим версиям, если конфигурация/запрос были созданы в более новой версии.