az monitor scheduled-query

Note

Эта ссылка является частью расширения scheduled-query для Azure CLI (версия 2.54.0 или более поздней). Расширение будет автоматически устанавливаться при первом запуске команды az monitor scheduled-query. Подробнее о расширениях.

Команды для управления запланированными запросами.

Команды

Имя	Описание	Тип	Состояние
az monitor scheduled-query create	Создайте запланированный запрос.	Extension	GA
az monitor scheduled-query delete	Удаление запланированного запроса.	Extension	GA
az monitor scheduled-query list	Список всех запланированных запросов.	Extension	GA
az monitor scheduled-query show	Отображение сведений о запланированном запросе.	Extension	GA
az monitor scheduled-query update	Обновите запланированный запрос.	Extension	GA

az monitor scheduled-query create

Создайте запланированный запрос.

az monitor scheduled-query create --condition
                                  --name
                                  --resource-group
                                  --scopes
                                  [--acquire-policy-token]
                                  [--action-groups]
                                  [--auto-mitigate {false, true}]
                                  [--change-reference]
                                  [--check-ws-alerts-storage --cwas {false, true}]
                                  [--condition-query]
                                  [--custom-properties]
                                  [--description]
                                  [--disabled {false, true}]
                                  [--evaluation-frequency]
                                  [--location]
                                  [--mad --mute-actions-duration]
                                  [--severity]
                                  [--skip-query-validation {false, true}]
                                  [--tags]
                                  [--target-resource-type --type]
                                  [--window-size]

Примеры

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

az monitor scheduled-query create -g {rg} -n {name1} --scopes {vm_id} --condition "count 'Placeholder_1' > 360 resource id _ResourceId at least 1 violations out of 5 aggregated points" --condition-query Placeholder_1="union Event, Syslog | where TimeGenerated > ago(1h) | where EventLevelName=='Error' or SeverityLevel=='err'" --description "Test rule"

Создайте запланированный запрос для виртуальных машин в группе ресурсов.

az monitor scheduled-query create -g {rg} -n {name1} --scopes {rg_id} --condition "count 'Placeholder_1' > 360 resource id _ResourceId at least 1 violations out of 5 aggregated points" --condition-query Placeholder_1="union Event, Syslog | where TimeGenerated > ago(1h) | where EventLevelName=='Error' or SeverityLevel=='err'" --description "Test rule"

Обязательные параметры

--condition

Условие, которое активирует правило.

Использование: --condition {avg,min,max,total,count} ["METRIC COLUMN" from] "QUERY_PLACEHOLDER" {=,!=,>,>=,<,<=} ПОРОГ [идентификатор ресурса] [where dimension {includes,excludes} VALUE [or VALUE ...] [и ИЗМЕРЕНИЕ {включает,исключает} ЗНАЧЕНИЕ [или ЗНАЧЕНИЕ ...] ...]] [По крайней мере нарушения MinTimeToFail из агрегированных точек оценки]' Заполнители запросов можно определить в измерениях аргумента --condition-query, добавив ключевое слово where и несколько измерений, можно запросить, объединив их с ключевым словом "и".

--name -n

Имя правила запланированного запроса.

--resource-group -g

Имя группы ресурсов. Группу по умолчанию можно настроить с помощью az configure --defaults group=<name>.

--scopes

Разделенный пробелами список областей, к которые применяется правило. Ресурсы, указанные в этом параметре, должны иметь одинаковый тип и существовать в том же расположении.

Необязательные параметры

Следующие параметры являются необязательными, но в зависимости от контекста один или несколько могут потребоваться для успешного выполнения команды.

--acquire-policy-token

Автоматическое получение маркера Политика Azure для этой операции ресурса.

Свойство	Значение
Группа параметров:	Global Policy Arguments

--action-groups

Идентификаторы ресурсов группы действий для вызова при срабатывании оповещения.

Использование: --action-groups ACTION_GROUP_NAME_OR_ID [NAME_OR_ID,...].

--auto-mitigate

Флаг, указывающий, следует ли автоматически разрешать оповещение. Значение по умолчанию — true.

Свойство	Значение
Default value:	True
Допустимые значения:	false, true

--change-reference

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

Свойство	Значение
Группа параметров:	Global Policy Arguments

--check-ws-alerts-storage --cwas

Флаг, указывающий, следует ли хранить это правило запланированного запроса в хранилище клиента.

Свойство	Значение
Default value:	False
Допустимые значения:	false, true

--condition-query

Запрос отложений для замены заполнителей в аргументе --condition.

--custom-properties

Свойства полезных данных оповещения.

Использование: --custom-properties ALERT_PAYLOAD_PROPERTIES [KEY=VAL,KEY=VAL ...].

--description

Описание правила в свободном тексте.

--disabled

Отключите запланированный запрос.

Свойство	Значение
Default value:	False
Допустимые значения:	false, true

--evaluation-frequency

Частота вычисления правила в формате "##h##m##s".

Свойство	Значение
Default value:	5m

--location -l

Location. Значения из az account list-locations. Расположение по умолчанию можно настроить с помощью az configure --defaults location=<location>.

--mad --mute-actions-duration

Отключение действий в течение выбранного периода времени (в формате длительности ISO 8601) после запуска оповещения.

--severity

Серьезность оповещения от 0 (критического) до 4 (подробно).

Свойство	Значение
Default value:	2

--skip-query-validation

Флаг, указывающий, следует ли проверять предоставленный запрос.

Свойство	Значение
Default value:	False
Допустимые значения:	false, true

--tags

Теги, разделенные пробелами: key[=value] [key[=value] ...]. Используйте "" для очистки существующих тегов.

--target-resource-type --type

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

--window-size

Время агрегирования метрик в формате ##h##m##s.

Свойство	Значение
Default value:	5m

Глобальные параметры

--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

Свойство	Значение
Default value:	False

--help -h

Показать это сообщение справки и выйти.

--only-show-errors

Отображать только ошибки, не показывая предупреждения.

Свойство	Значение
Default value:	False

--output -o

Формат вывода.

Свойство	Значение
Default value:	json
Допустимые значения:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

Свойство	Значение
Default value:	False

az monitor scheduled-query delete

Удаление запланированного запроса.

az monitor scheduled-query delete [--acquire-policy-token]
                                  [--change-reference]
                                  [--ids]
                                  [--name]
                                  [--resource-group]
                                  [--subscription]
                                  [--yes]

Необязательные параметры

Следующие параметры являются необязательными, но в зависимости от контекста один или несколько могут потребоваться для успешного выполнения команды.

--acquire-policy-token

Автоматическое получение маркера Политика Azure для этой операции ресурса.

Свойство	Значение
Группа параметров:	Global Policy Arguments

--change-reference

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

Свойство	Значение
Группа параметров:	Global Policy Arguments

--ids

Один или несколько идентификаторов ресурсов (разделенных пробелами). Это должен быть полный идентификатор ресурса, содержащий все сведения о аргументах Resource Id. Необходимо указать аргументы --ids или другие параметры 'Resource Id'.

Свойство	Значение
Группа параметров:	Resource Id Arguments

--name -n

Имя правила запланированного запроса.

Свойство	Значение
Группа параметров:	Resource Id Arguments

--resource-group -g

Имя группы ресурсов. Группу по умолчанию можно настроить с помощью az configure --defaults group=<name>.

Свойство	Значение
Группа параметров:	Resource Id Arguments

--subscription

Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

Свойство	Значение
Группа параметров:	Resource Id Arguments

--yes -y

Не запрашивать подтверждение.

Свойство	Значение
Default value:	False

Глобальные параметры

--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

Свойство	Значение
Default value:	False

--help -h

Показать это сообщение справки и выйти.

--only-show-errors

Отображать только ошибки, не показывая предупреждения.

Свойство	Значение
Default value:	False

--output -o

Формат вывода.

Свойство	Значение
Default value:	json
Допустимые значения:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--verbose

Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

Свойство	Значение
Default value:	False

az monitor scheduled-query list

Список всех запланированных запросов.

az monitor scheduled-query list [--resource-group]

Необязательные параметры

Следующие параметры являются необязательными, но в зависимости от контекста один или несколько могут потребоваться для успешного выполнения команды.

--resource-group -g

Имя группы ресурсов. Группу по умолчанию можно настроить с помощью az configure --defaults group=<name>.

Глобальные параметры

--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

Свойство	Значение
Default value:	False

--help -h

Показать это сообщение справки и выйти.

--only-show-errors

Отображать только ошибки, не показывая предупреждения.

Свойство	Значение
Default value:	False

--output -o

Формат вывода.

Свойство	Значение
Default value:	json
Допустимые значения:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

Свойство	Значение
Default value:	False

az monitor scheduled-query show

Отображение сведений о запланированном запросе.

az monitor scheduled-query show [--ids]
                                [--name]
                                [--resource-group]
                                [--subscription]

Необязательные параметры

Следующие параметры являются необязательными, но в зависимости от контекста один или несколько могут потребоваться для успешного выполнения команды.

--ids

Один или несколько идентификаторов ресурсов (разделенных пробелами). Это должен быть полный идентификатор ресурса, содержащий все сведения о аргументах Resource Id. Необходимо указать аргументы --ids или другие параметры 'Resource Id'.

Свойство	Значение
Группа параметров:	Resource Id Arguments

--name -n

Имя правила запланированного запроса.

Свойство	Значение
Группа параметров:	Resource Id Arguments

--resource-group -g

Имя группы ресурсов. Группу по умолчанию можно настроить с помощью az configure --defaults group=<name>.

Свойство	Значение
Группа параметров:	Resource Id Arguments

--subscription

Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

Свойство	Значение
Группа параметров:	Resource Id Arguments

Глобальные параметры

--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

Свойство	Значение
Default value:	False

--help -h

Показать это сообщение справки и выйти.

--only-show-errors

Отображать только ошибки, не показывая предупреждения.

Свойство	Значение
Default value:	False

--output -o

Формат вывода.

Свойство	Значение
Default value:	json
Допустимые значения:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--verbose

Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

Свойство	Значение
Default value:	False

az monitor scheduled-query update

Обновите запланированный запрос.

az monitor scheduled-query update [--acquire-policy-token]
                                  [--action-groups]
                                  [--add]
                                  [--auto-mitigate {false, true}]
                                  [--change-reference]
                                  [--check-ws-alerts-storage --cwas {false, true}]
                                  [--condition]
                                  [--condition-query]
                                  [--custom-properties]
                                  [--description]
                                  [--disabled {false, true}]
                                  [--evaluation-frequency]
                                  [--force-string]
                                  [--ids]
                                  [--mad --mute-actions-duration]
                                  [--name]
                                  [--remove]
                                  [--resource-group]
                                  [--set]
                                  [--severity]
                                  [--skip-query-validation {false, true}]
                                  [--subscription]
                                  [--tags]
                                  [--target-resource-type --type]
                                  [--window-size]

Необязательные параметры

Следующие параметры являются необязательными, но в зависимости от контекста один или несколько могут потребоваться для успешного выполнения команды.

--acquire-policy-token

Автоматическое получение маркера Политика Azure для этой операции ресурса.

Свойство	Значение
Группа параметров:	Global Policy Arguments

--action-groups

Идентификаторы ресурсов группы действий для вызова при срабатывании оповещения.

--add

Добавьте объект в список объектов, указав пары пути и значения ключа. Пример: --add property.listProperty <key=value, string or JSON string>.

Свойство	Значение
Группа параметров:	Generic Update Arguments
Default value:	[]

--auto-mitigate

Флаг, указывающий, следует ли автоматически разрешать оповещение. Значение по умолчанию — true.

Свойство	Значение
Допустимые значения:	false, true

--change-reference

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

Свойство	Значение
Группа параметров:	Global Policy Arguments

--check-ws-alerts-storage --cwas

Флаг, указывающий, следует ли хранить это правило запланированного запроса в хранилище клиента.

Свойство	Значение
Допустимые значения:	false, true

--condition

Условие, которое активирует правило.

Использование: --condition {avg,min,max,total,count} ["METRIC COLUMN" from] "QUERY_PLACEHOLDER" {=,!=,>,>=,<,<=} ПОРОГ [идентификатор ресурса] [where dimension {includes,excludes} VALUE [or VALUE ...] [и ИЗМЕРЕНИЕ {включает,исключает} ЗНАЧЕНИЕ [или ЗНАЧЕНИЕ ...] ...]] [по крайней мере нарушения MinTimeToFail из агрегированных точек ОценкиPeriod]'

Заполнители запросов можно определить в аргументе --condition-query Dimensions, добавив ключевое слово where и несколько измерений, можно запросить, комбинируя их с ключевым словом "and".

--condition-query

Запрос отложений для замены заполнителей в аргументе --condition.

--custom-properties

Свойства полезных данных оповещения.

Использование: --custom-properties ALERT_PAYLOAD_PROPERTIES [KEY=VAL,KEY=VAL ...].

--description

Описание правила в свободном тексте.

--disabled

Отключите запланированный запрос.

Свойство	Значение
Допустимые значения:	false, true

--evaluation-frequency

Частота вычисления правила в формате "##h##m##s".

--force-string

При использовании "set" или "add" сохраняйте строковые литералы вместо попытки преобразовать в JSON.

Свойство	Значение
Группа параметров:	Generic Update Arguments
Default value:	False

--ids

Один или несколько идентификаторов ресурсов (разделенных пробелами). Это должен быть полный идентификатор ресурса, содержащий все сведения о аргументах Resource Id. Необходимо указать аргументы --ids или другие параметры 'Resource Id'.

Свойство	Значение
Группа параметров:	Resource Id Arguments

--mad --mute-actions-duration

Отключение действий в течение выбранного периода времени (в формате длительности ISO 8601) после запуска оповещения.

--name -n

Имя правила запланированного запроса.

Свойство	Значение
Группа параметров:	Resource Id Arguments

--remove

Удалите свойство или элемент из списка. Пример: --remove property.list <indexToRemove> OR --remove propertyToRemove.

Свойство	Значение
Группа параметров:	Generic Update Arguments
Default value:	[]

--resource-group -g

Имя группы ресурсов. Группу по умолчанию можно настроить с помощью az configure --defaults group=<name>.

Свойство	Значение
Группа параметров:	Resource Id Arguments

--set

Обновите объект, указав путь к свойству и значение для задания. Пример: --set property1.property2=<value>.

Свойство	Значение
Группа параметров:	Generic Update Arguments
Default value:	[]

--severity

Серьезность оповещения от 0 (критического) до 4 (подробно).

--skip-query-validation

Флаг, указывающий, следует ли проверять предоставленный запрос.

Свойство	Значение
Допустимые значения:	false, true

--subscription

Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

Свойство	Значение
Группа параметров:	Resource Id Arguments

--tags

Теги, разделенные пробелами: key[=value] [key[=value] ...]. Используйте "" для очистки существующих тегов.

--target-resource-type --type

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

--window-size

Время агрегирования метрик в формате ##h##m##s.

Глобальные параметры

--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

Свойство	Значение
Default value:	False

--help -h

Показать это сообщение справки и выйти.

--only-show-errors

Отображать только ошибки, не показывая предупреждения.

Свойство	Значение
Default value:	False

--output -o

Формат вывода.

Свойство	Значение
Default value:	json
Допустимые значения:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--verbose

Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

Свойство	Значение
Default value:	False