Ссылки
Ссылки помогают переходить к связанным дашбордам, документации и внешним системам.
Виды ссылок в Monium:
-
Быстрые ссылки — отображаются во всплывающей панели слева, которую можно открыть с любой страницы Monium, включая главную. Добавляйте сюда ссылки на часто используемые дашборды, инструкции и другие ресурсы. Набор ссылок настраивается для проекта, а сами ссылки можно группировать по папкам.
Для настройки нужна роль monium.quickLinks.editor в проекте.
-
Контекстные ссылки — настраиваются для проекта и отображаются во всплывающих подсказках графиков в обзоре метрик и на дашбордах, если метки в результате запроса соответствуют условиям ссылки. Ведут на дашборд текущего проекта, другую страницу Monium или во внешнюю систему. Например, из метрики CPU можно открыть дашборд конкретного хоста. Значения меток можно передать в параметрах ссылки, а временной интервал графика — во внешней ссылке.
Для настройки нужны разрешения роли monium.contextLinks.editor в проекте.
-
Ссылки дашборда и виджета — ведут на другие дашборды или внешние ресурсы, например подробные графики или инструкции по диагностике. Ссылки дашборда отображаются над виджетами и могут объединяться в группы. Ссылки виджета доступны из меню отдельного графика и позволяют открыть целевой дашборд за тот же период, что и график.
Для настройки нужны разрешения роли monium.dashboards.editor в проекте.
Настроить быстрые ссылки
- Откройте Monium
и выберите проект в верхней панели. - В меню слева выберите Быстрые ссылки и нажмите
. - Нажмите
и выберите Добавить папку или Добавить ссылку. - Введите Название и Адрес ссылки.
- При необходимости, ссылки и папки можно изменить или удалить.
- Нажмите Сохранить.
Настроить контекстную ссылку
- Откройте Monium
и выберите проект в верхней панели. - В меню слева выберите Настройки → Контекстные ссылки.
- Нажмите Создать контекстную ссылку.
- Укажите Название ссылки, например
Открыть дашборд хоста. - В поле Тип контекстной ссылки выберите Ссылка на дашборд или Внешняя ссылка и укажите целевой дашборд или URL. При необходимости настройте передачу параметров.
- При необходимости задайте условия по меткам в поле Условия отображения контекстной ссылки.
- Нажмите Создать. В списке контекстных ссылок проверьте, что для нее включен переключатель Отображать ссылку.
Чтобы проверить ссылку, откройте график с подходящими метками и найдите ее во всплывающей подсказке. Если ссылка не отображается, проверьте метки в результате запроса и переключатель Отображать ссылку.
Условия отображения
Условия определяют, для каких метрик показывать ссылку. Если оставить поле пустым, ссылка будет отображаться всегда. Чтобы ограничить ее отображение, укажите условие на наличие метки или ее значение в результате запроса:
{host="*"}— ссылка отображается для метрик с меткойhostс любым значением.{service="alerting", host="*vla*"}— ссылка отображается для метрик, у которых значение меткиserviceравноalerting, а значение меткиhostсодержитvla.
Параметры ссылки
Параметры могут иметь статические значения, например production, или подставляться из меток результата запроса. Для подстановки укажите имя метки в двойных фигурных скобках: {{host}} или {{cluster}}. Значение будет взято из текущего запроса в момент перехода.
Например, чтобы целевой дашборд открылся с данными выбранного хоста, задайте его параметру host значение {{host}} и добавьте условие отображения {host="*"}.
Типы контекстных ссылок
Ссылка на дашборд
В поле Дашборд выберите дашборд в текущем проекте. Если он использует параметры, задайте их значения в блоке ниже. Если отображается сообщение В дашборде нет параметров, настраивать передачу значений не нужно.
Внешняя ссылка
В поле Ссылка для перехода укажите URL. Он может вести на страницу сервиса, репозиторий, тикет или другую систему анализа данных. Например, https://example.com/hosts/{{host}} откроет страницу хоста из метки host.
Для перехода внутри Monium можно указать относительный адрес. Например, projects/test/dashboards ведет на https://monium.yandex.cloud/projects/test/dashboards.
Чтобы передать временной интервал графика, используйте not_var{{__from:<формат>}} для его начала и not_var{{__to:<формат>}} для конца. Доступны следующие форматы:
|
Формат |
Описание |
|
|
Дата и время в формате ISO 8601, например |
|
|
Число секунд от начала эпохи Unix. |
|
|
Число миллисекунд от начала эпохи Unix. |
Например, https://example.com/logs?host={{host}}&from=not_var{{__from:iso}}&to=not_var{{__to:iso}} откроет логи выбранного хоста за интервал графика.
Добавить ссылку на дашборд или в виджет
-
Откройте Monium
, выберите проект и нужный дашборд в разделе Дашборды. -
Откройте настройки ссылок:
- На дашборде — в правом верхнем углу нажмите
и выберите Ссылки. - В виджете — в меню
нужного графика выберите Редактировать. В правом верхнем углу панели графика нажмите Настройки и откройте раздел Ссылки.
- На дашборде — в правом верхнем углу нажмите
-
Нажмите Добавить ссылку и укажите заголовок ссылки.
Для ссылки на дашборде при необходимости выберите Группу или нажмите Создать новую группу.
-
Выберите тип ссылки:
- Внешняя ссылка — укажите URL внешнего ресурса.
- Дашборд — выберите целевой дашборд. Для ссылки в виджете можно включить Передавать временной интервал, чтобы открыть его за тот же период, что и график.
-
Укажите, нужно ли Открывать в новом окне. Для ссылки на дашборде нажмите Добавить, для ссылки в виджете — сохраните настройки ссылки.
-
Закройте окно ссылок или настройки графика и сохраните дашборд кнопкой
в правом верхнем углу.
Чтобы изменить или удалить ссылку над виджетами дашборда, откройте окно Ссылки в настройках дашборда и воспользуйтесь меню