В этом разделе описываются параметры всех виджетов, кроме виджетов События, Активные листы, Контекстные таблицы и Пользовательский виджет Активы.
Набор параметров, доступных для виджета, зависит от типа графика, который отображается на виджете. В KUMA доступны следующие типы графиков:
Параметры для круговых диаграмм
В таблице ниже представлены параметры для графиков типа Круговая диаграмма.
Описание параметров
Параметр |
Описание |
---|---|
Название |
Название виджета. |
Описание |
Описание виджета. |
Тенант |
Тенант, по которому отображаются данные на виджете. Вы можете выбрать несколько тенантов. По умолчанию данные отображаются по тенантам, которые вы выбрали в параметрах макета. |
Период |
Период, за который отображаются данные на виджете. По умолчанию выбрано Как на макете – отображаются данные за период, выбранный для макета. Вы также можете указать период для виджета одним из следующих способов:
Подробнее см. ниже в подразделе Настройка значения периода. |
Итоговые значения |
Суммы значений. |
Легенда |
Отображение легенды для аналитики. По умолчанию переключатель включен. |
Пустые значения в легенде |
Отображение параметров с нулевым значением в легенде для аналитики. По умолчанию переключатель включен. |
Десятичные знаки |
Количество десятичных знаков, до которых отображаемое значение должно быть округлено. |
Параметры для счетчиков
В таблице ниже представлены параметры для графиков типа Счетчик.
Описание параметров
Параметр |
Описание |
---|---|
Название |
Название виджета. |
Описание |
Описание виджета. |
Тенант |
Тенант, по которому отображаются данные на виджете. Вы можете выбрать несколько тенантов. По умолчанию данные отображаются по тенантам, которые вы выбрали в параметрах макета. |
Период |
Период, за который отображаются данные на виджете. По умолчанию выбрано Как на макете – отображаются данные за период, выбранный для макета. Вы также можете указать период для виджета одним из следующих способов:
Подробнее см. ниже в подразделе Настройка значения периода. |
Параметры для таблиц
В таблице ниже представлены параметры для графиков типа Таблица.
Описание параметров
Параметр |
Описание |
---|---|
Название |
Название виджета. |
Описание |
Описание виджета. |
Тенант |
Тенант, по которому отображаются данные на виджете. Вы можете выбрать несколько тенантов. По умолчанию данные отображаются по тенантам, которые вы выбрали в параметрах макета. |
Период |
Период, за который отображаются данные на виджете. По умолчанию выбрано Как на макете – отображаются данные за период, выбранный для макета. Вы также можете указать период для виджета одним из следующих способов:
Подробнее см. ниже в подразделе Настройка значения периода. |
Градиент |
Градиентная заливка графика:
Вы можете настроить направление заливки, нажав на значок переключения направления ( Если границы градиента не заданы вручную, они рассчитываются автоматически по значениям данных. Если между заданными границами нет данных, градиент не применяется. Вместо него используется два цвета: один для значений ниже нижней границы, другой – для значений выше верхней. |
Поле с индикатором градиента |
Столбец, в котором будут отображаться маркеры градиентной заливки. Этот столбец определяется полем из раскрывающегося списка. Тип поля зависит от типа виджета:
|
Десятичные знаки |
Количество десятичных знаков, до которых отображаемое значение должно быть округлено. |
Параметры для столбчатых, сложенных столбчатых и календарных диаграмм
В таблице ниже представлены параметры для графиков типа Столбчатая диаграмма и Календарная диаграмма, расположенные на вкладке Оси.
Описание параметров
Параметр |
Описание |
---|---|
Минимальное значение Y и Максимальное значение Y |
Масштаб оси Y. На осях графиков могут отображаться отрицательные значения. Это связано с масштабированием графиков на виджете и может быть исправлено выставлением нуля в качестве минимальных значений графиков вместо Авто. |
Минимальное значение X и Максимальное значение X |
Масштаб оси X. На осях графиков могут отображаться отрицательные значения. Это связано с масштабированием графиков на виджете и может быть исправлено выставлением нуля в качестве минимальных значений графиков вместо Авто. |
Десятичные знаки |
Количество десятичных знаков, до которых отображаемое значение должно быть округлено. |
В таблице ниже представлены параметры для графиков типа Столбчатая диаграмма, Сложенная столбчатая диаграмма и Календарная диаграмма, расположенные на вкладке Внешний вид.
Описание параметров
Параметр |
Описание |
---|---|
Название |
Название виджета. |
Описание |
Описание виджета. |
Тенант |
Тенант, по которому отображаются данные на виджете. Вы можете выбрать несколько тенантов. По умолчанию данные отображаются по тенантам, которые вы выбрали в параметрах макета. |
Период |
Период, за который отображаются данные на виджете. По умолчанию выбрано Как на макете – отображаются данные за период, выбранный для макета. Вы также можете указать период для виджета одним из следующих способов:
Подробнее см. ниже в подразделе Настройка значения периода. |
Формат |
Формат отображения данных: Абсолютные значения или Относительные значения, %. Параметр доступен для графика типа Сложенная столбчатая диаграмма. При выборе формата Абсолютные значения высота столбцов диаграммы соответствует сумме значений измеряемого показателя. При выборе формата Относительные значения, % все столбцы имеют одинаковую высоту 100%, а размеры цветных областей столбца соответствуют процентному соотношению между значениями показателя. По умолчанию выбрано Абсолютные значения. |
Вид временной диаграммы |
Формат отображения временных данных: Столбчатая диаграмма или Линейная диаграмма. Параметр доступен для графика типа Календарная диаграмма. При выборе формата Столбчатая диаграмма данные по умолчанию отображаются в виде вертикальных столбцов. В случае, если SQL-запрос содержит дополнительное поле с псевдонимом При выборе формата Линейная диаграмма данные отображаются в виде одной или нескольких (в зависимости от запроса) ломаных линий, соединяющих точки на временной оси. По умолчанию выбрано Столбчатая диаграмма. |
Показывать данные за предыдущий период |
Включение отображения данных сразу за два периода: текущий и предыдущий. |
Цвет |
Цвет отображения информации:
|
Градиент |
Градиентная заливка графика:
Вы можете настроить направление заливки, нажав на значок переключения направления ( Если границы градиента не заданы вручную, они рассчитываются автоматически по значениям данных. Если между заданными границами нет данных, градиент не применяется. Вместо него используется два цвета: один для значений ниже нижней границы, другой – для значений выше верхней. Градиентная заливка не применяется для сложенных столбчатых диаграмм. В этом случае цвета назначаются автоматически. |
Горизонтальный |
Использование горизонтальной гистограммы вместо вертикальной. При включении этого параметра вся имеющаяся информация будет отражена в заданном размере виджета. Если данных много, вы можете увеличить размер виджета для более удобного отображения данных. |
Итоговые значения |
Суммы значений. |
Легенда |
Отображение легенды для аналитики. По умолчанию переключатель включен. |
Пустые значения в легенде |
Отображение параметров с нулевым значением в легенде для аналитики. По умолчанию переключатель включен. Пустые значения отображаются только при включенном параметре Показать данные за предыдущий период, если в текущем периоде данных нет, а в предыдущем были. |
Длительность отрезков периода |
Длительность отрезков, на которые требуется делить период. Доступно для графика типа Календарная диаграмма. |
Параметры для графиков типа Спидометр
В таблице ниже представлены параметры для графиков типа Спидометр.
Значения на графике указываются в процентах.
Описание параметров
Параметр |
Описание |
---|---|
Вкладка Общие |
|
Название |
Название виджета. |
Тенант |
Тенант, данные которого отображаются на виджете. Можно выбрать только те тенанты, которые вы выбрали ранее в параметрах панели мониторинга. |
Категория активов |
Активы выбранной категории, по которым будет осуществляться поиск значений. |
Искать в активах без категории |
Поиск активов для формирования графика осуществляется без учета категорий активов. |
Ось 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 до 00:00:00:000 в UTC сегодняшнего дня. Вы можете посмотреть дату и время последнего обновления данных и точный период, за который отображаются данные, наведя курсор на значок периода на виджете.
Если для виджета вы включили параметр Показывать данные за предыдущий период, и данные на виджете отображаются за относительный период, во всплывающей подсказке также будет отображаться предыдущий период. Предыдущий период рассчитывается относительно текущего периода как значения начала и конца текущего периода минус длительность текущего периода. Например, если данные обновляются ежедневно и отображаются за месяц, но прошли только первые 10 дней месяца, прошлым периодом будут считаться последние 10 дней прошлого месяца.