# Создание переменных и функций в Dashboards

<p class="callout warning">**При дальнейшей настройке переменных используйте для них только уникальные значения (имена) для избежать дублирования, пересечения и конфликтов зависимостей**</p>

**Вы можете применять фильтрацию в случаях**

· Фильтрация данных на одном виджете (Использование локальных переменных)

· Фильтрация данных на нескольких виджетах в рамках одной панели мониторинга (Использование глобальных переменных)

#### **Для локальных переменных:**

В редактировании виджета раскройте меню доступных переменных

[![image.png](https://kb.kuma-community.ru/uploads/images/gallery/2025-10/scaled-1680-/Coyimage.png)](https://kb.kuma-community.ru/uploads/images/gallery/2025-10/Coyimage.png)

Добавьте свою переменную, а в поле “название” вы можете поставить: категорию или значение или оставить пустым, чтобы в режиме просмотра панели мониторинга задавать значения.

Далее, в поле SQL-запрос в оператор WHERE добавьте функцию для работы с переменными.

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

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

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

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

**например**

`<span lang="EN-US"> SELECT count(ID) AS `metric` FROM `events` WHERE  DeviceAction = 'user login' and EventOutcome = 'succeeded' and filter(SourceUserName = $SourceName)</span>`

В примере локальная переменная <span lang="EN-US">SourceName</span>, которая применяется в поле события <span lang="EN-US">SourceName. </span>Далее сохраняем.

В режиме просмотра панели мониторинга в меню виджета нажмите на иконку фильтра

[![image.png](https://kb.kuma-community.ru/uploads/images/gallery/2025-10/scaled-1680-/tcbimage.png)](https://kb.kuma-community.ru/uploads/images/gallery/2025-10/tcbimage.png)

В пустом поле укажите значение для переменной , далее нажмите кнопку “применить

Информация на дашборде автоматически обновляется. В данном случае видим сколько раз за последнюю неделю заходил пользователь в систему под учетной записью администратора

[![image.png](https://kb.kuma-community.ru/uploads/images/gallery/2025-10/scaled-1680-/qQMimage.png)](https://kb.kuma-community.ru/uploads/images/gallery/2025-10/qQMimage.png)

#### **Для глобальных переменных:**

Необходимо перейти в редактирование панели мониторинга, далее “Настройки” для создания переменной

[![image.png](https://kb.kuma-community.ru/uploads/images/gallery/2025-10/scaled-1680-/uaWimage.png)](https://kb.kuma-community.ru/uploads/images/gallery/2025-10/uaWimage.png)

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

[![image.png](https://kb.kuma-community.ru/uploads/images/gallery/2025-10/scaled-1680-/sFpimage.png)](https://kb.kuma-community.ru/uploads/images/gallery/2025-10/sFpimage.png)

Добавьте свою переменную. Значения локальных и глобальных должны быть уникальными. Далее кнопка “Применить ”

Чтобы подключить глобальную переменную, перейдите в Редактирование виджета, Доступные переменные и выберите нужную, из списка созданных

[![image.png](https://kb.kuma-community.ru/uploads/images/gallery/2025-10/scaled-1680-/bFOimage.png)](https://kb.kuma-community.ru/uploads/images/gallery/2025-10/bFOimage.png)

Аналогично запросу с локальными переменными, воспользуйтесь функцией <span lang="EN-US">filter</span>(). В аргументе укажите нужное поле и присвойте ему значение переменной. **Например**<span lang="EN-US">,</span>

`<span lang="EN-US">SELECT count(ID) AS `metric` FROM `events` WHERE  DeviceAction = 'user login' and EventOutcome = 'succeeded' and filter(SourceUserName = $test)</span>`

Глобальная переменная <span lang="EN-US">test</span> применяется к полю события <span lang="EN-US">SourceName</span>. Сохраните изменения

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

[![image.png](https://kb.kuma-community.ru/uploads/images/gallery/2025-10/scaled-1680-/Mwoimage.png)](https://kb.kuma-community.ru/uploads/images/gallery/2025-10/Mwoimage.png)

[![image.png](https://kb.kuma-community.ru/uploads/images/gallery/2025-10/scaled-1680-/djZimage.png)](https://kb.kuma-community.ru/uploads/images/gallery/2025-10/djZimage.png)

`<span lang="EN-US">SELECT count(ID) AS `metric`, SourceUserName AS `value` FROM `events` WHERE Type = 4 AND DeviceAction = 'user login' and EventOutcome = 'succeeded' GROUP BY SourceUserName ORDER BY `metric` DESC LIMIT 250</span>`

Далее перейдите к параметру “Действия” внутри редактирования виджета

[![image.png](https://kb.kuma-community.ru/uploads/images/gallery/2025-10/scaled-1680-/yZZimage.png)](https://kb.kuma-community.ru/uploads/images/gallery/2025-10/yZZimage.png)

 Вы можете настроить дальнейшие действия, как для взаимодействия с графиком, так и легендой

[![image.png](https://kb.kuma-community.ru/uploads/images/gallery/2025-10/scaled-1680-/5y9image.png)](https://kb.kuma-community.ru/uploads/images/gallery/2025-10/5y9image.png)

Для применения фильтра выберите параметр “Фильтровать по переменной”. Сохраните виджет и панель мониторинга.

В режиме просмотра панели мониторинга нажмите на легенду/график в виджете Перейдите в события, если хотите посмотреть входы пользователя <span lang="EN-US">admin</span> в систему за последнюю неделю в событиях

[![image.png](https://kb.kuma-community.ru/uploads/images/gallery/2025-10/scaled-1680-/rRVimage.png)](https://kb.kuma-community.ru/uploads/images/gallery/2025-10/rRVimage.png)

[![image.png](https://kb.kuma-community.ru/uploads/images/gallery/2025-10/scaled-1680-/A1jimage.png)](https://kb.kuma-community.ru/uploads/images/gallery/2025-10/A1jimage.png)

Или второй пункт, чтобы привязаться к переменной, станет <span lang="EN-US">test</span>=<span lang="EN-US">admin</span>

[![image.png](https://kb.kuma-community.ru/uploads/images/gallery/2025-10/scaled-1680-/Qfcimage.png)](https://kb.kuma-community.ru/uploads/images/gallery/2025-10/Qfcimage.png)

Далее на панели мониторинга вы увидите появление глобального фильтра

[![image.png](https://kb.kuma-community.ru/uploads/images/gallery/2025-10/scaled-1680-/pgmimage.png)](https://kb.kuma-community.ru/uploads/images/gallery/2025-10/pgmimage.png)

И автоматически все виджеты с привязкой к глобальной переменной адаптируют значения, видим сколько раз <span lang="EN-US">admin</span> зашел в систему за неделю, также на виджетах появится значок фильтра.

Нажмите на него, чтобы увидеть более подробную информацию о фильтре

[![image.png](https://kb.kuma-community.ru/uploads/images/gallery/2025-10/scaled-1680-/GEiimage.png)](https://kb.kuma-community.ru/uploads/images/gallery/2025-10/GEiimage.png)

Чтобы проверить, к каким виджетам применяется фильтр, повторите шаги из пункта создания глобальных переменных, проверьте параметр “Используется в виджетах”

[![image.png](https://kb.kuma-community.ru/uploads/images/gallery/2025-10/scaled-1680-/Ofqimage.png)](https://kb.kuma-community.ru/uploads/images/gallery/2025-10/Ofqimage.png)