Skip to main content

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

Цель

Установить Мониторинг с подключением к внешней базе данных PostgreSQL вместо встроенной. Применяется, когда инфраструктура использует выделенный сервер БД (PostgreSQL 15 или Postgres PRO 15).

Контекст

Мониторинг использует двухступенчатое хранение данных:

    ClickHouse — первичное хранение необработанных данных, собираемых с устройств по SNMP. PostgreSQL — агрегированные и обработанные данные: значения счётчиков, статусы устройств и другие производные метрики.

    По умолчанию обе БД устанавливаются и конфигурируются вместе с Мониторингом. На этой странице описано подключение Мониторинга к внешней PostgreSQL.

    Предусловия

      Внешняя PostgreSQL развёрнута и доступна по сети с сервера Мониторинга. Версия PostgreSQL соответствует «Требования к серверу для установки Принтум» (PostgreSQL 15 или Postgres PRO 15). Время отклика от сервера Мониторинга к внешней БД — в пределах 2–5 мс. Создан пользователь БД с правами на чтение, удаление, редактирование строк и столбцов в базе, а также удаление, создание, редактирование таблиц. База данных уже создана на сервере PostgreSQL. Подготовлены остальные параметры установки Мониторинга (см. соответствующую страницу установки — онлайн или офлайн).

      Что потребуется

        POSTGRESQL_HOST — адрес сервера БД. POSTGRESQL_PORT — порт подключения. POSTGRESQL_DATABASE — имя базы (база уже должна существовать). POSTGRESQL_USER — имя пользователя для подключения. POSTGRESQL_PASSWORD — пароль пользователя. (Опционально) POSTGRESQL_SSLMODE — режим шифрованного соединения. (Опционально, при verify-ca или verify-full) POSTGRESQL_CERT_CA — абсолютный путь к CA-сертификату.

        Шаги установки

        Шаг 1. Подготовить базовую установку Мониторинга

        Выполнить шаги онлайн- или офлайн-установки до момента запуска install.sh (создать пароль администратора, подготовить сертификаты при необходимости).

        Шаг 2. Сформировать команду установки с параметрами внешней PostgreSQL

        Добавить в команду установки следующие параметры:

        POSTGRESQL_HOST=<POSTGRESQL_HOST>
POSTGRESQL_PORT=<POSTGRESQL_PORT>
POSTGRESQL_DATABASE=<POSTGRESQL_DATABASE>
POSTGRESQL_USER=<POSTGRESQL_USER>
POSTGRESQL_PASSWORD=<POSTGRESQL_PASSWORD>

        Пример итоговой команды:

        sudo -E POSTGRESQL_HOST=<POSTGRESQL_HOST> POSTGRESQL_PORT=<POSTGRESQL_PORT> POSTGRESQL_DATABASE=<POSTGRESQL_DATABASE> POSTGRESQL_USER=<POSTGRESQL_USER> POSTGRESQL_PASSWORD=<POSTGRESQL_PASSWORD> ./install.sh -s agent

        Шаг 3. (Опционально) Включить шифрованное соединение

        Если внешняя БД поддерживает шифрованное соединение, добавить:

        POSTGRESQL_SSLMODE=<POSTGRESQL_SSLMODE>

        Допустимые значения:

          allow, prefer, require, verify-ca, verify-full.

          Подробности — в официальной документации PostgreSQL: https://www.postgresql.org/docs/current/libpq-ssl.html#LIBPQ-SSL-PROTECTION. Другие значения означают, что шифрование не будет включено и параметр будет игнорироваться.

          При значении verify-ca или verify-full дополнительно указать:

          POSTGRESQL_CERT_CA=<POSTGRESQL_CERT_CA>

          где <POSTGRESQL_CERT_CA> — абсолютный путь до CA-сертификата, которым выдан сертификат сервера БД.

          Ожидаемый результат

            Установка завершается без ошибок подключения к внешней PostgreSQL. Мониторинг использует переданную внешнюю БД для хранения агрегированных данных.

            Как проверить установку

              Открыть Личный кабинет Мониторинга и убедиться, что данные отображаются. На сервере внешней PostgreSQL — проверить наличие активных подключений от сервера Мониторинга.

              Типовые ошибки

                Connection refused / timeout к PostgreSQL — проверить сетевую доступность и открытие порта POSTGRESQL_PORT. Authentication failed — проверить логин/пароль и права пользователя БД. Database does not exist — база должна существовать заранее. SSL handshake failed при verify-ca/verify-full — проверить путь к CA-сертификату.

                Что проверить перед эскалацией

                  Версия PostgreSQL. Параметры подключения (хост, порт, БД, пользователь). Логи сервера PostgreSQL за время установки. Сетевая связность сервер Мониторинга → сервер БД на POSTGRESQL_PORT.

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

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

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

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