Перейти к основному содержимому
Версия: Графиня 2026H1

Администрирование источников данных

Источники данных — это внешние системы, из которых система получает информацию для построения витрин.

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

Список источников​

Перейдите в раздел «Источники данных» — значок базы данных в боковом меню слева (при наведении отображается подсказка «Источники данных»).

На странице «Источники данных» отображается таблица подключений. В правой части заголовка доступны:

  • «Проверить состояние» — проверка доступности источников;
  • «Добавить источник данных» — создание нового подключения.

Источники данных

В таблице отображаются столбцы:

  • «Название источника» — имя подключения (ссылка для открытия настроек);
  • «Тип» — тип плагина (например, Pult / Zabbix, Postgres, CSV);
  • «Автор» — пользователь, создавший источник;
  • столбец действий.

Для столбца «Название источника» доступна фильтрация. Внизу таблицы — постраничная навигация.

Создание и редактирование​

При создании («Добавить источник данных») или редактировании источника в верхней части формы доступны:

  • «Проверить соединение» — проверка корректности подключения;
  • «Сохранить» — сохранение изменений;
  • «Удалить источник» — удаление источника (на странице редактирования).

Форма источника данных

Общие поля формы:

  • «Источник данных» (обязательное) — название подключения;
  • «Тип» (обязательное) — выбор типа в списке (доступны Pult / Zabbix, Victoria Metrics / Prometheus, Postgres, CSV, JSON, GitLab, Elasticsearch, ClickHouse и др. в зависимости от установленных плагинов).

Для каждого типа отображается свой набор параметров.

CSV​

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

Добавление источника данных CSV

Способ получения данных выбирается переключателем:

  • «Загрузка файла» — выбор файла на компьютере («Выберите файл», до 768 Кб);
  • «URL» — загрузка по сетевому адресу;
  • «Ввод текста файла» — вставка содержимого вручную;
  • «Файловая система» — путь к файлу на сервере.

Дополнительные параметры:

  • «Кодировка» (обязательное) — например, UTF-8;
  • «Разделитель» (обязательное) — символ разделения значений;
  • «Формат времени» — шаблон парсинга даты и времени (например, dd-MM-yyyy HH:mm:ss);
  • «Первая строка» (обязательное) — «Данные» или «Заголовок».

JSON​

Источник JSON загружает данные из JSON-файла или JSON-ответа API и использует их в запросах виджетов и переменных витрины. При «Проверить соединение» плагин читает и разбирает JSON из выбранного способа получения данных.

Добавление источника данных JSON

Способ получения данных задаётся переключателем «Источник данных» (в форме типа JSON — не путать с общим полем названия подключения в шапке):

  • «Загрузка файла» — выбор JSON-файла на компьютере («Выберите файл», до 768 Кб);
  • «URL» — запрос к HTTP(S)-эндпоинту, возвращающему JSON;
  • «Ввод текста файла» — вставка JSON вручную в поле «JSON-содержимое»;
  • «Файловая система» — путь к файлу, доступному серверу плагина («Путь к файлу»).

Общие параметры (для всех режимов):

  • «Кодировка» (обязательное) — например, UTF-8 (также доступны UTF-16, Windows-1251, US-ASCII);
  • «Формат времени» — шаблон разбора даты и времени в данных (если не задан, используется dd-MM-yyyy HH:mm:ss).

Дополнительные поля в режиме «URL»:

  • «Метод» (обязательное) — GET, POST или PUT;
  • «URL» (обязательное) — адрес эндпоинта;
  • «Пропустить проверку TLS» — «Проверять» / «Игнорировать»; при «Проверять» — «TLS-сертификат»;
  • «Добавить заголовки» — «Нет» / «Да»; при «Да» — блок «Заголовок» (пары «Название» / «Значение», например Authorization и Bearer <токен> для API).

В одном подключении используется только один способ получения JSON. Плагин JSON предварительно устанавливается в разделе Управление плагинами.

Подробное описание полей, зависимостей формы и примеры заполнения — в справочнике плагина JSON.

Postgres​

Источник Postgres используется для подключения к PostgreSQL и совместимым СУБД (Postgres 9+, Postgres PRO 13+, Pangolin 4+).

Добавление источника данных Postgres

Основные поля:

  • «Адрес» (обязательное) — хост и порт (например, IP:порт);
  • «Имя базы данных» (обязательное);
  • «Пользователь», «Пароль» (обязательные);
  • «Пропустить проверку TLS» — «Проверять» / «Игнорировать»;
  • «Режим ввода запросов пользователем» — «Запрещен» / «Разрешен»;
  • «Время жизни кеша», параметры пула соединений («Время ожидания подключения из пула», «Частота опроса активного соединения», «Максимальный срок присутствия соединения в пуле», «Максимальное время простоя соединения в пуле», «Максимальный размер пула», «Минимальное количество простаивающих соединений»);
  • «SQL limit по умолчанию» — ограничение числа строк (0–50 000, значение 0 снимает ограничение);
  • «Код языка запросов» — язык подсветки синтаксиса (например, sql).

Victoria Metrics / Prometheus​

Источник Victoria Metrics / Prometheus подключается к системам мониторинга временных рядов.

Добавление источника данных Prometheus

Основные поля:

  • «URL» (обязательное) — адрес сервера Victoria Metrics / Prometheus;
  • «Пользователь», «Пароль» — учётные данные (при необходимости);
  • «Пропустить проверку TLS» — «Проверять» / «Игнорировать»;
  • «Режим ввода запросов пользователем» — «Запрещен» / «Разрешен»;
  • «Код языка запросов» — например, promql.

Pult / Zabbix​

Источник Pult / Zabbix используется для интеграции с системой мониторинга «Пульт» и Zabbix.

Добавление источника данных Pult / Zabbix

Основные поля:

  • «URL» (обязательное) — адрес сервера;
  • «Порт» — порт подключения;
  • «Пропустить проверку TLS» — «Проверять» / «Игнорировать»;
  • «TLS-сертификат» — при необходимости;
  • «Метод аутентификации» (обязательное) — «Токен» или «Логин и пароль»;
  • «Пользователь», «Пароль» — при выборе входа по логину и паролю;
  • «Использовать тренды» — «Включено» / «Выключено»;
  • «Тренды используются для запросов данных старше (дней)» (1–30);
  • «Тренды используются для запросов данных диапазоном больше (дней)» (1–7);
  • «Время жизни кеша» — срок кеширования в секундах (0 отключает кеш);
  • «Максимальное количество измерений запроса истории/трендов» — ограничение числа точек данных.

Тип подключения выбирается в поле «Тип» при создании источника. Соответствующий плагин предварительно настраивается в разделе Управление плагинами.

GitLab​

Источник GitLab подключается к GitLab API и используется для данных проектов, пайплайнов, merge request и других ресурсов GitLab.

Добавление источника данных GitLab

Основные поля:

  • «URL» (обязательное) — базовый адрес GitLab API, обычно с суффиксом /api/v4 (например, https://gitlab.example.local/api/v4);
  • «Токен доступа» (обязательное) — персональный токен с доступом к API;
  • «Количество страниц» — максимум страниц для выборок в конструкторах запросов (по умолчанию 5, диапазон 1–100).

Подробное описание полей и примеры заполнения — в справочнике плагина GitLab.

Elasticsearch​

Источник Elasticsearch подключается к кластеру Elasticsearch для поиска, агрегаций и работы с временными рядами.

Добавление источника данных Elasticsearch

Основные поля:

  • «URL» (обязательное) — адрес кластера (например, https://elastic.example.local:9200);
  • «Имя пользователя», «Пароль» — при необходимости базовой аутентификации;
  • «Пропустить проверку TLS» — «Проверять» / «Игнорировать»; при «Проверять» доступно поле «TLS-сертификат»;
  • «Индекс» (обязательное) — имя индекса или шаблон (например, logs-*);
  • «Поле времени» — поле метки времени (по умолчанию @timestamp);
  • «Версия» — 7.17+ или 8.0+;
  • «TTL кэша» — время кеширования в секундах (0 отключает кеш);
  • «Лимит по умолчанию» — лимит документов, если размер запроса не задан (0–10 000);
  • «Режим ввода запросов пользователем» — «Выключен» / «Включен».

Подробное описание полей — в справочнике плагина Elasticsearch.

ClickHouse​

Источник ClickHouse подключается к серверу ClickHouse для аналитических SQL-запросов.

Добавление источника данных ClickHouse

Основные поля:

  • «Хост» (обязательное), «Порт» (обязательное) — адрес и порт сервера;
  • «Протокол» — HTTP или Native;
  • «Безопасное соединение» — «Выключено» / «Включено»;
  • «Пропустить проверку TLS» — «Проверять» / «Игнорировать»; при «Проверять» — «TLS-сертификат»;
  • «Пользователь» (обязательное), «Пароль»;
  • «TLS-аутентификация» — при «Включена» — «Клиентский сертификат» и «Клиентский ключ»;
  • «База данных по умолчанию» (обязательное), «Таблица по умолчанию» — стартовые значения в конструкторе запросов;
  • «Таймаут подключения (сек)», «Таймаут запроса (сек)», «TTL кэша (сек)», «SQL-лимит по умолчанию»;
  • «Режим SQL-кода» — «Выключен» / «Включен».

Подробное описание полей и варианты подключения (HTTP, HTTPS, mTLS) — в справочнике плагина ClickHouse.