Документация Grafana Документация GlaberGraph Визуализация данных Дашборды Создание дашбордов Переменные URL дашборда

Переменные URL дашборда

Переменные в URL-адресе дашборда позволяют предоставить больше контекста при передаче ссылки на дашборд.

Например, вы можете поделиться простой ссылкой на дашборд такого вида:

Copy

https://${your-domain}/path/to/your/dashboard

Это позволит кому-то перейти к дашборду, но не предоставит никакой полезной доступной информации.

Вместо этого можно добавить переменные дашборда, передаваемые как параметры запроса в URL-адресе дашборда, чтобы получить такой URL:

Copy

https://${your-domain}/path/to/your/dashboard?var-example=value

Это позволяет добавить контекст к дашборду, когда кто-то переходит к нему.

Переменные как параметры запроса

Grafana интерпретирует параметры строки запроса с префиксом var- как переменные соответствующего дашборда.

Например:

Copy

https://${your-domain}/path/to/your/dashboard?var-example=value

В этом URL-адресе параметр запроса var-example=value представляет переменную дашборда example со значением value.

Несколько значений для переменной

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

Copy

https://${your-domain}/path/to/your/dashboard?var-example=value1&var-example=value2

Grafana интерпретирует var-example=value1&var-example=value2 как переменную дашборда example с двумя значениями: value1 и value2.

Пример

Этот дашборд в Grafana Play передаёт переменную server с несколькими значениями и переменные app и interval — по одному значению каждая.

Фильтры и измерения group by

Фильтры автоматически запрашивают у вашего источника данных доступные измерения и позволяют пользователям динамически добавлять или удалять фильтры и измерения group by на дашборде. Это позволяет быстро применять фильтры ко всем запросам метрик, использующим указанный источник данных, в масштабе всего дашборда. Функция group by затем позволяет группировать данные по ключам, разделяя их.

Дополнительные сведения см. в документации по Filter и Group by.

Чтобы передать фильтр как параметр запроса, используйте синтаксис переменной для передачи фильтра. Затем укажите ключ, оператор и значение в виде списка, разделённого вертикальными чертами.

Например:

Copy

https://${your-domain}/path/to/your/dashboard?var-filter=example_key|=|example_value

В этом URL-адресе параметр запроса var-filter=key|=|value применяет настроенный фильтр, используя ключ example_key, оператор = и значение example_value.

Пример

Этот дашборд в Grafana Play передаёт переменную фильтра Filters со значением фильтра job = metrictank/tsdb-gw.

Управление временным диапазоном с помощью URL

You can control the time range of a dashboard by providing the following query parameters in the dashboard URL:

• from - Defines the lower limit of the time range, specified in ms, epoch, or relative time.
• to - Defines the upper limit of the time range, specified in ms, epoch, or relative time.
• time and time.window - Defines a time range from time-time.window/2 to time+time.window/2. Both parameters should be specified in ms. For example ?time=1500000000000&time.window=10000 results in a 10-second time range from 1499999995000 to 1500000005000`.
• timezone - Defines the time zone. For example timezone=Europe/Madrid.

Since these aren’t variables, they don’t require the var- prefix.

The following example shows a dashboard with the time range of the last five minutes:

Copy

https://${your-domain}/path/to/your/dashboard?from=now-5m&to=now

Переменные в ссылках дашборда

При создании ссылок дашборда в настройках дашборда вы можете включить текущие переменные дашборда в ссылку, выбрав соответствующую опцию:

Шаги по добавлению переменных в ссылки дашборда см. в разделе Управление ссылками дашборда.