Share via

az monitor scheduled-query

  • Referensi

Catatan

Referensi ini adalah bagian dari ekstensi kueri terjadwal untuk Azure CLI (versi 2.54.0 atau yang lebih tinggi). Ekstensi akan secara otomatis menginstal pertama kali Anda menjalankan perintah az monitor scheduled-query . Pelajari lebih lanjut tentang ekstensi.

Perintah untuk mengelola kueri terjadwal.

Perintah

Nama Deskripsi Jenis Status
az monitor scheduled-query create

Buat kueri terjadwal.

 Ekstensi GA
az monitor scheduled-query delete

Menghapus kueri terjadwal.

 Ekstensi GA
az monitor scheduled-query list

Mencantumkan semua kueri terjadwal.

 Ekstensi GA
az monitor scheduled-query show

Perlihatkan detail kueri terjadwal.

 Ekstensi GA
az monitor scheduled-query update

Memperbarui kueri terjadwal.

 Ekstensi GA

az monitor scheduled-query create

Buat kueri terjadwal.

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]

Contoh

Buat kueri terjadwal untuk 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"

Buat kueri terjadwal untuk VM dalam grup sumber daya.

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"

Parameter yang Diperlukan

--condition

Kondisi yang memicu aturan.

Penggunaan: --condition {avg,min,max,total,count} ["METRIC COLUMN" from] "QUERY_PLACEHOLDER" {=,!=,,>>=,,<=<} THRESHOLD [resource id RESOURCEID] [where DIMENSION {includes,excludes} VALUE [or VALUE ...] [dan DIMENSION {includes,excludes} VALUE [atau VALUE ...] ...]] [setidaknya pelanggaran MinTimeToFail di luar titik agregat EvaluationPeriod]' Tempat penampung kueri dapat didefinisikan dalam Dimensi argumen --condition-query dapat dikueri dengan menambahkan kata kunci 'di mana' dan beberapa dimensi dapat dikueri dengan menggabungkannya dengan kata kunci 'dan'.

--name -n

Nama aturan kueri terjadwal.

--resource-group -g

Nama grup sumber daya. Anda dapat mengonfigurasi grup default menggunakan az configure --defaults group=<name>.

--scopes

Daftar cakupan yang dipisahkan spasi yang diterapkan aturan. Sumber daya yang ditentukan dalam parameter ini harus memiliki jenis yang sama dan ada di lokasi yang sama.

Parameter Opsional

--action-groups

Id sumber daya Grup Tindakan untuk dipanggil saat pemberitahuan diaktifkan.

Penggunaan: --action-groups ACTION_GROUP_NAME_OR_ID [NAME_OR_ID,...].

--auto-mitigate

Bendera yang menunjukkan apakah pemberitahuan harus diselesaikan secara otomatis atau tidak. Defaultnya adalah true.

nilai yang diterima: false, true
nilai default: True
--check-ws-alerts-storage --cwas

Bendera yang menunjukkan apakah aturan kueri terjadwal ini harus disimpan di penyimpanan pelanggan.

nilai yang diterima: false, true
nilai default: False
--condition-query

Kueri dihentikan untuk mengganti tempat penampung dalam --condition argumen.

--custom-properties

Properti payload pemberitahuan.

Penggunaan: --custom-properties ALERT_PAYLOAD_PROPERTIES [KEY=VAL,KEY=VAL ...].

--description

Deskripsi teks bebas dari aturan.

--disabled

Nonaktifkan kueri terjadwal.

nilai yang diterima: false, true
nilai default: False
--evaluation-frequency

Frekuensi untuk mengevaluasi aturan dalam format "##h##m##s".

nilai default: 5m
--location -l

Lokasi. Nilai dari: az account list-locations. Anda dapat mengonfigurasi lokasi default menggunakan az configure --defaults location=<location>.

--mad --mute-actions-duration

Matikan suara tindakan untuk periode waktu yang dipilih (dalam format durasi ISO 8601) setelah pemberitahuan diaktifkan.

--severity

Tingkat keparahan pemberitahuan dari 0 (kritis) hingga 4 (verbose).

nilai default: 2
--skip-query-validation

Bendera yang menunjukkan apakah kueri yang disediakan harus divalidasi atau tidak.

nilai yang diterima: false, true
nilai default: False
--tags

Tag yang dipisahkan spasi: key[=value] [key[=value] ...]. Gunakan "" untuk menghapus tag yang ada.

--target-resource-type --type

Jenis sumber daya sumber daya target dalam cakupan. Ini harus disediakan ketika cakupan adalah grup sumber daya atau langganan.

--window-size

Waktu untuk mengagregasi metrik dalam format "##h##m##s".

nilai default: 5m
Parameter Global
--debug

Meningkatkan verbositas pengelogan untuk menampilkan semua log debug.

--help -h

Menampilkan pesan bantuan ini dan keluar.

--only-show-errors

Hanya menampilkan kesalahan, menyembunyikan peringatan.

--output -o

Format output.

nilai yang diterima: json, jsonc, none, table, tsv, yaml, yamlc
nilai default: json
--query

String kueri JMESPath. Lihat http://jmespath.org/ untuk informasi selengkapnya beserta contohnya.

--subscription

Nama atau ID langganan. Anda dapat mengonfigurasi langganan default menggunakan az account set -s NAME_OR_ID.

--verbose

Meningkatkan verbositas pengelogan. Gunakan --debug untuk log waktu lengkap.

az monitor scheduled-query delete

Menghapus kueri terjadwal.

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

Parameter Opsional

--ids

Satu atau beberapa ID sumber daya (dibatasi ruang). Ini harus menjadi ID sumber daya lengkap yang berisi semua informasi argumen 'Id Sumber Daya'. Anda harus menyediakan argumen --ids atau 'Resource Id' lainnya.

--name -n

Nama aturan kueri terjadwal.

--resource-group -g

Nama grup sumber daya. Anda dapat mengonfigurasi grup default menggunakan az configure --defaults group=<name>.

--subscription

Nama atau ID langganan. Anda dapat mengonfigurasi langganan default menggunakan az account set -s NAME_OR_ID.

--yes -y

Jangan meminta konfirmasi.

nilai default: False
Parameter Global
--debug

Meningkatkan verbositas pengelogan untuk menampilkan semua log debug.

--help -h

Menampilkan pesan bantuan ini dan keluar.

--only-show-errors

Hanya menampilkan kesalahan, menyembunyikan peringatan.

--output -o

Format output.

nilai yang diterima: json, jsonc, none, table, tsv, yaml, yamlc
nilai default: json
--query

String kueri JMESPath. Lihat http://jmespath.org/ untuk informasi selengkapnya beserta contohnya.

--subscription

Nama atau ID langganan. Anda dapat mengonfigurasi langganan default menggunakan az account set -s NAME_OR_ID.

--verbose

Meningkatkan verbositas pengelogan. Gunakan --debug untuk log waktu lengkap.

az monitor scheduled-query list

Mencantumkan semua kueri terjadwal.

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

Parameter Opsional

--resource-group -g

Nama grup sumber daya. Anda dapat mengonfigurasi grup default menggunakan az configure --defaults group=<name>.

Parameter Global
--debug

Meningkatkan verbositas pengelogan untuk menampilkan semua log debug.

--help -h

Menampilkan pesan bantuan ini dan keluar.

--only-show-errors

Hanya menampilkan kesalahan, menyembunyikan peringatan.

--output -o

Format output.

nilai yang diterima: json, jsonc, none, table, tsv, yaml, yamlc
nilai default: json
--query

String kueri JMESPath. Lihat http://jmespath.org/ untuk informasi selengkapnya beserta contohnya.

--subscription

Nama atau ID langganan. Anda dapat mengonfigurasi langganan default menggunakan az account set -s NAME_OR_ID.

--verbose

Meningkatkan verbositas pengelogan. Gunakan --debug untuk log waktu lengkap.

az monitor scheduled-query show

Perlihatkan detail kueri terjadwal.

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

Parameter Opsional

--ids

Satu atau beberapa ID sumber daya (dibatasi ruang). Ini harus menjadi ID sumber daya lengkap yang berisi semua informasi argumen 'Id Sumber Daya'. Anda harus menyediakan argumen --ids atau 'Resource Id' lainnya.

--name -n

Nama aturan kueri terjadwal.

--resource-group -g

Nama grup sumber daya. Anda dapat mengonfigurasi grup default menggunakan az configure --defaults group=<name>.

--subscription

Nama atau ID langganan. Anda dapat mengonfigurasi langganan default menggunakan az account set -s NAME_OR_ID.

Parameter Global
--debug

Meningkatkan verbositas pengelogan untuk menampilkan semua log debug.

--help -h

Menampilkan pesan bantuan ini dan keluar.

--only-show-errors

Hanya menampilkan kesalahan, menyembunyikan peringatan.

--output -o

Format output.

nilai yang diterima: json, jsonc, none, table, tsv, yaml, yamlc
nilai default: json
--query

String kueri JMESPath. Lihat http://jmespath.org/ untuk informasi selengkapnya beserta contohnya.

--subscription

Nama atau ID langganan. Anda dapat mengonfigurasi langganan default menggunakan az account set -s NAME_OR_ID.

--verbose

Meningkatkan verbositas pengelogan. Gunakan --debug untuk log waktu lengkap.

az monitor scheduled-query update

Memperbarui kueri terjadwal.

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]

Parameter Opsional

--action-groups

Id sumber daya Grup Tindakan untuk dipanggil saat pemberitahuan diaktifkan.

--add

Tambahkan objek ke daftar objek dengan menentukan jalur dan pasangan nilai kunci. Contoh: --add property.listProperty <key=value, string or JSON string>.

nilai default: []
--auto-mitigate

Bendera yang menunjukkan apakah pemberitahuan harus diselesaikan secara otomatis atau tidak. Defaultnya adalah true.

nilai yang diterima: false, true
--check-ws-alerts-storage --cwas

Bendera yang menunjukkan apakah aturan kueri terjadwal ini harus disimpan di penyimpanan pelanggan.

nilai yang diterima: false, true
--condition

Kondisi yang memicu aturan.

Penggunaan: --condition {avg,min,max,total,count} ["METRIC COLUMN" from] "QUERY_PLACEHOLDER" {=,!=,,>>=,,<=<} THRESHOLD [resource id RESOURCEID] [where DIMENSION {includes,excludes} VALUE [or VALUE ...] [dan DIMENSION {includes,excludes} VALUE [atau VALUE ...] ...]] [setidaknya pelanggaran MinTimeToFail keluar dari poin agregat EvaluationPeriod]'

Tempat penampung kueri dapat ditentukan dalam dimensi argumen --condition-query dapat dikueri dengan menambahkan kata kunci 'where' dan beberapa dimensi dapat dikueri dengan menggabungkannya dengan kata kunci 'dan'.

--condition-query

Kueri dihentikan untuk mengganti tempat penampung dalam --condition argumen.

--custom-properties

Properti payload pemberitahuan.

Penggunaan: --custom-properties ALERT_PAYLOAD_PROPERTIES [KEY=VAL,KEY=VAL ...].

--description

Deskripsi teks bebas dari aturan.

--disabled

Nonaktifkan kueri terjadwal.

nilai yang diterima: false, true
--evaluation-frequency

Frekuensi untuk mengevaluasi aturan dalam format "##h##m##s".

--force-string

Saat menggunakan 'set' atau 'add', pertahankan literal string alih-alih mencoba mengonversi ke JSON.

nilai default: False
--ids

Satu atau beberapa ID sumber daya (dibatasi ruang). Ini harus menjadi ID sumber daya lengkap yang berisi semua informasi argumen 'Id Sumber Daya'. Anda harus menyediakan argumen --ids atau 'Resource Id' lainnya.

--mad --mute-actions-duration

Matikan suara tindakan untuk periode waktu yang dipilih (dalam format durasi ISO 8601) setelah pemberitahuan diaktifkan.

--name -n

Nama aturan kueri terjadwal.

--remove

Menghapus properti atau elemen dari daftar. Contoh: --remove property.list <indexToRemove> ATAU --remove propertyToRemove.

nilai default: []
--resource-group -g

Nama grup sumber daya. Anda dapat mengonfigurasi grup default menggunakan az configure --defaults group=<name>.

--set

Perbarui objek dengan menentukan jalur properti dan nilai yang akan diatur. Contoh: --set property1.property2=<value>.

nilai default: []
--severity

Tingkat keparahan pemberitahuan dari 0 (kritis) hingga 4 (verbose).

--skip-query-validation

Bendera yang menunjukkan apakah kueri yang disediakan harus divalidasi atau tidak.

nilai yang diterima: false, true
--subscription

Nama atau ID langganan. Anda dapat mengonfigurasi langganan default menggunakan az account set -s NAME_OR_ID.

--tags

Tag yang dipisahkan spasi: key[=value] [key[=value] ...]. Gunakan "" untuk menghapus tag yang ada.

--target-resource-type --type

Jenis sumber daya sumber daya target dalam cakupan. Ini harus disediakan ketika cakupan adalah grup sumber daya atau langganan.

--window-size

Waktu untuk mengagregasi metrik dalam format "##h##m##s".

Parameter Global
--debug

Meningkatkan verbositas pengelogan untuk menampilkan semua log debug.

--help -h

Menampilkan pesan bantuan ini dan keluar.

--only-show-errors

Hanya menampilkan kesalahan, menyembunyikan peringatan.

--output -o

Format output.

nilai yang diterima: json, jsonc, none, table, tsv, yaml, yamlc
nilai default: json
--query

String kueri JMESPath. Lihat http://jmespath.org/ untuk informasi selengkapnya beserta contohnya.

--subscription

Nama atau ID langganan. Anda dapat mengonfigurasi langganan default menggunakan az account set -s NAME_OR_ID.

--verbose

Meningkatkan verbositas pengelogan. Gunakan --debug untuk log waktu lengkap.