Страница с графиками

В системе можно настроить специальную страницу с набором графиков из одного или нескольких объектов, которую можно использовать для генерации отчёта в формате PDF или при встраивании в виджет IFrame.

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

Настройка основного объекта

Основным объектом для страницы с графиками может служить любой объект системы.

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

Имя свойства

В имени свойства указывается имя метрики в формате:

chart:<имя метрики>

При необходимости добавить метрику из другого объекта нужно добавить идентификатор объекта:

chart:<ID внешнего объекта>:<имя метрики>

Значение свойства

В значении свойства задается отображаемое имя графика:

<желаемое название отображаемого графика>

Примеры

Имя свойства	Значение свойства	Описание
chart:TOTAL.percentUsed	Использование ОЗУ, %	График метрики TOTAL.percentUsed основного объекта
chart:61a662bdde9e7970b38b340c:percentageUsage.combined	Использование ЦП, %	График метрики percentageUsage.combined объекта с ID 61a662bdde9e7970b38b340c

Описание параметров URL

Страница с графиками доступна по ссылке вида:

http://
<адрес сервера системы SmartDCIM>
/iframe-widgets.html?#widget/selectable-chart/
<ID основного объекта>
/
<дополнительные параметры>

где:

• <адрес сервера системы SmartDCIM> (обязательно) – IP-адрес или FQDN инсталляции системы SmartDCIM;
• <ID основного объекта> (обязательно) – идентификатор объекта, в свойствах которого хранится список метрик и их отображаемые названия;
• <дополнительные параметры> (опционально) – настройки, которые определяют первоначальный вид страницы при её загрузке.

Пример:

http://
127.0.0.1
/iframe-widgets.html?#widget/selectable-chart/
5fcc9a4de0a5393f45fb99f3
/
chart=61a662bdde9e7970b38b340c:percentageUsage.combined
&
chart=TOTAL.percentUsed
&
period=last-24hours
&
cache=off

В данном примере:

• сервер работает на локальной машине и доступен по адресу 127.0.0.1;
• основным объектом указан объект с идентификатором 5fcc9a4de0a5393f45fb99f3;
• при загрузке страницы отображаются график метрики percentageUsage.combinedобъекта с идентификатором 61a662bdde9e7970b38b340c и график метрики TOTAL.percentUsed основного объекта за прошедшие сутки;
• при обновлении страницы загружаются заданные первоначальные параметры.

Элементы управления

Расположенные в верхней части страницы элементы управления позволяют выполнять следующие действия:

• выбирать отображаемые графики,
• изменять настройки отображения графиков,
• сохранять настроенную страницу в виде PDF-файла.

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

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

час,

день,

неделю,

месяц,

квартал,

год.

| | Тип значения | Если при запросе графика по метрике возвращается большой массив точек, то для оптимального построения графика производится автоматическое объединение точек. Способ вычисления значений точек графиков:

среднее значение – значения точек графика рассчитываются как среднее арифметическое значений метрики;

минимальное значение – значения точек графиков соответствуют минимальным значениям метрики;

максимальное значение – значения точек графиков соответствуют максимальным значениям метрики.

| | PDF | Кнопка сохранения страницы в PDF-формате. Подробнее об экспорте в PDF можно прочитать в разделе Экспорт PDF |

Также, некоторые элементы управления доступны на самих графиках.

При наведении курсора на график отобразится значение метрики в данный момент времени.

При нажатии на кнопку откроется список значений метрики, по которым построен график.

Значения в этом списке зависят от выбранного временного периода.

NOTE

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

При нажатии на кнопку страница экспортирует значения метрики в формате CSV.

Закрыть список можно кнопкой .

Дополнительные параметры URL

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

Параметр	Возможные значения	Описание
chart

chart=<имя метрики из основного объекта>

chart=TOTAL.percentUsed

chart=<ID нужного объекта>:<имя метрики из нужного объекта>

chart=61a662bdde9e7970b38b340c:percentageUsage.combined

| Графики, которые будут отображаться при загрузке страницы. По умолчанию открывается страница без графиков. | | period |

period=last-hour – за последний час,

period=last-24hours – за последний день,

period=last-7days – за последнюю неделю,

period=last-30days – за последний месяц,

period=last-90days – за последний квартал,

period=last-365days – за последний год.

| Период времени для построения графиков при загрузке страницы. По умолчанию отображаются графики за последний час. | | aggregate |

aggregate=avg – выбираются средние значения,

aggregate=max – выбираются максимальные значения,

aggregate=min – выбираются минимальные значения.

| Тип значения, применяемый при загрузке страницы. По умолчанию применяется функция усреднения. | | cache |

cache=on – пользовательские изменения настроек сохраняются при обновлении страницы,

cache=off – при обновлении страницы загружаются установленные параметры по умолчанию.

| Приоритет между пользовательскими настройками и дополнительными параметрами, указанными в URL, при обновлении страницы. По умолчанию при обновлении страницы внесённые пользователем изменения сохраняются. | | widget-instance-id | Значение параметра – имя представления, уникальное в рамках основного объекта. В качестве значения может быть использован любой набор символов.

Примеры:

widget-instance-id=1 – сохранение настроек в представлении с именем 1;

widget-instance-id=example – сохранение настроек в представлении с именем example.

| Сохранение настроек страницы в отдельном представлении с уникальным именем. По умолчанию настройки не записываются в представление. |

Представления страницы с графиками

Параметр widget-instance-id позволяет сохранять все производимые пользователем настройки в представлении с соответствующим именем.

Имена представлений задаются пользователями произвольно.

NOTE

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

Если встроить одну и ту же страницу с графиками в несколько IFrame-виджетов, то все изменения, вносимые через элементы управления на одном из виджетов, будут применяться и к остальным. Изменения с настройками отображения страницы можно зафиксировать в отдельном представлении с помощью параметра widget-instance-id. Имя представления соответствует значению параметра.

При указании widget-instance-id в дополнительных параметрах, изменения, вносимые через другие IFrame-виджеты с той же страницей с графиками, не будут влиять на настройки, сохранённые в представлении.

В настройках IFrame-виджета можно менять значение параметра widget-instance-id, чтобы создать еще одно представление или восстановить настройки из ранее сохранённого.

Пример ссылки на страницу с графиками с использованием widget-instance-id:

http://
127.0.0.1
/iframe-widgets.html?#widget/selectable-chart/
5fcc9a4de0a5393f45fb99f3
/
widget-instance-id=default

В данном примере:

• сервер работает на локальной машине и доступен по адресу 127.0.0.1;
• основным объектом указан объект с идентификатором 5fcc9a4de0a5393f45fb99f3;
• настройки отображения страницы сохраняются в представлении с именем default.

Экспорт PDF

Кнопка PDF в правом верхнем углу страницы экспортирует текущую страницу в формате PDF.

В экспортируемый файл включена следующая информация:

• Период;
• Тип агрегации;
• Все открытые графики;
• Список значений метрики (если открыт во время экспорта).

NOTE

Язык текста в экспортированном файле зависит от выбранного языка в веб интерфейсе.

NOTE

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