Guides: Экспорт данных и дашбордов

Mon, 01 Jan 0001 00:00:00 +0000

На этой странице:

Введение
Экспорт дашборда в PDF
Экспорт данных и изображений виджета
Экспорт и импорт определений дашбордов
Выгрузка данных через API

Введение

Платформа позволяет выгружать содержимое дашбордов на двух уровнях:

Весь дашборд — выгрузка всей страницы дашборда в PDF.
Отдельный виджет — сохранение виджета как изображения (PNG), копирование изображения в буфер обмена, а для виджетов-таблиц — выгрузка данных в Excel.

Отдельно платформа поддерживает экспорт и импорт определений дашбордов в формате JSON — это перенос конфигурации дашборда между установками, а не выгрузка данных.

Экспорт выполняется на стороне браузера: в выгрузку попадают те данные, которые отображаются на экране в момент экспорта (с учётом выбранного интервала времени и применённых фильтров).

Экспорт дашборда в PDF

В режиме просмотра дашборда в верхней панели инструментов рядом с выбором интервала времени расположена кнопка «Экспорт».

Нажатие на кнопку формирует PDF-файл, содержащий все виджеты дашборда в их текущем виде. Файл сохраняется в формате A4 (книжная ориентация) с именем вида <название-дашборда>-<дата>.pdf. Во время формирования файла кнопка показывает индикатор загрузки — для дашбордов с большим числом виджетов выгрузка может занять несколько секунд.

Кнопка «Экспорт» доступна на любом дашборде, включая встроенные обзорные страницы (например, «Обзор»):

Соседние кнопки «Сравнить» и «Поделиться» не относятся к экспорту: «Сравнить» накладывает данные за прошлый период, «Поделиться» формирует ссылку на текущий дашборд.

Экспорт данных и изображений виджета

У каждого виджета в правом верхнем углу заголовка есть значок меню (⋮). По нажатию открывается контекстное меню с действиями над виджетом, включая команды экспорта.

Набор команд зависит от типа виджета. Для графиков доступны экспорт изображения и копирование в буфер обмена; для виджетов-таблиц дополнительно появляется команда экспорта в Excel.

Сохранить изображение в файл

Команда «сохранить изображение в файл» формирует PNG-снимок виджета и скачивает его. Имя файла формируется из заголовка виджета: <название-виджета>_<метка-времени>.png. Подходит для вставки графиков в отчёты и презентации.

Сохранить изображение в буфер обмена

Команда «сохранить изображение в буфер обмена» копирует тот же PNG-снимок виджета в буфер обмена — его можно сразу вставить в документ, мессенджер или письмо без сохранения промежуточного файла.

Сохранить таблицу как Excel

Для виджетов типа «Таблица» в меню появляется дополнительная команда «сохранить как Excel».

Команда выгружает содержимое таблицы (заголовки колонок и строки данных) в файл формата .xlsx с именем вида <название-виджета>_<метка-времени>.xlsx. В отличие от экспорта изображения, в Excel попадают исходные значения ячеек, пригодные для дальнейшего анализа и расчётов.

Просмотр данных виджета

Команда «показать данные виджета» открывает окно с исходными данными виджета в формате JSON и кнопкой копирования. Это удобно, когда нужно скопировать «сырые» значения, лежащие в основе графика, например для отладки запроса или ручной обработки.

Экспорт и импорт определений дашбордов

На странице со списком дашбордов (раздел «Дашборды») доступны кнопки «Экспорт» и «Импорт».

Эти команды работают с определениями (конфигурацией) дашбордов, а не с данными:

Экспорт — выгружает выбранные в списке дашборды в JSON-файл. В файл попадает структура дашборда: виджеты, их источники данных, запросы и параметры визуализации.
Импорт — загружает JSON-файл и создаёт дашборды по сохранённой в нём конфигурации.

Используйте этот механизм для переноса дашбордов между установками платформы или для резервного копирования конфигурации. Чтобы выгрузить сами данные (значения метрик, строки таблиц), используйте экспорт в PDF, Excel или изображение, описанные выше.

Выгрузка данных через API

Описанные выше способы экспорта рассчитаны на ручную выгрузку из интерфейса. Для регулярной или программной выгрузки данных (интеграция с внешними системами, выгрузка по расписанию, построение собственных отчётов) используйте API платформы: запросы метрик через PromQL, выборку телеметрии и другие интерфейсы получения данных.

Полное описание интерфейсов и примеры запросов приведены в разделе Справочник API платформы — см. в нём раздел «Получение (выгрузка) данных».

Документация Proto Observability Platform – Excel