> ## Documentation Index
> Fetch the complete documentation index at: https://clickhouse.com/docs/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 = "lg"}) => {
const normalizedSize = ["sm", "md", "lg"].includes(size) ? size : "lg";
return
;
};
С Grafana вы можете просматривать все свои данные и делиться ими через панели мониторинга.
Для подключения к ClickHouse Grafana требуется плагин, который легко установить через интерфейс Grafana.
Чтобы подключиться к 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.
При подключении ClickHouse к инструменту визуализации данных, например Grafana, рекомендуется создать пользователя только для чтения, чтобы защитить данные от нежелательных изменений.
Grafana не проверяет безопасность запросов. Запросы могут содержать любые SQL-операторы, включая `DELETE` и `INSERT`.
Чтобы настроить пользователя только для чтения, выполните следующие действия:
1. Создайте профиль пользователя `readonly`, следуя руководству [Creating Users and Roles in ClickHouse](/docs/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](/docs/ru/concepts/features/configuration/settings/constraints-on-settings), чтобы разрешить изменение этой настройки.
Прежде чем Grafana сможет подключиться к ClickHouse, необходимо установить соответствующий плагин Grafana. Если вы уже вошли в Grafana, выполните следующие действия:
1. На странице **Connections** на боковой панели выберите вкладку **Add new connection**.
2. Найдите **ClickHouse** и нажмите подписанный плагин от Grafana Labs:
3. На следующем экране нажмите кнопку **Install**:
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).
Дополнительные параметры см. в документации [конфигурация плагина](/docs/ru/integrations/connectors/data-visualization/grafana/config).
4. Нажмите кнопку **Save & test**, чтобы проверить, может ли Grafana подключиться к вашему сервису ClickHouse. Если все прошло успешно, вы увидите сообщение **Data source is working**:
Теперь ваш источник данных готов к использованию! Подробнее о том, как создавать запросы с помощью [query builder](/docs/ru/integrations/connectors/data-visualization/grafana/query-builder).
Дополнительные сведения о конфигурации см. в документации [конфигурация плагина](/docs/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).
Плагин не может откатиться к предыдущим версиям, если конфигурация/запрос были созданы в более новой версии.
