Bar gauge#

Линейчатые индикаторы упрощают обработку данных, сводя каждое поле к одному значению. Выбирается, как Grafana рассчитает сокращение. В этой визуализации может отображаться один или несколько линейчатых индикаторов в зависимости от того, сколько рядов, строк или столбцов возвращает ваш запрос.

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

Можно использовать визуализацию линейчатого индикатора, когда вам нужно показать:

• Ключевые показатели эффективности (KPI)

• Работоспособность системы

• Цели экономии

• Посещаемость

• Показатели завершения процесса

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

• Пользователь авторизован и имеет права на редактирование дашборда.

• Источник данных предоставляет числовые значения.

• Визуализация «Bar gauge» доступна в списке типов панелей.

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

• Используйте Bar gauge для отображения KPI и ключевых метрик с четкими порогами.

• Не отображайте более 10–15 индикаторов одновременно — это снижает читаемость.

• При использовании режима All values ограничивайте количество строк через Limit во избежание перегрузки интерфейса.

• Настройте корректные Min/Max значения — автоматический расчет может искажаться выбросами.

• Используйте Gradient или пороги для визуального выделения критичных значений.

• Включайте Show unfilled area для лучшего восприятия шкалы (кроме режима Retro LCD).

• Избегайте мелкого текста — настройте Text size для удобства чтения на табло.

• Регулярно проверяйте актуальность данных и корректность расчетов (особенно при Calculation).

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

1. Убедитесь, что плагин визуализации «Bar gauge» установлен в продукте PVV.

2. Откройте дашборд визуализации в интерфейсе PVV.

3. Выберите тип визуализации «Bar gauge».

4. Настройте параметры конфигурации

   

5. Нажмите кнопку «Save Dashboard», чтобы отобразить визуализацию панели.

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

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

Пример 1#

Минимальный и максимальный диапазоны для линейчатых калибров автоматически выбираются из наибольшего и наименьшего числовых значений в наборе данных. Можно вручную определить минимальное и максимальное значения, как указано в разделе «Стандартные параметры».

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

Пример 2#

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

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

Пример 3#

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

По умолчанию визуализация настроена на вычисление одного значения для каждого столбца или ряда и отображение только последнего набора данных. Однако она выводит минимальное и максимальное значения из всего набора данных, даже если эти значения не видны. В данном примере это означает, что в датчиках отображается только последняя строка данных, а минимальное и максимальное значения определяются как 2 и 20 и берутся из всего набора данных.

Если вы хотите отображать по одному показателю на ячейку, вы можете изменить параметр отображения с Show на Calculate to All, и каждый столбец будет помечен путем объединения текстового столбца с названием столбца каждого значения.

Для получения дополнительной информации об этих настройках обратитесь к разделу Параметры значений.

Параметры конфигурации#

Panel options#

В разделе Параметры панели на панели редактора панелей задайте основные параметры, такие как заголовок и описание панели, а также ссылки на панели. Дополнительные сведения смотри в разделе Настройка параметров панели.

Value options#

Используйте следующие параметры, чтобы уточнить способ отображения значений в вашей визуализации:

Bar gauge options#

Отрегулируйте способ отображения датчика.

Legend options#

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

Text size options#

Задайте размеры следующих текстовых элементов в пикселях:

Title - Название строки Value - Значение строки

Standard options#

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

Data links and actions#

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

Для каждого канала передачи данных установите следующие параметры:

• Title

• URL

• Open in new tab

Ссылки на данные для этой визуализации не включают переключатель One click, однако, если настроен только один канал передачи данных, этот канал передачи данных имеет функцию One click. Если настроено несколько каналов передачи данных, то при нажатии на визуализацию открывается меню, в котором отображаются все каналы передачи данных.

Value mappings#

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

Для каждого отображения значений задайте следующие параметры:

• Condition - выберите, что будет отображаться в отображаемом тексте и (необязательно) цвете:

  • Value - Конкретные значения

  • Range - Числовые диапазоны

  • Regex - Регулярные выражения

  • Special - специальные значения, такие как Null, NaN (не число), или логические значения, такие как true и false

• Display text - Отображаемый текст

• Color - Цвет (необязательно)

• Icon- Значок (только на холсте)

Дополнительные сведения смотри в разделе Настройка сопоставления значений.

Thresholds#

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

Для каждого порогового значения задайте следующие параметры:

Чтобы узнать больше, обратитесь к разделу Настройка пороговых значений.

Field overrides#

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

Выберите один из следующих вариантов переопределения:

Дополнительные сведения смотри в разделе Настройка переопределений полей.

Результат#

После настройки и сохранения панели с визуализацией Bar gauge выполните следующие шаги для проверки корректности ее работы:

1. Проверка отображения индикаторов
   Убедитесь, что:

   • Каждое числовое поле или строка данных отображается в виде отдельного линейчатого индикатора.

   • Длина (или высота) заполнения столбца пропорциональна значению.

   • При наличии нескольких строк/столбцов — отображаются все ожидаемые индикаторы (в зависимости от настройки Show: Calculate или All values).

2. Проверка расчета значений

   • Если выбран режим Calculate:

     • Убедитесь, что отображается одно значение на поле, рассчитанное с использованием выбранной функции (например, avg, max, last).

   • Если выбран режим All values:

     • Проверьте, что отображаются индикаторы для каждой строки.

     • Убедитесь, что ограничение Limit корректно работает (не отображается более указанного числа строк).

3. Проверка диапазона (Min/Max)

   • Убедитесь, что:

     • Минимальное и максимальное значения используются для шкалы индикатора.

     • При ручной настройке в Standard options — диапазон соответствует заданным значениям.

     • При автоматическом расчете — Min/Max определяются по всем данным (включая скрытые строки, как описано в примере 3).

4. Проверка ориентации и размеров

   • Убедитесь, что:

     • При выборе Horizontal — индикаторы отображаются слева направо.

     • При выборе Vertical — сверху вниз.

     • При Auto — ориентация выбирается корректно в зависимости от количества индикаторов.

   • Проверьте настройки размеров:

     • Bar size: Manual — ширина/высота столбцов соответствует заданным Min width, Min height, Max height.

     • При большом количестве индикаторов — появляется полоса прокрутки.

5. Проверка режима отображения (Display mode)

   • Убедитесь, что:

     • Gradient — цвет заполнения плавно меняется в зависимости от порогов.

     • Basic — используется один цвет, соответствующий текущему порогу.

     • Retro LCD — индикатор выглядит как сегментный дисплей с подсвеченными участками.

   • Проверьте, что опция Show unfilled area работает:

     • При включении — незаполненная часть отображается темно-серым цветом (кроме режима Retro LCD).

6. Проверка отображения текста и подписей

   • Убедитесь, что:

     • Названия полей отображаются в соответствии с настройкой Name placement (Top, Left, Hidden).

     • Значения отображаются или скрываются в зависимости от Value display.

     • Цвет значений соответствует настройке:

       • Value color — зависит от порога.

       • Text color — используется стандартный цвет текста.

   • Проверьте Text size options — размер шрифтов для заголовка и значения соответствует заданному.

7. Проверка порогов и цветовой схемы

   • Убедитесь, что:

     • Цвет индикатора меняется при достижении пороговых значений.

     • Режим Thresholds mode (Absolute, Percentage) работает корректно.

     • При использовании Color scheme — применяются выбранные цвета.

   • Если настроены Value mappings — проверьте, что отображаемый текст и цвет соответствуют условиям.

8. Проверка легенды

   • Убедитесь, что:

     • Легенда отображается при включенной опции Visibility.

     • Режим отображения (List, Table) и размещение (Bottom, Right) соответствуют настройкам.

     • Отображаемые значения (например, Min, Max, Total) корректны.

9. Проверка ссылок на данные (Data links)

   • Если добавлены ссылки:

     • Клик по индикатору должен переходить по-указанному URL.

     • При одной ссылке — переход происходит одним кликом.

     • При нескольких — открывается меню выбора.

   • Убедитесь, что переменные (например, $__value, $__field) подставляются корректно.

10. Проверка адаптивности и производительности

    • Обновите страницу — индикаторы должны перерисоваться без ошибок.

    • Измените временной диапазон — значения должны обновляться.

    • Откройте дашборд на мобильном устройстве — индикаторы должны отображаться корректно.

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

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