Перейти к содержанию

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, и нет привязки к конкретному дашборду.

Как использовать на дашборде

  1. Открываете дашборд → Settings → Variables.
  2. Вместо создания новой переменной — Add cross-dashboard variable.
  3. Выбираете нужную переменную из списка доступных (с учётом Scope).
  4. Переменная появляется в дропдауне дашборда как обычная.

С точки зрения панелей и запросов разницы нет: ${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 — на уровне дашбордов и папок. Это разные уровни абстракции.

Далее: Типы переменных