Установка Мониторинга — подключение к внешней 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.

NextСледующие stepsшаги

Завершение установки Мониторинга — первый вход и проверка

Связанные страницы

Установка Мониторинга — онлайн, автоматические сертификаты Установка Мониторинга — офлайн, автоматические сертификаты Установка Мониторинга — подключение к внешней PostgreSQL Требования к серверу для установки Принтум