Переход в связанную панель мониторинга

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

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

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

Настройка целевой панели мониторинга

Чтобы настроить целевую панель мониторинга:

1. В веб-интерфейсе KUMA в разделе Панели мониторинга выберите панель мониторинга и создайте глобальную переменную.

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

2. Сохраните изменения.
3. В панели мониторинга выберите существующий виджет События или нажмите на кнопку Добавить виджет и затем выберите тип виджета События.
4. На вкладке Общие укажите созданную ранее переменную:
   • В блоке параметров Доступные переменные.
   • В поле SQL-запрос. Для того чтобы SQL-запрос учитывал значение переменной, добавьте в условие WHERE функцию filter().

     Синтаксис для переменных с конкретным значением:

     filter(<название_поля_события> = $имя_переменной)

     Синтаксис для переменных с произвольным значением, которое задается вручную:

     filter(<название_поля_события> like $имя_переменной)

     Пример запроса

     Запрос с переменной $ServiceName:

     SELECT DestinationHostName AS Host, Name AS Status, Message AS Reason, ServiceName, Timestamp AS Time

     FROM events

     WHERE DeviceEventClassID = 'KLSRV_HOST_STATUS_CRITICAL' OR DeviceEventClassID = 'KLSRV_HOST_STATUS_WARNING' AND filter(ServiceName = $ServiceName)

     ORDER BY Time DESC

     LIMIT 25

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

5. Сохраните изменения.

Настройка исходной панели мониторинга

Чтобы настроить исходную панель мониторинга:

1. В веб-интерфейсе KUMA в разделе Панели мониторинга выберите панель мониторинга и создайте глобальную переменную.

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

2. Сохраните изменения.
3. В панели мониторинга выберите существующий виджет События или нажмите на кнопку Добавить виджет и затем выберите тип виджета События.
4. На вкладке Общие в блоке параметров Доступные переменные укажите созданную ранее переменную.
5. На вкладке Действия настройте следующие параметры:
   1. В разделе Сегмент графика или Элемент легенды включите параметр Переход к другой панели мониторинга.
   2. В раскрывающемся списке Панели мониторинга выберите целевую панель.
   3. В раскрывающемся списке Значение выберите переменную, значение которой будет передаваться при переходе. Это должна быть та же переменная, которую вы создали ранее.

      Выбранная переменная должна быть указана в SQL-запросе виджета целевой панели, чтобы данные на этом виджете автоматически были отфильтрованы после перехода.

6. Сохраните изменения.

Переход из исходной панели мониторинга в целевую панель мониторинга

Чтобы перейти в целевую панель мониторинга:

1. В веб-интерфейсе KUMA в разделе Панели мониторинга выберите исходную панель мониторинга.
2. Найдите виджет, в свойствах которого вы включили параметр Переход к другой панели мониторинга. Нажмите на сегмент или элемент легенды графика, для которых задано это действие.

   В новой вкладке откроется целевая панель мониторинга. При этом автоматически ко всей панели применится период исходного виджета, а выбранное значение в раскрывающемся списке Значение передастся как переменная в виджеты типа События, где эта переменная используется в SQL-запросе через функцию filter(). Графики в виджетах на другой панели перестроятся с учетом полученных параметров.

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