Установка Мониторинга — подключение к внешней ClickHouse

Цель 
 Установить Мониторинг с подключением к внешней базе данных ClickHouse вместо встроенной. Применяется, когда инфраструктура использует выделенный сервер ClickHouse 20 или ADQM 24. 
 Контекст 
 В Мониторинге ClickHouse служит для первичного хранения необработанных данных, собираемых с устройств по протоколу SNMP. 
 Предусловия 
 
 Внешняя ClickHouse развёрнута и доступна по сети с сервера Мониторинга. 
 Версия ClickHouse соответствует «Требования к серверу для установки Принтум» (ClickHouse 20 или ADQM 24). 
 Время отклика от сервера Мониторинга к внешней БД — в пределах 2–5 мс. 
 Создан пользователь с правами на чтение, удаление, редактирование строк и столбцов в базе, а также удаление, создание, редактирование таблиц. 
 Подготовлены остальные параметры установки Мониторинга (см. соответствующую страницу установки). 
 
 Что потребуется 
 
 CLICKHOUSE_HOST — адрес сервера БД. 
 CLICKHOUSE_PORT — порт подключения. 
 CLICKHOUSE_DATABASE — имя базы. 
 CLICKHOUSE_USER — имя пользователя для подключения. 
 CLICKHOUSE_PASSWORD — пароль пользователя. 
 (Опционально) CLICKHOUSE_SSL — True или False (регистр важен). 
 (При CLICKHOUSE_SSL=True ) CLICKHOUSE_CERT_CA — абсолютный путь к CA-сертификату. 
 
 Шаги установки 
 Шаг 1. Подготовить базовую установку Мониторинга 
 Выполнить шаги онлайн- или офлайн-установки до момента запуска install.sh . 
 Шаг 2. Сформировать команду установки с параметрами внешней ClickHouse 
 Добавить в команду установки следующие параметры: 
 CLICKHOUSE_HOST=<CLICKHOUSE_HOST>
CLICKHOUSE_PORT=<CLICKHOUSE_PORT>
CLICKHOUSE_DATABASE=<CLICKHOUSE_DATABASE>
CLICKHOUSE_USER=<CLICKHOUSE_USER>
CLICKHOUSE_PASSWORD=<CLICKHOUSE_PASSWORD>
CLICKHOUSE_SSL=<CLICKHOUSE_SSL>
CLICKHOUSE_CERT_CA=<CLICKHOUSE_CERT_CA> 
 Пример итоговой команды: 
 sudo -E CLICKHOUSE_HOST=<CLICKHOUSE_HOST> CLICKHOUSE_DATABASE=<CLICKHOUSE_DATABASE> CLICKHOUSE_USER=<CLICKHOUSE_USER> CLICKHOUSE_PASSWORD=<CLICKHOUSE_PASSWORD> CLICKHOUSE_SSL=True CLICKHOUSE_CERT_CA=<CLICKHOUSE_CERT_CA> CLICKHOUSE_PORT=<CLICKHOUSE_PORT> ./install.sh 
 Шаг 3. Поведение при шифрованном соединении 
 
 Если CLICKHOUSE_SSL=False или параметр пропущен — настройка SSL игнорируется. 
 Если CLICKHOUSE_SSL=True — будет использовано шифрованное соединение с проверкой сертификата по CLICKHOUSE_CERT_CA . 
 Регистр значения True / False важен и должен начинаться с большой буквы. 
 
 Ожидаемый результат 
 
 Установка завершается без ошибок подключения к внешней ClickHouse. 
 Мониторинг использует переданную внешнюю БД для первичных данных SNMP. 
 
 Как проверить установку 
 
 Открыть Личный кабинет Мониторинга и убедиться, что данные с устройств поступают. 
 На сервере внешней ClickHouse — проверить наличие активных подключений и таблиц. 
 
 Типовые ошибки 
 
 Connection refused / timeout к ClickHouse — проверить сетевую доступность и открытие порта CLICKHOUSE_PORT . 
 Authentication failed — проверить логин/пароль и права пользователя БД. 
 SSL handshake failed при CLICKHOUSE_SSL=True — проверить путь к CA-сертификату. 
 Параметр игнорируется — убедиться, что CLICKHOUSE_SSL имеет значение ровно True (с большой буквы). 
 
 Что проверить перед эскалацией 
 
 Версия ClickHouse / ADQM. 
 Параметры подключения (хост, порт, БД, пользователь). 
 Логи сервера ClickHouse за время установки. 
 Сетевая связность сервер Мониторинга → сервер БД на CLICKHOUSE_PORT . 
 
 Следующие шаги 
 
 Завершение установки Мониторинга — первый вход и проверка 
 
 Связанные страницы 
 
 Установка Мониторинга — онлайн, автоматические сертификаты 
 Установка Мониторинга — офлайн, автоматические сертификаты 
 Установка Мониторинга — подключение к внешней PostgreSQL 
 Требования к серверу для установки Принтум