Datasource Pangolin DataBase#

data-sources-opensearch

Данный источник данных предназначен для подключения источников данных на базе Pangolin Database, являющегося форком PostgreSQL. Pangolin поддерживает стандартные возможности SQL и предоставляет инструменты для высокопроизводительной аналитики и эффективного построения отчетов.

Предусловия#

Источника данных должен предустановлен в компоненте GRAF

Правила эксплуатации#

  • Доступ к источнику данных ограничивается на уровне RBAC.

  • Все подключения к источнику фиксируются в системе аудита.

  • Ограничьте объем запрашиваемых данных.

  • Обновления плагина PostgreSQL осуществляются только в составе дистрибутива PLUG.

Последовательность выполнения#

Настройка источника данных Pangolin#

Выполните следующие действия, чтобы настроить новый источник данных:

  • Нажмите Connections в меню слева.

  • Нажмите Add new connection

  • Введите PostgreSQL в строке поиска.

  • Выберите источник данных PostgreSQL.

  • Нажмите Add new data source в правом верхнем углу.

Выполнен переход на вкладку Settings, где необходимо настроить источник данных.

pangolin-settings

Основные параметры#

Опция

Описание

Name

укажите имя источника данных (например, Pangolin-DB-1).

Default

при установке флага по умолчанию данный источник данных будет применяться по умолчанию для новых панелей.

Параметры подключения (Connection)#

Опция

Описание

Host URL

укажите IP-адрес или имя хоста экземпляра Pangolin (PostgreSQL) вместе с необязательным портом (по умолчанию 5432).

Database name

укажите имя вашей базы данных Pangolin.

Параметры аутентификации (Authentication)#

Опция

Описание

Username

введите имя пользователя для подключения к базе данных.

Password

введите пароль для указанного пользователя.

TLS/SSL Mode

определите, требуется ли использовать безопасное подключение TLS/SSL и какой режим безопасности применить.

Внимание

Не рекомендуется использовать учётную запись, под которой запускается процесс VIEW, в качестве источника подключения к PostgreSQL. Это связано с потенциальными рисками безопасности, такими как блокировка аккаунта в случае смены пароля.

Расширенные параметры TLS/SSL (TLS/SSL Method)#

Если включена поддержка TLS/SSL, у вас появятся опции для выбора метода TLS и деталей аутентификации:

Опция

Описание

File System Path

укажите путь к существующим сертификатам, расположенным в файловой системе, где запущен Grafana.

Certificate Content

если необходимо, можно вставить содержание сертификата напрямую в форму, и оно будет зашифровано и сохранено в базе данных Grafana.

Параметры сертификатов (TLS/SSL Auth Details)#

Опция

Описание

Root Certificate

укажите путь к корневому сертификату.

Client Certificate

укажите путь к клиентскому сертификату.

Client Key

укажите путь к клиенту закрытого ключа.

Параметры Pangolin (Pangolin Options)#

Опция

Описание

Version

выберите версию Pangolin, соответствующую вашей инсталляции.

Min Time Interval

минимальное временное разрешение для автоматического объединения значений. Рекомендуемая практика — установить этот параметр близким к периодичности обновления данных (например, 1 минута).

TimescaleDB

если ваша база данных расширяется с помощью TimescaleDB, включите эту опцию для поддержки агрегированных временных рядов.

Ограничения соединений (Connection Limits)#

Опция

Описание

Max Open

ограничивает максимальное число одновременно открытых соединений к базе данных (по умолчанию 100).

Auto Max Idle

автоматически устанавливает максимальный размер пула свободных соединений равным максимальному числу открытых соединений.

Max Idle

ограничение числа неиспользуемых соединений в пуле (по умолчанию 100).

Max Lifetime

срок жизни соединения в секундах (по умолчанию 14400 секунд, или 4 часа).

После внесения изменений не забудьте сохранить настройки, нажав кнопку Save & Test внизу страницы.

Результат#

После успешного сохранения и тестирования источника данных:

  • Отображается статус «Data source is working», подтверждающий корректность подключения к Pangolin Database.

  • Источник данных появляется в списке доступных источников с указанным именем (например, Pangolin-DB-1).

  • Данный источник становится доступным для использования при создании и редактировании панелей на дашбордах.

  • Поддерживается выполнение SQL-запросов с использованием полной функциональности PostgreSQL-совместимого синтаксиса, включая оконные функции, CTE и агрегации.

  • При включенной опции TimescaleDB становятся доступны специфичные функции для работы с гипертаблицами и сжатием временных рядов.

  • Все параметры подключения, включая настройки TLS/SSL, сохраняются в зашифрованном виде в базе данных PLUG.

  • Соединения управляются через пул с заданными ограничениями, что обеспечивает стабильность и производительность при высокой нагрузке.

  • Действие по добавлению источника фиксируется в системе аудита с указанием пользователя, времени, IP-адреса и результата операции.