Cross-dashboard variables (появилось в 13.3.0)¶
До версии 13.3 переменные жили внутри одного дашборда. Если десяти дашбордам нужна была одна и та же переменная $environment, её приходилось создавать в каждом дашборде отдельно. Десять раз. А потом ещё десять раз — когда список окружений менялся.
Cross-dashboard variables решают эту проблему: переменная создаётся один раз и становится доступной на всех дашбордах организации.
Два уровня видимости¶
При создании переменной выбирается Scope:
- Global — переменная доступна во всех дашбордах организации. Подходит для переменных, которые нужны везде:
$environment,$datacenter,$region. - Folder — переменная доступна только в дашбордах конкретной папки. Например, в папке «Production Dashboards» — переменная
$production_service, которой нет в папке «Staging».
Переменные Folder переопределяют Global с тем же именем. Если есть глобальная $environment и в папке «Staging» создана своя $environment — в дашбордах этой папки будет использоваться локальная.
Как создать¶
Dashboards → Variables (новый пункт в боковом меню) → Create variable.
Интерфейс создания полностью повторяет обычный редактор переменных внутри дашборда: те же 7 типов (Custom, Query, Data source, Interval, Constant, Text box, Ad hoc), та же настройка Multi-value, та же фильтрация.
Отличие — в конце выбирается Scope, и нет привязки к конкретному дашборду.
Как использовать на дашборде¶
- Открываете дашборд → Settings → Variables.
- Вместо создания новой переменной — Add cross-dashboard variable.
- Выбираете нужную переменную из списка доступных (с учётом Scope).
- Переменная появляется в дропдауне дашборда как обычная.
С точки зрения панелей и запросов разницы нет: ${environment} работает как и раньше. Панель не знает, глобальная переменная или локальная.
Когда это нужно¶
- Единый список окружений во всей организации. Создали
$environmentодин раз, и на 50 дашбордах — один и тот же список dev/staging/prod. - Разделение data source по окружениям. В папке «Production» —
$datasourceуказывает на production-Prometheus, в папке «Staging» — на staging-Prometheus. - Быстрая смена контекста. Изменили список серверов в глобальной переменной — и все дашборды подхватили изменение без ручного редактирования каждого.
Подводные камни¶
- Folder-переменные не мигрируют при переносе дашборда. Если дашборд переместили в другую папку, его Folder-переменные могут исчезнуть — они привязаны к исходной папке. Используйте Global для действительно универсальных переменных.
- Конфликт имён. Если в папке и глобально есть переменная с одинаковым именем — приоритет у Folder. Учитывайте это при именовании.
- Не заменяет section-level variables. Section-level переменные (из главы про Dynamic Dashboards) действуют в пределах одного row/tab. Cross-dashboard — на уровне дашбордов и папок. Это разные уровни абстракции.
Далее: Типы переменных