Guides: Кастомные дашборды

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

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

Введение

Кастомные дашборды — раздел платформы Proto Observability для создания персонализированных визуализаций на основе метрик, логов и других данных. Дашборды позволяют собирать на одном экране виджеты с графиками, таблицами, карточками и текстом для мониторинга ключевых показателей.

Версия

Источник данных LogsQL доступен начиная с версии 200.

Как открыть: перейдите в раздел Дашборды в основном меню навигации платформы.

Создание дашборда

Перейдите в раздел Дашборды в меню навигации
Нажмите кнопку + Дашборд
В открывшемся окне введите название дашборда и нажмите Создать
Откроется конструктор дашбордов с пустой рабочей областью

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

Для отмены создания нажмите кнопку с красным крестиком рядом с кнопкой Сохранить.

Типы виджетов

При добавлении виджета выберите один из типов из выпадающего меню Виджет:

Тип	Описание
Текст	Виджет с произвольным текстом и форматированием. Поддерживает ссылки и базовое редактирование. Для редактирования нажмите иконку с тремя точками и выберите Изменить.
График	Виджет с визуализацией данных. Поддерживает несколько источников данных и типов визуализации. Настройка через иконку с тремя точками > Изменить.

Виджеты можно перемещать и изменять их размер на рабочей области дашборда. На дашборде может быть размещено произвольное количество виджетов обоих типов.

Источники данных для виджетов-графиков

При редактировании виджета типа «График» необходимо выбрать источник данных. Платформа поддерживает пять источников данных.

OLAP Мастер (APM и EUM метрики)

Источник данных OLAP Мастер — управляемый (wizard) режим для построения графиков по APM и EUM метрикам через OLAP-движок.

Возможности:

Выбор метрик из курируемого каталога
Выбор сервиса и эндпоинта (операции)
Автоматическое построение OLAP-запроса на основе выбранных параметров
Курируемый набор визуализаций, оптимизированных для APM-данных

Этот режим подходит для быстрого построения визуализаций по стандартным метрикам APM и EUM без написания запросов.

PromQL (Инфраструктурные метрики)

Источник данных PromQL позволяет писать произвольные PromQL-запросы для визуализации метрик Prometheus.

Возможности:

Текстовое поле для ввода PromQL-запроса
Добавление до 5 запросов на один виджет через кнопку + Запрос — результаты всех запросов отображаются на одном графике
Поддержка всех функций и операторов PromQL

Пример запроса:

round(avg(system_cpu_system{host=~".*central1.internal"}) by (host), 0.1)

Подробнее о синтаксисе PromQL см. Браузер метрик и построитель PromQL-запросов.

LogsQL (Аналитика логов)

Источник данных LogsQL позволяет визуализировать данные логов с помощью запросов LogsQL. Этот источник данных поддерживает два режима работы:

Режим Hits (попадания)

Визуализация количества лог-записей, соответствующих запросу, в виде временного ряда. Подходит для отслеживания динамики объема логов по заданным критериям.

Режим Stats (статистика)

Визуализация результатов агрегатных запросов LogsQL с использованием пайпа stats. Подходит для отображения вычисленных показателей (количество, среднее, максимум и другие агрегации).

Пример запроса LogsQL для режима Hits:

service:exact("payment-service") AND level:exact("error")

Подробнее о синтаксисе LogsQL см. Logs Explorer.

OLAP экспертный режим

Источник данных OLAP экспертный режим предоставляет полный доступ к OLAP-движку с расширенным набором визуализаций.

Возможности:

Произвольные OLAP-запросы (measures, dimensions, filters, timeDimensions)
Расширенный набор визуализаций, включая специализированные типы: поток бизнес-процесса (BusinessFlow), геокарта (GeoMap), граф связей (DirectedGraph), горизонтальная столбчатая диаграмма (StackHorizontalBar), составная карточка (CardStacked)
Полный контроль над параметрами запроса и отображения

Этот режим подходит для опытных пользователей, которым нужны расширенные визуализации и полный контроль над OLAP-запросами.

Базовый режим (устаревший)

Устаревший

Базовый режим сохранен для обратной совместимости. Рекомендуется использовать OLAP Мастер или OLAP экспертный режим для новых виджетов.

Источник данных Базовый режим использует GraphQL API для выбора метрик.

Возможности:

Выбор метрик через GraphQL API платформы
Поддержка специфичных визуализаций: список топ значений (TopList), текст (Text), тепловая карта (Heatmap), список сервисов (ServiceList), список эндпоинтов (EndpointList), список инстансов (InstanceList)

Типы визуализации

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

Визуализации для OLAP Мастер

Тип визуализации	Описание
Столбчатая диаграмма (Bar)	Вертикальные столбцы для сравнения значений
Линейная диаграмма (Line)	Линия, показывающая изменение значения во времени
Линейная диаграмма с областями (Area)	Линия с заполненной областью под ней
Круговая диаграмма (Pie)	Круговая визуализация долей
Карточка (Card)	Одно числовое значение крупным шрифтом
Таблица (Table)	Табличное представление данных
Воронка (Funnel)	Визуализация последовательных этапов процесса с уменьшением значений
Спидометр (Gauge)	Круговой индикатор значения
Карта Здоровья (Treemap)	Иерархическая древовидная карта для визуализации состояния компонентов
Линейная диаграмма с baseline (Line_baseline)	Линейный график с линией базового уровня

Визуализации для PromQL

Тип визуализации	Описание
Столбчатая диаграмма (Bar)	Вертикальные столбцы
Линейная диаграмма (Line)	Линейный график
Линейная диаграмма с областями (Area)	Линия с заполненной областью
Круговая диаграмма (Pie)	Круговая визуализация
Карточка (Card)	Одно числовое значение
Таблица (Table)	Табличное представление
Спидометр (Gauge)	Круговой индикатор
Карта Здоровья (Treemap)	Иерархическая древовидная карта для визуализации состояния компонентов
Линейная диаграмма с baseline (Line_baseline)	Линейный график с базовой линией

Визуализации для LogsQL

Доступные визуализации зависят от режима LogsQL:

Режим Hits (попадания):

Тип визуализации	Описание
Столбчатая диаграмма (Bar)	Объем логов по временным интервалам
Линейная диаграмма (Line)	Динамика количества логов
Линейная диаграмма с областями (Area)	Динамика с заполненной областью

Режим Stats (статистика):

Тип визуализации	Описание
Столбчатая диаграмма (Bar)	Результаты агрегации в виде столбцов
Линейная диаграмма (Line)	Результаты агрегации в виде линии
Линейная диаграмма с областями (Area)	Результаты агрегации с областью
Круговая диаграмма (Pie)	Результаты агрегации в виде долей

Визуализации для OLAP экспертного режима

Тип визуализации	Описание
Столбчатая диаграмма (Bar)	Вертикальные столбцы для сравнения значений
Линейная диаграмма (Line)	Линейный график
Линейная диаграмма с baseline (Line_baseline)	Линейный график с линией базового уровня
Линейная диаграмма с областями (Area)	Линия с заполненной областью
Карточка (Card)	Одно числовое значение крупным шрифтом
Таблица (Table)	Табличное представление данных
Круговая диаграмма (Pie)	Круговая визуализация долей
Воронка (Funnel)	Визуализация последовательных этапов процесса
Поток бизнес-процесса (BusinessFlow)	Визуализация потока бизнес-процесса с этапами и переходами
Спидометр (Gauge)	Круговой индикатор значения
Геокарта (GeoMap)	Географическая карта с данными по регионам
Граф связей (DirectedGraph)	Ориентированный граф для визуализации связей между компонентами
Столбчатая диаграмма горизонтальная стековая (StackHorizontalBar)	Горизонтальные столбцы с группировкой
Карточка составная (CardStacked)	Карточка с несколькими значениями
Карта Здоровья (Treemap)	Иерархическая древовидная карта для визуализации состояния компонентов

Визуализации для Базового режима (устаревший)

Тип визуализации	Описание
Столбчатая диаграмма (Bar)	Вертикальные столбцы для сравнения значений
Линейная диаграмма (Line)	Линия, показывающая изменение значения во времени
Линейная диаграмма с областями (Area)	Линия с заполненной областью под ней
Круговая диаграмма (Pie)	Круговая визуализация долей
Карточка (Card)	Одно числовое значение крупным шрифтом
Список топ значений (TopList)	Ранжированный список значений
Таблица (Table)	Табличное представление данных
Текст (Text)	Текстовое значение
Тепловая карта (Heatmap)	Цветовая матрица интенсивности значений
Список Сервисов (ServiceList)	Список сервисов с метриками
Список Эндпоинтов (EndpointList)	Список эндпоинтов с метриками
Список Инстансов (InstanceList)	Список инстансов с метриками
Линейная диаграмма с baseline (Line_baseline)	Линейный график с линией базового уровня
Спидометр (Gauge)	Круговой индикатор значения

Вкладки дашборда

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

Управление вкладками:

Переименование — нажмите иконку с тремя точками рядом с названием вкладки и выберите Переименовать вкладку
Добавление — нажмите иконку + рядом с последней вкладкой
Удаление — нажмите иконку x над названием вкладки

По умолчанию при создании дашборда доступна одна вкладка — «Вкладка 1».

Операции с дашбордами

Операция	Описание
Просмотр списка	Раздел Дашборды отображает список всех кастомных дашбордов
Открытие	Нажмите на название дашборда в списке
Редактирование	Нажмите иконку «ручка» в столбце Операции
Переименование	Нажмите иконку «страница» в столбце Опции
Удаление	Нажмите иконку красного крестика в столбце Опции
Поиск	Текстовое поле для поиска дашбордов по названию
Экспорт	Сохранение дашборда в файл для передачи
Импорт	Загрузка дашборда из файла

Примеры

Пример 1: дашборд с PromQL-виджетами для мониторинга CPU

Создайте новый дашборд
Добавьте виджет типа График
В настройках виджета выберите источник данных PromQL (Инфраструктурные метрики)
Выберите тип визуализации Линейная диаграмма
Введите запрос:

round(avg(system_cpu_system{host=~".*central1.internal"}) by (host), 0.1)

Задайте название виджета, например, «CPU по хостам»
Сохраните дашборд

Пример 2: виджет через OLAP Мастер для отслеживания времени отклика сервиса

Создайте новый дашборд или откройте существующий на редактирование
Добавьте виджет типа График
В настройках виджета выберите источник данных OLAP Мастер (APM и EUM метрики)
Выберите метрику, например, «Время отклика (P95)»
Выберите сервис из выпадающего списка
Выберите тип визуализации Линейная диаграмма
Задайте название виджета, например, «P95 время отклика — payment-service»
Сохраните дашборд

Документация Proto Observability Platform – виджеты

Guides: Кастомные дашборды

Введение

Версия

Создание дашборда

Типы виджетов

Источники данных для виджетов-графиков

OLAP Мастер (APM и EUM метрики)

PromQL (Инфраструктурные метрики)

LogsQL (Аналитика логов)

OLAP экспертный режим

Базовый режим (устаревший)

Устаревший

Типы визуализации

Визуализации для OLAP Мастер

Визуализации для PromQL

Визуализации для LogsQL

Визуализации для OLAP экспертного режима

Визуализации для Базового режима (устаревший)

Вкладки дашборда

Операции с дашбордами

Примеры