Добавление источника данных (Datasources)#

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

При настройке и эксплуатации источника данных SberTech Abyss SQL в системе Platform V View (PLUG) необходимо соблюдать следующие правила:

Работа с защищенной информацией#

  • При визуализации данных из Abyss:

    • Применяйте агрегацию и анонимизацию, где это возможно.

    • Избегайте прямого отображения идентификаторов пользователей, IP-адресов, номеров счетов и т.д.

Управление доступом#

  • Доступ к источнику данных регулируется ролями PLUG:

    • Роль Editor — выполнение и настройка запросов.

    • Роль Admin — полное управление источником (включая изменение токенов и сертификатов).

  • Регулярно ротируйте токены доступа (рекомендуемый срок — не более 90 дней).

Аудит и контроль#

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

    • События: datasource.create, datasource.update, datasource.test.

    • Параметры: user_id, ip, datasource_uid, result, timestamp.

Безопасность подключения#

  • TLS должен быть включен при подключении к Abyss:

    • Установите чекбокс With CA Cert и загрузите доверенный корневой сертификат.

    • Отключение Skip TLS Verify разрешено только в тестовых средах.

  • При использовании mTLS:

    • Убедитесь, что клиентские сертификаты хранятся в защищенном хранилище (например, Hashicorp Vault).

    • Пути к сертификатам в конфигурации должны быть доступны только под системным пользователем plug.

  • Не включайте опцию TLS Client Auth, если она не требуется.

Производительность и эксплуатация#

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

    • Используйте LIMIT, фильтрацию по времени и партиционированным полям.

    • Избегайте тяжелых JOIN и вложенных запросов.

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

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

Для выполнения операции добавления нового источника данных необходимо:

  • Иметь доступ к интерфейсу администрирования GRAF.

  • Заранее подготовить настройки подключения к источнику данных (URL, логин, пароль, тип СУБД и т.д.).

  • Обеспечить наличие соответствующих прав у пользователя на создание/редактирование источников данных.

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

Добавление источника данных (Datasource)#

setting-datasources

Для добавления источника данных (DataSources):

  • Перейдите в главное меню

  • Выберите Connections

  • Выберите плагин SberTech Abyss SQL.

  • Нажмите кнопку Add new data source.

  • Включите Exec On Front для работы DataSources через фронтенд.

  • В типе Work Mode укажите Abyss.

  • Укажите адрес подключения к Abyss, заполнить поля Project, AuthToken и параметры базовой аутентификации логин/пароль.

  • Если используется авторизация через IAM Proxy (AUTH), заполнить поле HeaderNamesList, именем заголовка в котором Platform V IAM SE Proxy (AUTH) передает JWT токен.

  • Важно! В поле name введите название «Indicator-Abyss» именно так, как называется datasource в дашбордах, названия должны совпадать.

  • Нажмите Save & Test.

Результат#

Добавление источника данных выполнен успешно.

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

  • Новый источник будет отображаться в списке доступных источников в интерфейсе GRAF.

  • Источник будет доступен для использования при создании запросов, дашбордов и других аналитических объектов.

  • Администратор сможет управлять источником: редактировать, тестировать подключение, удалять или дублировать при необходимости.

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

Описание механизмов безопасности#

  • Все соединения с кластером Abyss должны использовать протокол HTTPS с TLS 1.2 или выше.

  • Отключение проверки сертификата (Skip TLS Verify) запрещено в промышленной эксплуатации.

  • Поддерживается проверка самоподписанных сертификатов через загрузку CA Cert.

  • При необходимости может быть включена опция TLS Client Auth с указанием клиентского сертификата и закрытого ключа

  • Все действия, связанные с источником данных, фиксируются в системе аудита: datasource.create, datasource.update, datasource.test.