Настройка переменных

Можно настраивать переменные, которые будут выступать в качестве фильтров на пользовательском дашборде.

Переход к просмотру и настройке переменных

Перейти к списку переменных:

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

В списке, в строке выбранного пользовательского дашборда, нажмите и выберите Редактировать.

В режиме редактирования перейдите на вкладку Переменные.

через карточку пользовательского дашборда

В карточке пользовательского дашборда, в верхнем правом углу, нажмите и выберите Редактировать.

В режиме редактирования перейдите на вкладку Переменные.

Откроется список, содержащий название и описание созданных переменных.

Примечание

Если для дашборда еще не создано ни одной переменной, то список будет пустым.

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

Изменение позиции переменной

Последовательность переменных на странице дашборда зависит от их расположения в общем списке. Переменная, расположенная первой в таблице, будет отображаться первой на странице дашборда (расположение переменных слева направо).

Для изменения позиции переменной:

нажмите и передвиньте переменную вниз в таблице. Выбранная запись сдвинется на одну позицию вправо на странице дашборда. Для нижней в списке переменной эта опция недоступна.
нажмите и передвиньте переменную вверх в таблице. Выбранная запись сдвинется на одну позицию влево на странице дашборда. Для верхней в списке переменной эта опция недоступна.

Создание переменной

Создать переменную можно с нуля или путем копирования параметров существующей переменной.

В списке переменных нажмите Создать переменную или нажмите Создать, если для этого дашборда еще не созданы переменные.
Задайте параметры новой записи:
- Название и описание переменной.
Важно

Одна переменная может зависеть от другой.

В этом случае название главной переменной должно присутствовать в фильтре запроса или запроса с металейблом зависимой переменной.
- В поле Показать на дашборде с помощью переключателя выберите, отображать фильтр переменной на дашборде или нет. Даже если переменной нет на странице дашборда, она все равно используется в запросах для отображения данных на виджетах.
- В поле Множественный выбор с помощью переключателя выберите, можно ли на странице дашборда одновременно выбирать несколько значений переменной.
- Поле Кастомизировать опцию «Все» появляется только после активации параметра Множественный выбор. Если кастомизация опции выключена, то в запросы метрик для виджетов передаются все значения переменной с разделителем | между значениями.
- Выберите тип переменной:
  
  Список
  
  В этом случае заданный список значений переменной будет показан на странице дашборда в выпадающем списке фильтра.
  
  После выбора типа Список укажите значение переменной.
  
  Чтобы добавить еще одно значение, внизу экрана нажмите Добавить.
  
  Чтобы удалить поле со значением, нажмите .
  
  Запрос
  Список значений переменной, который будет показан на странице дашборда, сформируется с помощью запроса. После выбора типа Запрос укажите:
  
  наименование лейбла, значения которого нужно получить и показать в выпадающем списке в фильтре переменной на дашборде;
  
  фильтр в формате prometheus time series selectors для уточнения области меток временного ряда, из которых необходимо получить значения лейбла, указанного в поле Лейбл.
  Запрос с металейблом
  Список значений переменной, который будет показан на странице дашборда, сформируется с помощью запроса с использованием металейбла.
  
  После выбора типа Запрос с металейблом укажите:
  
  наименование лейбла, значения которого используются в запросах для получения значений металейбла;
  
  металейбл, значения которого нужно получить и показать в выпадающем списке в фильтре переменной на дашборде;
  
  фильтр в формате prometheus time series selectors для уточнения области меток временного ряда, из которых необходимо получить значения лейбла, указанного в поле Лейбл.

Редактирование переменной

В списке переменных нажмите на название нужной записи.
В открывшейся карточке переменной внесите изменения.

Важно

Все обязательные поля должны быть заполнены.

У переменной должно быть уникальное название в рамках выбранного дашборда.
Нажмите Сохранить изменения.

Запуск запроса

В процессе создания новой переменной и при редактировании существующей можно запустить запрос, нажав Запустить запрос.

Список значений с учетом параметров переменной отобразится в блоке Предпросмотр значений под всеми параметрами переменной.

Удаление переменной

В общем списке, в строке нужной переменной, нажмите и выберите Удалить.
Чтобы подтвердить операцию, нажмите Удалить.

Подсказка

Удалить запись можно из карточки переменной: нажмите Прикрепить файл и выберите Удалить.