Интерфейс панели мониторинга

Интерфейс панели мониторинга — это инструмент для отображения нескольких графиков одновременно, все графики показывают один и тот же временной диапазон. Если вы не используете HTTP-интерфейс для встраивания графиков в собственные приложения или веб-страницы, то этот интерфейс Graphite вы будете использовать чаще всего. Он, безусловно, будет наиболее полезен операционному персоналу.

Начало работы с интерфейсом панели мониторинга

Вы можете получить доступ к интерфейсу панели мониторинга напрямую по адресу http://my.graphite.host/dashboard, или через ссылку в верхней части интерфейса Композера.

Автозаполнение или дерево браузера?

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

Если вы только просматриваете панель мониторинга, а не изменяете её, автозаполнение просто мешает. Вы можете изменить его размер, перетащив разделитель (между панелями автозаполнения и графика), или скрыть его, нажав на небольшой треугольный значок в разделителе. После скрытия тот же треугольный значок служит для повторного отображения панели.

Альтернативой автозаполнению является дерево браузера, которое отображается слева от панели графика. Чтобы переключиться в этот режим, используйте пункт меню Панель мониторинга | Настройка интерфейса и выберите Дерево (левое навигационное меню). Для отображения необходимо будет обновить страницу. Автозаполнение и дерево браузера выполняют одинаковую задачу, поэтому выбор зависит от ваших личных предпочтений. Ваш выбор сохраняется в постоянном cookie браузера, поэтому он должен сохраняться между сеансами.

Создание или изменение панели мониторинга

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

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

Добавление графика

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

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

Импорт графика

Существующие графики могут быть импортированы в вашу панель мониторинга, либо из URL-адресов, либо из сохранённых графиков.

Импортируйте график из URL-адреса, если у вас уже есть график, который вы хотите отобразить где-либо ещё (возможно, вы создали его в автозаполнении или хотите скопировать его из другой панели мониторинга). Используйте пункт меню Графики | Новый график | Из URL и введите URL-адрес, который вы, вероятно, скопировали из другого окна браузера.

В противном случае, если вы сохранили график в Композере, вы можете импортировать его. Используйте пункт меню Графики | Новый график | Из сохранённого графика и выберите график для импорта.

Удаление графика

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

Множественные метрики — объединение графиков

Самый простой способ отображения нескольких метрик на одном графике — добавить каждую как отдельный график, а затем объединить графики. Чтобы объединить 2 графика, перетащите один поверх другого, а затем подождите, пока целевой график не покажет «Опустить для слияния». Отпустите график, и целевой график теперь отобразит все метрики из обоих графиков. Повторяйте для требуемого количества метрик.

Однако, если у вас есть несколько связанных метрик, может быть проще использовать один путь с подстановкой — см. Пути и подстановки.

Переупорядочивание графиков

Перетащите график в нужное положение и отпустите его, пока не появится сообщение «Опустить для слияния».

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

Сохранение панели мониторинга

Если панель мониторинга была ранее сохранена, и если у вас есть необходимые разрешения (см. позже), вы можете использовать пункт меню Панель мониторинга | Сохранить для сохранения изменений. Обратите внимание, что ваша панель мониторинга будет видна всем пользователям, авторизованным или нет, и может быть изменена и/или удалена любым пользователем с соответствующими разрешениями.

Вы можете использовать пункт меню Панель мониторинга | Сохранить как для первого сохранения вашей панели мониторинга или для сохранения её с другим именем.

Просмотр панели мониторинга

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

Обратите внимание, что, скорее всего, вам нужно будет скрыть автозаполнение, работая в этом режиме — см. выше.

Открытие панели мониторинга

Используйте пункт меню Панель мониторинга | Поиск для выбора открываемой панели мониторинга.

Установка временного диапазона

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

Чтобы установить относительный временной диапазон, нажмите кнопку меню Относительный временной диапазон и введите временной диапазон для отображения (значение и единицы измерения, например, «6 часов»). По умолчанию этот временной диапазон заканчивается в текущее время, как показано «Сейчас» в поле единиц измерения «До». Однако вы можете сместить временной диапазон назад, введя собственное значение и единицы измерения в поля «До».

Чтобы установить абсолютный временной диапазон, нажмите кнопку меню Абсолютный временной диапазон и установите начальную и конечную даты и время (все обязательные поля). Даты можно выбрать с помощью календаря или ввести непосредственно в формате США (мм/дд/гггг), а время можно выбрать из раскрывающегося списка или ввести в формате 12 или 24 часов (например, «17:00»).

Ручной и автоматический обновление

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

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

Обратите внимание, что параметры обновления сохраняются вместе с панелью мониторинга.

Настройка графиков

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

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

Пути и подстановки

В любой среде достаточного размера у вас будут одни и те же или похожие метрики, собираемые с нескольких точек. Вместо того, чтобы заставлять вас добавлять каждый из них на график индивидуально, Graphite предоставляет мощный механизм подстановки. Например, метрический путь servers.*ehssvc*.cpu.total.{user,system,iowait} будет включать линию на графике для использования процессора, системы и ввода-вывода для каждого сервера, имя которого содержит ehssvc. Каждый из них называется метрической серией. Graphite также предоставляет большое количество функций для работы с группами метрических серий, например, отображения только 5 лучших метрических серий из группы.

Дополнительную информацию см. в разделе Пути и подстановки.

Настройка отдельного элемента метрики

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

Функции сгруппированы в меню следующим образом:

Объединить

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

Преобразовать

Функции, которые преобразуют значения в метрической серии, относительно оси Y или (в меньшей степени) оси X. Включает масштабирование, масштабирование до секунд, смещение, производная, интеграл, сдвиг во времени, логарифм.

Рассчитать

Функции, которые рассчитывают новую метрическую серию на основе существующей метрической серии. Включает скользящее среднее, процент, прогнозирование Хольта-Винтера, отношение и разность (2 метрик)

Фильтр

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

Специальные

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

Последним пунктом меню является Удалить внешний вызов, который удаляет самую внешнюю функцию текущей метрики.

Настройка всего графика

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

Функции сгруппированы следующим образом:

Заголовок графика

Неудивительно, что это задаёт заголовок для графика. См. title.

Отображение

Предоставляет параметры для:

• шрифтов (см. fontName, fontBold, fontItalic, fontSize и fgcolor)
• цветов (см. colorList, bgcolor, majorGridLineColor, minorGridLineColor и areaAlpha)
• легенды (см. hideLegend и uniqueLegend)
• толщину линий (см. lineWidth)
• скрытие элементов графика (см. graphOnly, hideAxes, hideYAxis и hideGrid)
• применение шаблона (см. template).

Режим отображения линий

Задаёт способ отображения линий, например, наклонные, ступенчатые, соединённые, и как отображается значение None. См. lineMode и drawNullAsZero.

Режим отображения области

Определяет, закрашивается ли область под линиями, и являются ли линии стопкой. См. areaMode.

Ось X

Позволяет установить формат времени для дат/времени на оси (см. xFormat), часовой пояс для интерпретации временных меток (см. tz) и порог для консолидации точек (наименьшее количество пикселей между точками перед их консолидацией, см. minXStep).

Ось Y

Определяет, как отображаются ось Y или оси. Это включает:

• метку (см. vtitle)
• минимальные/максимальные значения на оси (см. yMin и yMax)
• количество дополнительных линий для рисования (см. minorY)
• отображение по логарифмической шкале с указанным основанием (см. logBase)
• шаг между метками и сетчатыми линиями оси Y (см. yStep)
• делитель для оси (см. yDivisors)
• система единиц (SI, двоичная или никакая - см. yUnitSystem)
• сторона, на которой отображается ось (см. yAxisSide).

Если у вас более одной оси Y (потому что вы выбрали Применить функцию | Специально | Рисовать на второй оси Y хотя бы для одного ряда метрик), используйте пункт Параметры двойной оси Y в этом меню. Это обеспечивает индивидуальный контроль как левой, так и правой осей Y с теми же настройками, что и указаны выше.

Другие операции с графиком

Кнопка меню Операции с графиком используется для выполнения различных действий с графиком.

Разбиение

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

Копировать

Создаёт копию графика и добавляет её на панель инструментов.

Отправить по электронной почте

Позволяет отправить копию графика кому-либо по электронной почте.

Прямая ссылка

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

Другие глобальные параметры меню

Редактирование, импорт и экспорт через JSON

Пункт меню Панель инструментов | Редактировать панель инструментов отображает представление JSON (JavaScript Object Notation) текущей панели инструментов и всех её графиков в диалоговом окне редактора.

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

Обмен панелью инструментов

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

Изменение размеров графиков

Пункт меню Графики | Изменить размер и кнопка меню «Шестерёнка» позволяют устанавливать размер всех графиков на панели инструментов. Вы можете выбрать один из предустановленных размеров или выбрать Настроить и ввести собственные ширину и высоту (в пикселях).

Новая панель инструментов

Выбор пункта меню Панель инструментов | Новый удаляет связь между текущей панелью инструментов на экране и её сохранённой версией (если таковая имеется), что означает, что вам нужно будет использовать Панель инструментов | Сохранить как, чтобы сохранить её снова. Обратите внимание, что это не очищает содержимое панели инструментов, т.е. графики — используйте Удалить все для этого.

Удаление всех графиков

Чтобы удалить все графики на текущей панели инструментов, используйте пункт меню Графики | Удалить все или красную кнопку крестика в меню. Это запросит подтверждение, а также даст вам возможность пропустить подтверждение в будущем.

Удаление панели инструментов

Чтобы удалить панель инструментов, откройте Finder (используя пункт меню Панель инструментов | Finder), выберите панель инструментов для удаления в списке и нажмите Удалить. Обратите внимание, что вам может потребоваться войти как пользователю с соответствующими разрешениями, в зависимости от конфигурации Graphite.

Вход/выход

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

Войдите в Graphite, используя пункт меню Панель инструментов | Войти, который отображает стандартное диалоговое окно входа. После входа в систему пункт меню изменяется на Выйти из «имя пользователя» — нажмите на него, чтобы выйти снова. Обратите внимание, что данные входа записываются постоянным браузерным cookie, поэтому вам не придётся входить в систему каждый раз при подключении к Graphite.

Изменение параметров графиков по умолчанию

По умолчанию графики генерируются со стандартным шаблоном отображения. Если вы обнаруживаете, что применяете Параметры отображения к каждому графику, который вы создаёте, вы можете выбрать Редактировать параметры по умолчанию в меню Графики, чтобы автоматически с этим справиться. Эти параметры сохраняются с панелью инструментов и сохраняются в cookie.

Формат представляет собой набор пар ключ-значение, разделённых амперсандами, как строка запроса. Ключи и значения взяты из API-интерфейса URL-адреса отображения, и все они доступны. Например:

drawNullAsZero=true&graphOnly=true

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