Другие виджеты
В этом разделе описываются параметры всех виджетов, кроме виджетов События, Активные листы, Контекстные таблицы и пользовательский виджет Активы.
Набор параметров, доступных для виджета, зависит от типа графика, который отображается на виджете. В KUMA доступны следующие типы графиков:
- Круговая диаграмма (
). - Счетчик (
). - Таблица (
). - Столбчатая диаграмма (
). - Календарная диаграмма (
). - Линейная диаграмма.
Параметры для круговых диаграмм
В таблице ниже представлены параметры для графиков типа Круговая диаграмма.
Описание параметров
Параметр | Описание |
|---|---|
Имя | Название виджета. |
Описание | Описание виджета. |
Тенант | Тенант, по которому отображаются данные на виджете. Вы можете выбрать несколько тенантов. По умолчанию данные отображаются по тенантам, которые вы выбрали в параметрах макета. |
Период | Период, за который отображаются данные на виджете. По умолчанию выбрано Как на макете – отображаются данные за период, выбранный для макета. Вы также можете указать период для виджета одним из следующих способов:
Подробнее см. ниже в подразделе Настройка значения периода. |
Итоговые значения | Суммы значений. |
Легенда | Отображение легенды для аналитики. По умолчанию переключатель включен. |
Пустые значения в легенде | Отображение параметров с нулевым значением в легенде для аналитики. По умолчанию переключатель включен. |
Десятичные знаки | Количество десятичных знаков, до которых отображаемое значение должно быть округлено. |
Параметры для счетчиков
В таблице ниже представлены параметры для графиков типа Счетчик.
Описание параметров
Параметр | Описание |
|---|---|
Имя | Название виджета. |
Описание | Описание виджета. |
Тенант | Тенант, по которому отображаются данные на виджете. Вы можете выбрать несколько тенантов. По умолчанию данные отображаются по тенантам, которые вы выбрали в параметрах макета. |
Период | Период, за который отображаются данные на виджете. По умолчанию выбрано Как на макете – отображаются данные за период, выбранный для макета. Вы также можете указать период для виджета одним из следующих способов:
Подробнее см. ниже в подразделе Настройка значения периода. |
Параметры для таблиц
В таблице ниже представлены параметры для графиков типа Таблица.
Описание параметров
Параметр | Описание |
|---|---|
Имя | Название виджета. |
Описание | Описание виджета. |
Тенант | Тенант, по которому отображаются данные на виджете. Вы можете выбрать несколько тенантов. По умолчанию данные отображаются по тенантам, которые вы выбрали в параметрах макета. |
Период | Период, за который отображаются данные на виджете. По умолчанию выбрано Как на макете – отображаются данные за период, выбранный для макета. Вы также можете указать период для виджета одним из следующих способов:
Подробнее см. ниже в подразделе Настройка значения периода. |
Градиент | Градиентная заливка графика:
Вы можете настроить направление заливки, нажав на значок переключения направления ( Если границы градиента не заданы вручную, они рассчитываются автоматически по значениям данных. Если между заданными границами нет данных, градиент не применяется. Вместо него используется два цвета: один для значений ниже нижней границы, другой – для значений выше верхней.
|
Поле с индикатором градиента | Столбец, в котором отображаются маркеры градиентной заливки. Этот столбец определяется полем, выбранным в раскрывающемся списке. Тип поля зависит от типа виджета:
|
Десятичные знаки | Количество десятичных знаков, до которых отображаемое значение должно быть округлено. |
), а также задать пороговые значения.Параметры для столбчатых и календарных диаграмм
В таблице ниже представлены параметры для графиков типа Столбчатая диаграмма и Календарная диаграмма, расположенные на вкладке Оси.
Описание параметров
Параметр | Описание |
|---|---|
Ось Y и Мин - Макс | Масштаб оси Y. На осях графиков могут отображаться отрицательные значения. Это связано с масштабированием графиков на виджете и может быть исправлено выставлением нуля в качестве минимальных значений графиков вместо Авто. |
Ось X и Мин - Макс | Масштаб оси X. На осях графиков могут отображаться отрицательные значения. Это связано с масштабированием графиков на виджете и может быть исправлено выставлением нуля в качестве минимальных значений графиков вместо Авто. |
Десятичные знаки | Количество десятичных знаков, до которых отображаемое значение должно быть округлено. |
В таблице ниже представлены параметры для графиков типа Столбчатая диаграмма, Сложенная столбчатая диаграмма и Календарная диаграмма, расположенные на вкладке Внешний вид.
Описание параметров
Параметр | Описание |
|---|---|
Имя | Название виджета. |
Описание | Описание виджета. |
Период | Период, за который отображаются данные на виджете. По умолчанию выбрано Как на макете – отображаются данные за период, выбранный для макета. Вы также можете указать период для виджета одним из следующих способов:
Подробнее см. ниже в подразделе Настройка значения периода. |
Формат | Формат отображения данных: Абсолютные значения или Относительные значения, %. Параметр доступен для графика типа Сложенная столбчатая диаграмма. При выборе формата Абсолютные значения высота столбцов диаграммы соответствует сумме значений измеряемого показателя. При выборе формата Относительные значения, % все столбцы имеют одинаковую высоту 100%, а размеры цветных областей столбца соответствуют процентному соотношению между значениями показателя. По умолчанию выбрано Абсолютные значения. |
Вид временной диаграммы | Формат отображения временных данных: Столбчатая диаграмма или Линейная диаграмма. Параметр доступен для графика типа Календарная диаграмма. При выборе формата Столбчатая диаграмма данные по умолчанию отображаются в виде вертикальных столбцов. Если SQL-запрос содержит дополнительное поле с псевдонимом category, столбчатая диаграмма будет представлена в виде сложенной диаграммы, то есть с разбивкой каждого столбца по значениям этого поля. При выборе формата Линейная диаграмма данные отображаются в виде одной или нескольких (в зависимости от запроса) ломаных линий, соединяющих точки на временной оси. По умолчанию выбран формат Столбчатая диаграмма. |
Показывать данные за предыдущий период | Включение отображения данных сразу за два периода: текущий и предыдущий. |
Цвет | Цвет отображения информации:
|
Градиент | Градиентная заливка графика:
Вы можете настроить направление заливки, нажав на значок переключения направления ( Если границы градиента не заданы вручную, они рассчитываются автоматически по значениям данных. Если между заданными границами нет данных, градиент не применяется. Вместо него используется два цвета: один для значений ниже нижней границы, другой – для значений выше верхней. Градиентная заливка не применяется для сложенных столбчатых диаграмм. В этом случае цвета назначаются автоматически. |
Горизонтальный | Использование горизонтальной гистограммы вместо вертикальной. При включении этого параметра вся имеющаяся информация будет отражена в заданном размере виджета. Если данных много, вы можете увеличить размер виджета для оптимального отображения. |
Итоговые значения | Суммы значений. |
Легенда | Отображение легенды для аналитики. По умолчанию переключатель включен. |
Пустые значения в легенде | Отображение параметров с нулевым значением в легенде для аналитики. По умолчанию переключатель включен. Пустые значения отображаются только при включенном параметре Показать данные за предыдущий период, если в текущем периоде данных нет, а в предыдущем были. |
Длительность отрезков периода | Продолжительность сегментов, на которые вы хотите разделить период. Доступно для графиков типа Календарная диаграмма. |
Параметры для графиков типа Спидометр
В таблице ниже представлены параметры для графика Спидометр.
Значения на графике указываются в процентах.
Описание параметров
Параметр | Описание | |
|---|---|---|
Вкладка Общие | ||
Имя | Название виджета. | |
Тенант | Тенант, данные которого отображаются на виджете. Можно выбрать только те тенанты, которые вы выбрали ранее в параметрах панели мониторинга. | |
Категория активов | Активы выбранной категории, по которым будет осуществляться поиск значений. | |
Искать в активах без категории | Поиск активов для формирования графика осуществляется без учета категорий активов. | |
Ось Y | Указывается значение параметра, по которому будет выполнятся поиск активов и дальнейшее вычисление показания спидометра. Вы можете указать несколько значений параметров для поиска активов. | |
Вкладка Внешний вид | ||
Описание | Описание графика, которое отображается на виджете. | |
Предел событий | Для визуального определения критичности события циферблат спидометра разделен на три области: зеленую, желтую и красную. По умолчанию для этих областей определены следующие интервалы:
При необходимости вы можете изменить интервалы значений. | |
Настройка значения периода
Для таких графиков, как Круговая диаграмма, Счетчик, Таблица, Столбчатая диаграмма, Сложенная столбчатая диаграмма, Календарная диаграмма, вы можете настроить период отображения данных в виджете с помощью параметра Период. По умолчанию период отображения данных виджета совпадает с периодом отображения данных панели мониторинга.
Чтобы настроить период отображения данных, выполните одно из следующих действий:
- При необходимости измените дату и время в параметре Период одним из следующих способов:
- Если вы хотите указать точную дату, в календаре слева выберите даты начала и окончания периода и нажмите на кнопку Применить.
Вы можете выбрать дату до текущей включительно. Формат даты и времени зависит от параметров вашего браузера. Если в поле Дата от или Дата до есть значение и вы не меняли вручную значение времени, при выборе даты в календаре в поле Дата от автоматически подставится время 00:00:00.000, а в поле Дата до – 23:59:59.999. Если вы вручную удалили значение в поле Дата от или Дата до, при выборе даты в календаре в поле автоматически подставится текущее время. После того как вы выберите значение в одном из полей, фокус переключается на другое поле. Если в поле Дата до вы выбираете значение, которое меньше значения в поле Дата от, это меньшее значение будет автоматически подставлено в поле Дата от.
- Если вы хотите указать относительный период, выберите один из доступных периодов в списке Относительный период справа.
Период рассчитывается относительно настоящего времени.
- Если вы хотите задать пользовательский период, укажите или измените значение вручную в полях Дата от и Дата до.
Вы можете указать точные дату и время в формате DD.MM.YYYY HH:mm:ss.SSS для русской локализации и YYYY-MM-DD HH:mm:ss.SSS для английской локализации или период относительно текущего времени в виде формулы. При необходимости вы также можете комбинировать эти способы. Если при вводе точной даты вы не указали миллисекунды, значение 000 подставляется автоматически. Если вы вручную изменили время в полях Дата от или Дата до, при переключении даты в календаре значение времени не меняется.
В формулах относительного периода используйте параметр now для обозначения текущих даты и времени, а также: символы "+" (только в поле Дата до), "-", "/" (округление до ближайшего) и единицы изменения времени y (год), M (месяц), w (неделя), d (день), h (час), m (минута), s (секунда). Например, вы можете указать период now-5d, чтобы получить данные за последние пять дней, или now/w, чтобы получить данные с начала первого дня текущей недели (00:00:00:000 в UTC) до текущего времени now.
Поле Дата от является обязательным, и его значение не может превышать значение, установленное в поле Дата до, а также не может быть меньше 01.01.1970 (при указании точной даты или относительного периода). Значение в поле Дата до не должно быть меньше значения, установленного в поле Дата от. Если вы не укажете значение в поле Дата до, параметр now указывается автоматически.
Время в KUMA хранится в UTC, но в интерфейсе оно конвертируется в соответствии с часовым поясом вашего браузера. Это нужно учитывать для относительных периодов Сегодня, Вчера, Эта неделя и Этот месяц. Например, если в браузере установлен часовой пояс UTC+3 и вы выбрали период отображения данных Сегодня, данные будут отображаться за период с 03:00:00.000 до текущего времени, а не с 00:00:00.000.
Если при выборе относительного периода Сегодня, Вчера, Эта неделя или Этот месяц вы хотите отобразить данные в соответствии с вашим часовым поясом, вам нужно вручную добавить сдвиг по времени в поля Дата от и Дата до (если указано значение кроме now), прибавив или убавив необходимое количество часов. Например, если в браузере установлен часовой пояс UTC+3 и вы хотите отобразить данные за период Вчера, вам нужно изменить значение в поле Дата от на now-1d/d-3h, а в поле Дата до – на now/d-3h. Если же вы хотите отобразить данные за период Сегодня, вам нужно изменить значение только в поле Дата от на now/d-3h.
Если вам нужны результаты до 23:59:59:999 вчерашнего дня в UTC, то используйте SQL-запрос с фильтром по Timestamp или укажите точные дату и время.
Границы периода включаются: например, для периода Сегодня отобразятся события с начала сегодняшнего дня 00:00:00:000 UTC до текущего времени now включительно, а для периода Вчера – с начала вчерашнего дня 00:00:00:000 UTC до 00:00:00:000 UTC сегодняшнего дня. Вы можете посмотреть дату и время последнего обновления данных и точный период, за который отображаются данные, наведя курсор на значок периода на виджете.
Если параметр Показать данные за предыдущий период включен в свойствах виджета и виджет отображает данные за относительный период, во всплывающей подсказке также отображается предыдущий период. Предыдущий период рассчитывается относительно текущего периода – из начального и конечного значения текущего периода вычитается продолжительности текущего периода. Например, если данные обновляются ежедневно и отображаются за месяц, но прошли только первые 10 дней месяца, прошлым периодом будут считаться последние 10 дней прошлого месяца.
- Если вы хотите указать точную дату, в календаре слева выберите даты начала и окончания периода и нажмите на кнопку Применить.
- Если вы хотите отобразить на виджете данные за период, выбранный для макета, вы можете нажать на кнопку Сбросить. При изменении периода отображения данных на макете, также изменится отображаемый на виджете период.
