다음을 통해 공유

az monitor scheduled-query

  • 참조

참고 항목

이 참조는 Azure CLI(버전 2.54.0 이상)에 대한 예약된 쿼리 확장의 일부입니다. az monitor scheduled-query 명령을 처음 실행할 때 확장이 자동으로 설치됩니다. 확장 프로그램에 대해 자세히 알아보세요.

예약된 쿼리를 관리하는 명령입니다.

명령

Name Description 형식 상태
az monitor scheduled-query create

예약된 쿼리를 만듭니다.

 내선 번호 GA
az monitor scheduled-query delete

예약된 쿼리를 삭제합니다.

 내선 번호 GA
az monitor scheduled-query list

예약된 모든 쿼리를 나열합니다.

 내선 번호 GA
az monitor scheduled-query show

예약된 쿼리의 세부 정보를 표시합니다.

 내선 번호 GA
az monitor scheduled-query update

예약된 쿼리를 업데이트합니다.

 내선 번호 GA

az monitor scheduled-query create

예약된 쿼리를 만듭니다.

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

예제

VM에 대한 예약된 쿼리를 만듭니다.

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"

리소스 그룹에서 VM에 대한 예약된 쿼리를 만듭니다.

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" {=,!=,,>,>,,<<=} THRESHOLD [resource id RESOURCEID] [where DIMENSION {includes,excludes} VALUE [또는 VALUE ...] [and DIMENSION {includes,excludes} VALUE [또는 VALUE ...] ...]] [EvaluationPeriod 집계된 지점에서 최소 MinTimeToFail 위반]' 쿼리 자리 표시자는 'where' 키워드(keyword) 추가하여 쿼리할 수 있는 --condition-query 인수 차원에 정의할 수 있으며 여러 차원을 'and' 키워드(keyword) 결합하여 쿼리할 수 있습니다.

--name -n

예약된 쿼리 규칙의 이름입니다.

--resource-group -g

리소스 그룹의 이름입니다. az configure --defaults group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.

--scopes

규칙이 적용되는 범위의 공백으로 구분된 목록입니다. 이 매개 변수에 지정된 리소스는 동일한 형식이어야 하며 동일한 위치에 있어야 합니다.

선택적 매개 변수

--action-groups

경고가 발생할 때 호출할 작업 그룹 리소스 ID입니다.

사용: --action-groups ACTION_GROUP_NAME_OR_ID [NAME_OR_ID,...].

--auto-mitigate

경고를 자동으로 해결해야 하는지 여부를 나타내는 플래그입니다. 기본값은 true입니다.

허용되는 값: false, true
Default value: True
--check-ws-alerts-storage --cwas

이 예약된 쿼리 규칙을 고객의 스토리지에 저장해야 하는지 여부를 나타내는 플래그입니다.

허용되는 값: false, true
Default value: False
--condition-query

인수의 자리 표시자를 바꾸려면 deteil을 쿼리합니다 --condition .

--custom-properties

경고 페이로드의 속성입니다.

사용법: --custom-properties ALERT_PAYLOAD_PROPERTIES [KEY=VAL,KEY=VAL ...].

--description

규칙에 대한 자유 텍스트 설명입니다.

--disabled

예약된 쿼리를 사용하지 않도록 설정합니다.

허용되는 값: false, true
Default value: False
--evaluation-frequency

"##h##m##s" 형식으로 규칙을 평가할 빈도입니다.

Default value: 5m
--location -l

위치. 값 출처: az account list-locations. az configure --defaults location=<location>을 사용하여 기본 위치를 구성할 수 있습니다.

--mad --mute-actions-duration

경고가 발생한 후 선택한 기간(ISO 8601 기간 형식)에 대한 작업을 음소거합니다.

--severity

경고의 심각도는 0(중요)에서 4(자세한 정보 표시)입니다.

Default value: 2
--skip-query-validation

제공된 쿼리의 유효성을 검사해야 하는지 여부를 나타내는 플래그입니다.

허용되는 값: false, true
Default value: False
--tags

공백으로 구분된 태그: key[=value] [key[=value] ...]. ""를 사용하여 기존 태그를 지웁니다.

--target-resource-type --type

범위 내 대상 리소스의 리소스 종류입니다. 범위가 리소스 그룹 또는 구독인 경우 이 옵션을 제공해야 합니다.

--window-size

메트릭을 "##h##m##s" 형식으로 집계할 시간입니다.

Default value: 5m
전역 매개 변수
--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

오류만 표시하고, 경고를 표시하지 않습니다.

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.

--subscription

구독의 이름 또는 ID입니다. az account set -s NAME_OR_ID를 사용하여 기본 위치를 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.

az monitor scheduled-query delete

예약된 쿼리를 삭제합니다.

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

선택적 매개 변수

--ids

하나 이상의 리소스 ID(공백으로 구분)입니다. '리소스 ID' 인수의 모든 정보를 포함하는 완전한 리소스 ID여야 합니다. --ids 또는 기타 '리소스 ID' 인수를 제공해야 합니다.

--name -n

예약된 쿼리 규칙의 이름입니다.

--resource-group -g

리소스 그룹의 이름입니다. az configure --defaults group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.

--subscription

구독의 이름 또는 ID입니다. az account set -s NAME_OR_ID를 사용하여 기본 위치를 구성할 수 있습니다.

--yes -y

확인을 묻는 메시지를 표시하지 마세요.

Default value: False
전역 매개 변수
--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

오류만 표시하고, 경고를 표시하지 않습니다.

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.

--subscription

구독의 이름 또는 ID입니다. az account set -s NAME_OR_ID를 사용하여 기본 위치를 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.

az monitor scheduled-query list

예약된 모든 쿼리를 나열합니다.

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

선택적 매개 변수

--resource-group -g

리소스 그룹의 이름입니다. az configure --defaults group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.

전역 매개 변수
--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

오류만 표시하고, 경고를 표시하지 않습니다.

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.

--subscription

구독의 이름 또는 ID입니다. az account set -s NAME_OR_ID를 사용하여 기본 위치를 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.

az monitor scheduled-query show

예약된 쿼리의 세부 정보를 표시합니다.

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

선택적 매개 변수

--ids

하나 이상의 리소스 ID(공백으로 구분)입니다. '리소스 ID' 인수의 모든 정보를 포함하는 완전한 리소스 ID여야 합니다. --ids 또는 기타 '리소스 ID' 인수를 제공해야 합니다.

--name -n

예약된 쿼리 규칙의 이름입니다.

--resource-group -g

리소스 그룹의 이름입니다. az configure --defaults group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.

--subscription

구독의 이름 또는 ID입니다. az account set -s NAME_OR_ID를 사용하여 기본 위치를 구성할 수 있습니다.

전역 매개 변수
--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

오류만 표시하고, 경고를 표시하지 않습니다.

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.

--subscription

구독의 이름 또는 ID입니다. az account set -s NAME_OR_ID를 사용하여 기본 위치를 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.

az monitor scheduled-query update

예약된 쿼리를 업데이트합니다.

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

선택적 매개 변수

--action-groups

경고가 발생할 때 호출할 작업 그룹 리소스 ID입니다.

--add

경로 및 키 값 쌍을 지정하여 개체 목록에 개체를 추가합니다. 예: --add property.listProperty <key=value, string or JSON string>

Default value: []
--auto-mitigate

경고를 자동으로 해결해야 하는지 여부를 나타내는 플래그입니다. 기본값은 true입니다.

허용되는 값: false, true
--check-ws-alerts-storage --cwas

이 예약된 쿼리 규칙을 고객의 스토리지에 저장해야 하는지 여부를 나타내는 플래그입니다.

허용되는 값: false, true
--condition

규칙을 트리거하는 조건입니다.

사용: --condition {avg,min,max,total,count} ["METRIC COLUMN" from] "QUERY_PLACEHOLDER" {=,!=,,>,>,,<<=} THRESHOLD [resource id RESOURCEID] [where DIMENSION {includes,excludes} VALUE [또는 VALUE ...] [and DIMENSION {includes,excludes} VALUE [또는 VALUE ...] ...]] [EvaluationPeriod 집계 지점에서 최소 MinTimeToFail 위반]'

'where' 키워드(keyword) 추가하여 --condition-query 인수 Dimensions에 쿼리할 수 있는 쿼리 자리 표시자를 정의할 수 있으며 여러 차원을 'and' 키워드(keyword) 결합하여 쿼리할 수 있습니다.

--condition-query

인수의 자리 표시자를 바꾸려면 deteil을 쿼리합니다 --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으로 변환하는 대신 문자열 리터럴을 유지합니다.

Default value: False
--ids

하나 이상의 리소스 ID(공백으로 구분)입니다. '리소스 ID' 인수의 모든 정보를 포함하는 완전한 리소스 ID여야 합니다. --ids 또는 기타 '리소스 ID' 인수를 제공해야 합니다.

--mad --mute-actions-duration

경고가 발생한 후 선택한 기간(ISO 8601 기간 형식)에 대한 작업을 음소거합니다.

--name -n

예약된 쿼리 규칙의 이름입니다.

--remove

목록에서 속성 또는 요소를 제거합니다. 예: --remove property.list <indexToRemove> OR --remove propertyToRemove.

Default value: []
--resource-group -g

리소스 그룹의 이름입니다. az configure --defaults group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.

--set

설정할 속성 경로와 값을 지정하여 개체를 업데이트합니다. 예: --set property1.property2=<value>

Default value: []
--severity

경고의 심각도는 0(중요)에서 4(자세한 정보 표시)입니다.

--skip-query-validation

제공된 쿼리의 유효성을 검사해야 하는지 여부를 나타내는 플래그입니다.

허용되는 값: false, true
--subscription

구독의 이름 또는 ID입니다. az account set -s NAME_OR_ID를 사용하여 기본 위치를 구성할 수 있습니다.

--tags

공백으로 구분된 태그: key[=value] [key[=value] ...]. ""를 사용하여 기존 태그를 지웁니다.

--target-resource-type --type

범위 내 대상 리소스의 리소스 종류입니다. 범위가 리소스 그룹 또는 구독인 경우 이 옵션을 제공해야 합니다.

--window-size

메트릭을 "##h##m##s" 형식으로 집계할 시간입니다.

전역 매개 변수
--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

오류만 표시하고, 경고를 표시하지 않습니다.

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.

--subscription

구독의 이름 또는 ID입니다. az account set -s NAME_OR_ID를 사용하여 기본 위치를 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.