tocdepth: 2

Настройка виджетов

Пользователь по своему усмотрению может настраивать виджеты.

Просмотр виджетов дашборда

В списке нажмите на название дашборда. Откроется его карточка с добавленными виджетами и инструментами для дополнительной настройки параметров. Внешний вид виджетов зависит от выбранного процесса создания или редактирования типа визуализации: временной ряд, текст или статистический график.

Графики со значениями метрик можно обновить, нажав Обновить графики, а также задать интервалы автоматического обновления.

Чтобы изменить расположение виджетов на дашборде, наведите курсор на название виджета и перетащите карточку в нужное место формы.

Для просмотра метрик за определенный период в поле Период выберите интервал из списка или перейдите в Настроить период и с помощью календаря задайте нужное значение. Установленный интервал применится ко всем виджетам этого дашборда.

Временной период можно изменить одновременно на всех виджетах дашборда с помощью кнопок:

— временной период для просмотра метрик изменится на более поздний. Шаг сдвига будет равен значению, выбранному в поле Период.
— временной период изменится на более ранний. Шаг сдвига будет равен значению, выбранному в поле Период.
— временной период, выбранный в поле Период, отобразится в формате ДД.ММ.ГГГГ --- ДД.ММ.ГГГГ и уменьшится в два раза при однократном нажатии кнопки.
— временной период, выбранный в поле Период, отобразится в формате ДД.ММ.ГГГГ --- ДД.ММ.ГГГГ и увеличится в два раза при однократном нажатии кнопки.

Другой способ уменьшения или увеличения временного периода: на графике виджета выделите интересующий интервал. Новый интервал применится ко всем виджетам дашборда.

Чтобы посмотреть описание виджета, если оно было заполнено в преднастроенной конфигурации, наведите курсор на Кнопка с изображением знака вопроса рядом с названием виджета.

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

Создание виджета

В карточке выбранного дашборда нажмите Добавить виджет.

Подсказка

Найти нужный дашборд в общем списке можно с помощью поисковой строки.
В блоке Тип выберите тип визуализации нового виджета и укажите соответствующие параметры.
В этом случае на дашборд будет добавлен виджет в виде временного ряда.
- Укажите название виджета.
- Добавьте описание виджета. В этом случае в карточке виждета, рядом с названием, появится , нажав на который можно посмотреть описание.
- Настройте легенду:
  - с помощью флага задайте, показывать легенду на экране или нет;
  - выберите вид легенды: список или таблица;
  - задайте расположение легенды на виджете: слева внизу или справа вверху от графика с метриками.
- Настройте Левую ось:
  - Выберите категорию:
    
    Без размерности;
    
    Длительность;
    
    Проценты — 0 – 1;
    
    Проценты — 0 – 100;
    
    Объем данных;
    
    Передача данных.
  - Выберите тип визуализации графиков:
    
    Линии
    
    Задайте:
    
    Тип интерполяции данных на графике:
    
    Линейная — соседние значения метрики (точки на графике) соединяются прямыми линиями.
    
    Шаг до — график в виде ломанной линии, изображенной в виде шагов между точками, представляющими значения метрик. Линия примет новое значение в начале предыдущего шага относительно текущего временного отрезка.
    
    Шаг после — график в виде ломанной линии, изображенной в виде шагов между точками, представляющими значения метрик. Линия примет новое значение в начале следующего временного отрезка.
    
    Важно
    
    На графиках могут наблюдаться разрывы или одиночные точки в следующих случаях:
    
    если было получено одиночное или изолированное значение временного ряда (до и после данной точки как минимум за две временные метки не было значений метрики), то на графике для выбранного временного интервала наблюдается одиночная точка, справа и слева от которой отображается разрыв;
    
    если было получено несколько следующих друг за другом значений временного ряда и при этом до и/или после этого отрезка как минимум за две временные метки не было значений метрики, то на графике для выбранного временного интервала до и/или после данного отрезка наблюдается разрыв.
    
    Толщину линии на графике — от 1 до 5. По умолчанию толщина линии равна 2.
    
    Степень прозрачности закрашивания области под линией — от 0 до 100. Цвет окрашивания области соответствует цвету линии конкретного временного ряда. По умолчанию установлена прозрачность 100 — область прозрачная и не окрашенная.
    
    Показывать точки на линии или нет. По умолчанию данная опция выключена.
    
    Размер точек для отображения на линии — от 1 до 5. Поле активируется после выбора Показывать точки. По умолчанию размер точек равен 2.
    
    Столбцы
    
    Задайте:
    
    Тип выравнивания столбцов относительно точек получения данных: по левому краю, по правому краю или посередине. По умолчанию задано выравнивание Посередине.
    
    Толщину линий столбцов на графике — от 1 до 5. По умолчанию толщина линии равна 2.
    
    Степень прозрачности закрашивания области столбца — от 0 до 100. Цвет окрашивания области соответствует цвету конкретного временного ряда. По умолчанию установлена прозрачность 0.
    
    Показывать точки на линии или окантовке столбца или нет. По умолчанию данная опция выключена.
    
    Размер точек для отображения на столбце — от 1 до 5. Поле активируется после выбора Показывать точки. По умолчанию размер точек равен 2.
    
    Точки
    
    Задайте:
    
    Размер точек для отображения на графике — от 1 до 5. По умолчанию размер точек равен 2.
На дашборд будет добавлен виджет в виде текста.

Укажите название виджета и с помощью облегченного языка разметки Markdown введите необходимую текстовую информацию. В режиме редактирования виджета можно воспользоваться функцией предпросмотра.

Этот виджет выводит максимальное значение метрики и отображает тенденцию изменения метрики за выбранный период.

Укажите название виджета.
Для Временного ряда и Статистики в поле Запрос с помощью языков PromQL и MetricsQL введите запрос для получения метрик.
Для заполнения легенды можно использовать текст, лейбл (один или несколько) и комбинацию текста и лейблов.

Чтобы увидеть раскрывающийся список с лейблами, которые можно использовать в легенде запроса, в карточке запроса введите {{. После выбора нужного лейбла легенда автоматически заполнитеся макросом {{label.name}}. Например, {{endpoint}}, где endpoint — название лейбла.

Подсказка

Выполните дополнительные настройки:

Скройте или отобразите запрос

Снимите или установите флаг Показывать.

Измените запрос

Нажмите и выберите Редактировать.

Измените расположение карточки запроса

Нажмите и перетащите блок выше или ниже в списке запросов.

Скопируйте запрос с теми же параметрами

Нажмите и выберите Копировать.

Сверните карточку запроса

Нажмите .

Создайте дополнительный запрос

Нажмите Создать запрос. Заполните карточку нового запроса.

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

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