Документацияbreadcrumb arrow Grafanabreadcrumb arrow Документация GlaberGraphbreadcrumb arrow Источники данныхbreadcrumb arrow Parcabreadcrumb arrow Переменные шаблонов
Последнее обновление: апреля 10, 2026

Переменные шаблонов Parca

Warning

Этот плагин устарел и будет получать только критически важные обновления безопасности. Поддержка прекратится 2 января 2027 года.

Вместо жёсткого задания значений меток в ваших запросах профилирования вы можете использовать переменные шаблонов для создания динамических, многократно используемых дашбордов. Переменные отображаются как раскрывающиеся меню в верхней части дашборда, что позволяет легко переключаться между службами, экземплярами или средами без редактирования запросов.

Введение в переменные шаблонов см. в документации Variables.

Поддерживаемые типы переменных

Тип переменной Поддерживается Примечания
Custom Да Определите статический список значений вручную.
Text box Да Введите значение в свободной форме в верхней части дашборда.
Constant Да Определите скрытое фиксированное значение.
Data source Да Выберите экземпляр источника данных по имени.
Query Нет Parca не реализует запросы переменных для динамического заполнения раскрывающихся списков.

Note

Parca не поддерживает переменные типа query. Вы не можете использовать источник данных Parca для динамического заполнения раскрывающихся списков переменных. Используйте пользовательские переменные, чтобы задавать значения вручную, или используйте другой источник данных для заполнения переменных запросов.

Использование переменных в селекторе меток

Поле селектора меток в редакторе запросов Parca поддерживает подстановку переменных шаблонов. Используйте стандартный синтаксис $variablename или ${variablename}. Переменные подставляются только в селекторе меток — раскрывающийся список типов профилей их не поддерживает.

Варианты синтаксиса переменных

Синтаксис Описание
$variablename Простой синтаксис для большинства случаев.
${variablename} Используйте, когда переменная примыкает к другому тексту (например, ${host}_suffix).
${variablename:format} Применить определённый формат к значению переменной.

Пример: фильтрация профилей по службе

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

  1. Перейдите к дашборду, который хотите обновить, и нажмите Edit.
  2. Нажмите значок Add new element (синий знак плюс).
  3. Нажмите Variable.
  4. Выберите Custom в качестве типа переменной.
  5. Введите Name, например service.
  6. Выберите опцию в раскрывающемся списке Display, чтобы управлять тем, где на дашборде отображается переменная.
  7. Нажмите Open variable editor, чтобы открыть диалоговое окно Custom options.
  8. Введите значения, разделённые запятыми, например frontend, backend, api-gateway.
  9. Нажмите Apply.
  10. Нажмите Save.
  11. (Необязательно) Введите описание внесённых изменений.
  12. Нажмите Save.
  13. Нажмите Exit edit.

В селекторе меток вашего запроса Parca ссылайтесь на переменную:

text 
{job="$service"}

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

Пример: фильтрация по службе и экземпляру

Создайте две пользовательские переменные для фильтрации по нескольким измерениям.

  1. Создайте переменную с именем service со значениями frontend, backend, api-gateway.
  2. Создайте вторую переменную с именем instance со значениями для адресов ваших экземпляров, например 10.0.0.1:7070, 10.0.0.2:7070, 10.0.0.3:7070.

В селекторе меток вашего запроса Parca ссылайтесь на обе переменные:

text 
{job="$service", instance="$instance"}

Пример: использование переменной текстового поля для фильтрации в свободной форме

Создайте переменную текстового поля для фильтрации меток в свободной форме.

  1. Перейдите к дашборду, который хотите обновить, и нажмите Edit.
  2. Нажмите значок Add new element (синий знак плюс).
  3. Нажмите Variable.
  4. Выберите Textbox в качестве типа переменной.
  5. Введите Name, например label_filter.
  6. При необходимости установите значение по умолчанию Value, например job="my-service".
  7. Нажмите Save.
  8. (Необязательно) Введите описание внесённых изменений.
  9. Нажмите Save.
  10. Нажмите Exit edit.

В селекторе меток вашего запроса Parca ссылайтесь на переменную:

text 
{$label_filter}

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

Ограничения

Поддержка переменных шаблонов в Parca имеет следующие ограничения:

  • Нет поддержки переменных типа query: Вы не можете использовать Parca в качестве источника данных для заполнения вариантов переменных. Определите значения вручную с помощью пользовательских переменных или используйте другой источник данных.
  • Только селектор меток: Переменные подставляются в поле селектора меток. Раскрывающийся список типов профилей не поддерживает переменные.
  • Нет фильтров в свободной форме: Parca не поддерживает фильтры в свободной форме.

Дальнейшие шаги