az monitor scheduled-query

Note

Bu başvuru, Azure CLI (sürüm 2.54.0 veya üzeri) için scheduled-query uzantısının bir parçasıdır. uzantı, bir az monitor scheduled-query komutunu ilk kez çalıştırdığınızda otomatik olarak yüklenir. Uzantılar hakkında daha fazla bilgi edinin.

Zamanlanmış sorguları yönetme komutları.

Komutlar

Name Description Tür Durum
az monitor scheduled-query create

Zamanlanmış sorgu oluşturun.

Extension GA
az monitor scheduled-query delete

Zamanlanmış sorguyu silin.

Extension GA
az monitor scheduled-query list

Zamanlanmış tüm sorguları listeleyin.

Extension GA
az monitor scheduled-query show

Zamanlanmış sorgunun ayrıntılarını gösterir.

Extension GA
az monitor scheduled-query update

Zamanlanmış sorguyu güncelleştirme.

Extension GA

az monitor scheduled-query create

Zamanlanmış sorgu oluşturun.

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]

Örnekler

VM için zamanlanmış sorgu oluşturma.

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"

Bir kaynak grubundaki VM'ler için zamanlanmış sorgu oluşturun.

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"

Gerekli Parametreler

--condition

Kuralı tetikleyen koşul.

Kullanım: --condition {avg,min,max,total,count} ["METRIC COLUMN" from] "QUERY_PLACEHOLDER" {=,!=,>,>=,<,<=} THRESHOLD [resource id RESOURCEID] [dimension {includes,excludes} VALUE [veya VALUE ...] [ve DIMENSION {includes,excludes} VALUE [veya VALUE ...] ...]] [En az MinTimeToFail ihlalleri EvaluationPeriod toplu noktaları dışında]' Sorgu yer tutucuları --condition-query bağımsız değişkeninde tanımlanabilir Boyutlar 'where' anahtar sözcüğü eklenerek sorgulanabilir ve birden çok boyut 've' anahtar sözcüğüyle birleştirilerek sorgulanabilir.

--name -n

Zamanlanan sorgu kuralının adı.

--resource-group -g

Kaynak grubunun adı. az configure --defaults group=<name>kullanarak varsayılan grubu yapılandırabilirsiniz.

--scopes

Kuralın uygulandığı kapsamların boşlukla ayrılmış listesi. Bu parametrede belirtilen kaynaklar aynı türde olmalı ve aynı konumda bulunmalıdır.

İsteğe Bağlı Parametreler

Aşağıdaki parametreler isteğe bağlıdır, ancak bağlama bağlı olarak komutun başarıyla yürütülmesi için bir veya daha fazla parametre gerekli olabilir.

--acquire-policy-token

Bu kaynak işlemi için otomatik olarak bir Azure İlkesi belirteci alma.

Özellik Değer
Parametre grubu: Global Policy Arguments
--action-groups

Uyarı tetiklendiğinde çağrılacak Eylem Grubu kaynak kimlikleri.

Kullanım: --action-groups ACTION_GROUP_NAME_OR_ID [NAME_OR_ID,...].

--auto-mitigate

Uyarının otomatik olarak çözümlenip çözümlenmeyeceğini gösteren bayrak. Varsayılan değer true'dur.

Özellik Değer
Default value: True
Kabul edilen değerler: false, true
--change-reference

Bu kaynak işlemi için ilgili değişiklik başvuru kimliği.

Özellik Değer
Parametre grubu: Global Policy Arguments
--check-ws-alerts-storage --cwas

Bu zamanlanmış sorgu kuralının müşterinin depolama alanında depolanıp depolanmayacağını gösteren bayrak.

Özellik Değer
Default value: False
Kabul edilen değerler: false, true
--condition-query

Sorgu, --condition bağımsız değişkenindeki yer tutucuları değiştirmek için kullanılır.

--custom-properties

Uyarı yükünün özellikleri.

Kullanım: --custom-properties ALERT_PAYLOAD_PROPERTIES [KEY=VAL,KEY=VAL ...].

--description

Kuralın serbest metin açıklaması.

--disabled

Zamanlanmış sorguyu devre dışı bırakın.

Özellik Değer
Default value: False
Kabul edilen değerler: false, true
--evaluation-frequency

Kuralın "##h##m##s" biçiminde değerlendirilme sıklığı.

Özellik Değer
Default value: 5m
--location -l

Location. Değerleri: az account list-locations. kullanarak az configure --defaults location=<location>varsayılan konumu yapılandırabilirsiniz.

--mad --mute-actions-duration

Uyarı tetiklendiğinde seçilen süre (ISO 8601 süre biçiminde) için eylemlerin sesini kapatın.

--severity

Uyarının önem derecesi 0 'dan (kritik) 4'e (ayrıntılı).

Özellik Değer
Default value: 2
--skip-query-validation

Sağlanan sorgunun doğrulanıp doğrulanmayacağını gösteren bayrak.

Özellik Değer
Default value: False
Kabul edilen değerler: false, true
--tags

Boşlukla ayrılmış etiketler: key[=value] [key[=value] ...]. Mevcut etiketleri temizlemek için "" kullanın.

--target-resource-type --type

Kapsamlardaki hedef kaynakların kaynak türü. Kapsamlar kaynak grubu veya abonelik olduğunda bu sağlanmalıdır.

--window-size

"##h##m##s" biçiminde ölçümlerin toplandığı süre.

Özellik Değer
Default value: 5m
Global Parametreler
--debug

Tüm hata ayıklama günlüklerini göstermek için günlük ayrıntı düzeyini artırın.

Özellik Değer
Default value: False
--help -h

Bu yardım iletisini göster ve çık.

--only-show-errors

Yalnızca hataları gösterir ve uyarıları gizler.

Özellik Değer
Default value: False
--output -o

Çıkış biçimi.

Özellik Değer
Default value: json
Kabul edilen değerler: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath sorgu dizesi. Daha fazla bilgi ve örnek için bkz. http://jmespath.org/.

--subscription

Aboneliğin adı veya kimliği. az account set -s NAME_OR_IDkullanarak varsayılan aboneliği yapılandırabilirsiniz.

--verbose

Günlük ayrıntı düzeyini artırın. Tam hata ayıklama günlükleri için --debug komutunu kullanın.

Özellik Değer
Default value: False

az monitor scheduled-query delete

Zamanlanmış sorguyu silin.

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

İsteğe Bağlı Parametreler

Aşağıdaki parametreler isteğe bağlıdır, ancak bağlama bağlı olarak komutun başarıyla yürütülmesi için bir veya daha fazla parametre gerekli olabilir.

--acquire-policy-token

Bu kaynak işlemi için otomatik olarak bir Azure İlkesi belirteci alma.

Özellik Değer
Parametre grubu: Global Policy Arguments
--change-reference

Bu kaynak işlemi için ilgili değişiklik başvuru kimliği.

Özellik Değer
Parametre grubu: Global Policy Arguments
--ids

Bir veya daha fazla kaynak kimliği (boşlukla ayrılmış). 'Kaynak Kimliği' bağımsız değişkenlerinin tüm bilgilerini içeren eksiksiz bir kaynak kimliği olmalıdır. --ids veya diğer 'Kaynak Kimliği' parametrelerini vermelisiniz.

Özellik Değer
Parametre grubu: Resource Id Arguments
--name -n

Zamanlanan sorgu kuralının adı.

Özellik Değer
Parametre grubu: Resource Id Arguments
--resource-group -g

Kaynak grubunun adı. az configure --defaults group=<name>kullanarak varsayılan grubu yapılandırabilirsiniz.

Özellik Değer
Parametre grubu: Resource Id Arguments
--subscription

Aboneliğin adı veya kimliği. az account set -s NAME_OR_IDkullanarak varsayılan aboneliği yapılandırabilirsiniz.

Özellik Değer
Parametre grubu: Resource Id Arguments
--yes -y

Onay istemde bulunmayın.

Özellik Değer
Default value: False
Global Parametreler
--debug

Tüm hata ayıklama günlüklerini göstermek için günlük ayrıntı düzeyini artırın.

Özellik Değer
Default value: False
--help -h

Bu yardım iletisini göster ve çık.

--only-show-errors

Yalnızca hataları gösterir ve uyarıları gizler.

Özellik Değer
Default value: False
--output -o

Çıkış biçimi.

Özellik Değer
Default value: json
Kabul edilen değerler: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath sorgu dizesi. Daha fazla bilgi ve örnek için bkz. http://jmespath.org/.

--verbose

Günlük ayrıntı düzeyini artırın. Tam hata ayıklama günlükleri için --debug komutunu kullanın.

Özellik Değer
Default value: False

az monitor scheduled-query list

Zamanlanmış tüm sorguları listeleyin.

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

İsteğe Bağlı Parametreler

Aşağıdaki parametreler isteğe bağlıdır, ancak bağlama bağlı olarak komutun başarıyla yürütülmesi için bir veya daha fazla parametre gerekli olabilir.

--resource-group -g

Kaynak grubunun adı. az configure --defaults group=<name>kullanarak varsayılan grubu yapılandırabilirsiniz.

Global Parametreler
--debug

Tüm hata ayıklama günlüklerini göstermek için günlük ayrıntı düzeyini artırın.

Özellik Değer
Default value: False
--help -h

Bu yardım iletisini göster ve çık.

--only-show-errors

Yalnızca hataları gösterir ve uyarıları gizler.

Özellik Değer
Default value: False
--output -o

Çıkış biçimi.

Özellik Değer
Default value: json
Kabul edilen değerler: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath sorgu dizesi. Daha fazla bilgi ve örnek için bkz. http://jmespath.org/.

--subscription

Aboneliğin adı veya kimliği. az account set -s NAME_OR_IDkullanarak varsayılan aboneliği yapılandırabilirsiniz.

--verbose

Günlük ayrıntı düzeyini artırın. Tam hata ayıklama günlükleri için --debug komutunu kullanın.

Özellik Değer
Default value: False

az monitor scheduled-query show

Zamanlanmış sorgunun ayrıntılarını gösterir.

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

İsteğe Bağlı Parametreler

Aşağıdaki parametreler isteğe bağlıdır, ancak bağlama bağlı olarak komutun başarıyla yürütülmesi için bir veya daha fazla parametre gerekli olabilir.

--ids

Bir veya daha fazla kaynak kimliği (boşlukla ayrılmış). 'Kaynak Kimliği' bağımsız değişkenlerinin tüm bilgilerini içeren eksiksiz bir kaynak kimliği olmalıdır. --ids veya diğer 'Kaynak Kimliği' parametrelerini vermelisiniz.

Özellik Değer
Parametre grubu: Resource Id Arguments
--name -n

Zamanlanan sorgu kuralının adı.

Özellik Değer
Parametre grubu: Resource Id Arguments
--resource-group -g

Kaynak grubunun adı. az configure --defaults group=<name>kullanarak varsayılan grubu yapılandırabilirsiniz.

Özellik Değer
Parametre grubu: Resource Id Arguments
--subscription

Aboneliğin adı veya kimliği. az account set -s NAME_OR_IDkullanarak varsayılan aboneliği yapılandırabilirsiniz.

Özellik Değer
Parametre grubu: Resource Id Arguments
Global Parametreler
--debug

Tüm hata ayıklama günlüklerini göstermek için günlük ayrıntı düzeyini artırın.

Özellik Değer
Default value: False
--help -h

Bu yardım iletisini göster ve çık.

--only-show-errors

Yalnızca hataları gösterir ve uyarıları gizler.

Özellik Değer
Default value: False
--output -o

Çıkış biçimi.

Özellik Değer
Default value: json
Kabul edilen değerler: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath sorgu dizesi. Daha fazla bilgi ve örnek için bkz. http://jmespath.org/.

--verbose

Günlük ayrıntı düzeyini artırın. Tam hata ayıklama günlükleri için --debug komutunu kullanın.

Özellik Değer
Default value: False

az monitor scheduled-query update

Zamanlanmış sorguyu güncelleştirme.

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]

İsteğe Bağlı Parametreler

Aşağıdaki parametreler isteğe bağlıdır, ancak bağlama bağlı olarak komutun başarıyla yürütülmesi için bir veya daha fazla parametre gerekli olabilir.

--acquire-policy-token

Bu kaynak işlemi için otomatik olarak bir Azure İlkesi belirteci alma.

Özellik Değer
Parametre grubu: Global Policy Arguments
--action-groups

Uyarı tetiklendiğinde çağrılacak Eylem Grubu kaynak kimlikleri.

--add

Bir yol ve anahtar değer çiftleri belirterek nesne listesine nesne ekleyin. Örnek: --add property.listProperty <key=value, string or JSON string>.

Özellik Değer
Parametre grubu: Generic Update Arguments
Default value: []
--auto-mitigate

Uyarının otomatik olarak çözümlenip çözümlenmeyeceğini gösteren bayrak. Varsayılan değer true'dur.

Özellik Değer
Kabul edilen değerler: false, true
--change-reference

Bu kaynak işlemi için ilgili değişiklik başvuru kimliği.

Özellik Değer
Parametre grubu: Global Policy Arguments
--check-ws-alerts-storage --cwas

Bu zamanlanmış sorgu kuralının müşterinin depolama alanında depolanıp depolanmayacağını gösteren bayrak.

Özellik Değer
Kabul edilen değerler: false, true
--condition

Kuralı tetikleyen koşul.

Kullanım: --condition {avg,min,max,total,count} ["METRIC COLUMN" from] "QUERY_PLACEHOLDER" {=,!=,>,>=,<,<=} THRESHOLD [resource id RESOURCEID] [dimension {includes,excludes} VALUE [veya VALUE ...] [ve DIMENSION {includes,excludes} VALUE [veya VALUE ...] ...]] [DeğerlendirmePeriod toplu noktaları dışında en az MinTimeToFail ihlalleri]'

Sorgu yer tutucuları --condition-query bağımsız değişkeninde tanımlanabilir Boyutlar 'where' anahtar sözcüğü eklenerek sorgulanabilir ve birden çok boyut 've' anahtar sözcüğüyle birleştirilerek sorgulanabilir.

--condition-query

Sorgu, --condition bağımsız değişkenindeki yer tutucuları değiştirmek için kullanılır.

--custom-properties

Uyarı yükünün özellikleri.

Kullanım: --custom-properties ALERT_PAYLOAD_PROPERTIES [KEY=VAL,KEY=VAL ...].

--description

Kuralın serbest metin açıklaması.

--disabled

Zamanlanmış sorguyu devre dışı bırakın.

Özellik Değer
Kabul edilen değerler: false, true
--evaluation-frequency

Kuralın "##h##m##s" biçiminde değerlendirilme sıklığı.

--force-string

'set' veya 'add' kullanırken, JSON'a dönüştürmeye çalışmak yerine dize değişmez değerlerini koruyun.

Özellik Değer
Parametre grubu: Generic Update Arguments
Default value: False
--ids

Bir veya daha fazla kaynak kimliği (boşlukla ayrılmış). 'Kaynak Kimliği' bağımsız değişkenlerinin tüm bilgilerini içeren eksiksiz bir kaynak kimliği olmalıdır. --ids veya diğer 'Kaynak Kimliği' parametrelerini vermelisiniz.

Özellik Değer
Parametre grubu: Resource Id Arguments
--mad --mute-actions-duration

Uyarı tetiklendiğinde seçilen süre (ISO 8601 süre biçiminde) için eylemlerin sesini kapatın.

--name -n

Zamanlanan sorgu kuralının adı.

Özellik Değer
Parametre grubu: Resource Id Arguments
--remove

Bir özelliği veya öğeyi listeden kaldırın. Örnek: --remove property.list <indexToRemove> OR --remove propertyToRemove.

Özellik Değer
Parametre grubu: Generic Update Arguments
Default value: []
--resource-group -g

Kaynak grubunun adı. az configure --defaults group=<name>kullanarak varsayılan grubu yapılandırabilirsiniz.

Özellik Değer
Parametre grubu: Resource Id Arguments
--set

Ayarlanacağı özellik yolunu ve değerini belirterek nesneyi güncelleştirin. Örnek: --set property1.property2=<value>.

Özellik Değer
Parametre grubu: Generic Update Arguments
Default value: []
--severity

Uyarının önem derecesi 0 'dan (kritik) 4'e (ayrıntılı).

--skip-query-validation

Sağlanan sorgunun doğrulanıp doğrulanmayacağını gösteren bayrak.

Özellik Değer
Kabul edilen değerler: false, true
--subscription

Aboneliğin adı veya kimliği. az account set -s NAME_OR_IDkullanarak varsayılan aboneliği yapılandırabilirsiniz.

Özellik Değer
Parametre grubu: Resource Id Arguments
--tags

Boşlukla ayrılmış etiketler: key[=value] [key[=value] ...]. Mevcut etiketleri temizlemek için "" kullanın.

--target-resource-type --type

Kapsamlardaki hedef kaynakların kaynak türü. Kapsamlar kaynak grubu veya abonelik olduğunda bu sağlanmalıdır.

--window-size

"##h##m##s" biçiminde ölçümlerin toplandığı süre.

Global Parametreler
--debug

Tüm hata ayıklama günlüklerini göstermek için günlük ayrıntı düzeyini artırın.

Özellik Değer
Default value: False
--help -h

Bu yardım iletisini göster ve çık.

--only-show-errors

Yalnızca hataları gösterir ve uyarıları gizler.

Özellik Değer
Default value: False
--output -o

Çıkış biçimi.

Özellik Değer
Default value: json
Kabul edilen değerler: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath sorgu dizesi. Daha fazla bilgi ve örnek için bkz. http://jmespath.org/.

--verbose

Günlük ayrıntı düzeyini artırın. Tam hata ayıklama günlükleri için --debug komutunu kullanın.

Özellik Değer
Default value: False