+++
title = "Добавить переменную запроса"
aliases = ["/docs/harvest/latest/variables/add-query-variable.md"]
weight = 100
+++

# Добавить переменную запроса

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

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

## Выражения запросов

Выражения запроса различны для каждого источника данных. Для получения дополнительной информации обратитесь к документации для вашего [источника данных]({{< relref "../../datasources/_index.md" >}}).

## Введите общие параметры

1. Перейдите к панели мониторинга, для которой вы хотите создать переменную, а затем щелкните значок ** Настройки панели мониторинга ** (шестеренка) в верхней части страницы.
1. На вкладке Переменные нажмите **Создать**.
1. Введите **Имя** для вашей переменной.
1. В списке **Тип** выберите **Запрос**.
1. (необязательно) В поле **Label** введите отображаемое имя раскрывающегося списка переменных. Если вы не введете отображаемое имя, то меткой выпадающего списка будет имя переменной.
1. Выберите опцию **Скрыть**:
   - ** Нет выбора (пусто) -** В раскрывающемся списке переменных отображается значение переменной **Name** или **Label**. Это значение по умолчанию.
   - ** Метка -** В раскрывающемся списке переменных отображается только выбранное значение переменной и стрелка вниз.
   - ** Переменная -** Выпадающий список переменных на панели инструментов не отображается.

## Введите Параметры запроса

1. В списке **Источник данных** выберите целевой источник данных для запроса. Для получения дополнительной информации об источниках данных обратитесь к [Добавить источник данных]({{< relref "../../datasources/add-a-data-source.md" >}}).
1. В списке **Обновить** выберите, когда переменная должна обновлять параметры.
   - ** Никогда -** Запросы переменных кэшируются, а значения не обновляются. Это нормально, если значения никогда не меняются, но проблематично, если они динамичны и часто меняются.
   - ** При загрузке панели мониторинга -** Запрашивает источник данных при каждой загрузке панели мониторинга. Это замедляет загрузку панели мониторинга, поскольку запрос переменной должен быть завершен до того, как панель мониторинга может быть инициализирована.
   - ** При изменении временного диапазона -** Запрашивает источник данных при изменении временного диапазона панели мониторинга. Используйте этот параметр только в том случае, если ваш запрос параметров переменной содержит фильтр временного диапазона или зависит от временного диапазона панели мониторинга.
1. В поле **Запрос** введите запрос.
   - Поле запроса варьируется в зависимости от вашего источника данных. Некоторые источники данных имеют пользовательские редакторы запросов.
   - Если вам нужно больше места в редакторе запросов с одним полем ввода, наведите курсор на строки в правом нижнем углу поля и перетащите вниз, чтобы развернуть.
1. (необязательно) В поле ** Регулярное выражение** введите выражение регулярного выражения для фильтрации или захвата определенных частей имен, возвращаемых вашим запросом источника данных. Чтобы увидеть примеры, обратитесь к [Фильтровать переменные с помощью регулярных выражений]({{< relref "../filter-variables-with-regex.md " >}}).
1. В списке **Сортировка** выберите порядок сортировки значений, которые будут отображаться в выпадающем списке. Параметр по умолчанию, **Отключен**, означает, что будет использоваться порядок параметров, возвращаемых вашим запросом источника данных.
1. (необязательно) Введите [Параметры выбора]({{< ссылка "../variable-selection-options.md " >}}).
1. (необязательно) Введите [Группы значений/теги]({{< ссылка "../variable-value-tags.md " >}}).
1. В ** Предварительный просмотр значений**, Harvest отображает список текущих значений переменных. Просмотрите их, чтобы убедиться, что они соответствуют вашим ожиданиям.
1. Нажмите **Добавить**, чтобы добавить переменную на панель мониторинга.
