Bagikan melalui

Gambaran umum pemberitahuan metrik berbasis kueri (pratinjau)

Anda dapat membuat aturan pemberitahuan metrik pada metrik Prometheus atau metrik kustom (OTel) yang disimpan di Ruang Kerja Azure Monitor, dengan kondisi pemberitahuan metrik berbasis kueri menggunakan PromQL.

Artikel ini menyediakan gambaran umum pemberitahuan metrik berbasis kueri di Azure Monitor, yang berfokus pada cara menggunakan PromQL untuk membuat aturan pemberitahuan pada metrik Prometheus atau kustom (OTel) yang disimpan di Ruang Kerja Azure Monitor.

Apa itu PromQL?

PromQL adalah bahasa kueri metrik berbasis sumber terbuka dengan:

  • Sekumpulan fungsi metrik dan operator untuk pemilihan, agregasi, dan transformasi data.
  • Manipulasi multi-dimen secara bawaan, evaluasi, dan pemberitahuan, termasuk pemfilteran dimensi, agregasi, dan pelabelan ulang.
  • Kondisi gabungan termasuk kondisi bersarang.
  • Menggabungkan dan memperbandingkan beberapa metrik
  • Penggunaan kembali ekspresi pemberitahuan PromQL dari komunitas atau dari sistem pemantauan berbasis Prometheus yang ada.

Capabilities

  • Sumber daya sentris dan ruang kerja sentris cakupan aturan.
    • Aturan yang berfokus pada sumber daya menerapkan kueri ke metrik dari sumber daya Azure tertentu seperti Azure Kubernetes Services (AKS) atau VM, dengan granularitas RBAC dengan hanya memerlukan akses ke sumber daya yang dipantau.
    • Aturan yang ber sentris ruang kerja memungkinkan pengguna yang berwenang untuk mengkueri metrik apa pun yang dipancarkan ke Ruang Kerja oleh sumber daya apa pun, termasuk kueri lintas sumber daya.
  • Otorisasi berbasis Identitas Terkelola. Anda dapat mengotorisasi akses ke Ruang Kerja menggunakan Azure Managed Identity. Identitas Terkelola menyediakan akses aman yang dikelola Azure ke sumber daya, meningkatkan granularitas RBAC dengan memisahkan pengguna dan hak akses aturan. Alert metrik mendukung identitas yang ditetapkan pengguna dan yang ditetapkan sistem.
  • Penyesuaian pemberitahuan yang dipicu. Anda dapat mengkustomisasi pemberitahuan metrik berbasis kueri untuk menyertakan informasi yang lebih kontekstual dan spesifik skenario.

Nota

Subjek email kustom dan properti kustom mendukung penyisipan dinamis properti dari payload pemberitahuan.

Pemberitahuan metrik berbasis kueri dibandingkan dengan grup aturan Prometheus

Pemberitahuan metrik berbasis kueri adalah alternatif untuk pemberitahuan di grup aturan Prometheus.

Keuntungan menggunakan pemberitahuan metrik berbasis kueri:

  • Aturan pemberitahuan dikonfigurasi dan dikelola sebagai sumber daya Azure individual. Anda tidak perlu membuat dan mengelola grup aturan di atas aturan individual.
  • Dukungan untuk kueri yang berpusat pada sumber daya dan RBAC - pengguna Anda tidak memerlukan hak akses ke Workspace Anda.
  • Dukungan untuk autentikasi dan otorisasi menggunakan Azure Managed Identity.
  • Dukungan kustomisasi subjek email.

Perbedaan dalam menggunakan aturan pemberitahuan metrik berbasis kueri vs grup aturan Prometheus

  • Pembatasan cakupan. Dalam grup aturan Prometheus, Anda dapat membatasi cakupan aturan ke satu kluster AKS atau ARC, menggunakan clusterName properti . Dengan aturan pemberitahuan metrik berbasis kueri, membatasi cakupan ke satu kluster (atau sumber daya lainnya) dilakukan dengan mengatur aturan scope ke sumber daya tertentu.
  • Kondisi aturan. Properti aturan query pemberitahuan metrik sepenuhnya setara dengan properti grup expression aturan Prometheus dan akan menghasilkan hasil yang sama. Properti for berfungsi dengan cara yang sama pada kedua layanan.
  • Menangani label metrik. Pemberitahuan metrik berbasis kueri sepenuhnya mendukung penanganan dan manipulasi label pada metrik Prometheus dan OTel sesuai dengan standar PromQL. Namun, ketika pemberitahuan diaktifkan, label metrik yang tersisa dan nilainya muncul di payload sebagai dimensions, mengikuti terminologi yang digunakan dalam pemberitahuan Azure lainnya dan pengalaman Azure Monitor.
  • Metadata dan informasi kustom. Anda dapat menentukan label dan anotasi kustom untuk menambahkan metadata dinamis, teks informasi, tautan runbook, dan lainnya ke payload peringatan dalam aturan peringatan grup aturan Prometheus. Dalam pemberitahuan metrik berbasis kueri, fungsionalitas serupa disediakan melalui properti kustom.

Identitas Terkelola untuk Notifikasi Berbasis Kueri

Anda harus menggunakan Azure Managed Identities untuk aturan peringatan metrik berbasis kueri.

Identitas terkelola harus memiliki peran Pembaca Pemantauan (atau peran kustom dengan izin yang setara) pada sumber daya tercakup atau AMW.

Jenis MI yang dikelola, termasuk yang Ditugaskan Pengguna dan Ditugaskan Sistem, didukung.

Skema dan properti

Tabel berikut ini memberikan penjelasan tentang skema dan properti untuk aturan pemberitahuan metrik berbasis kueri.

Nama Diperlukan Tipe Description Catatan
Nama Benar string Nama aturan pemberitahuan
lokasi Benar string Lokasi sumber daya Dari wilayah yang didukung dalam pratinjau
identity.type Benar string Jenis identitas terkelola TugasPengguna atau TugasSistem
identity.userAssignedIdentities Benar string ID Sumber Daya identitas terkelola yang Ditetapkan Pengguna Diperlukan jika jenis adalah UserAssigned
properties.enabled False Boolean Aturan aktifkan/nonaktifkan Default = benar
deskripsi properti False string Deskripsi aturan peringatan
properti.keparahan False bilangan bulat Tingkat keparahan peringatan 0-4, defaultnya adalah 3 (informasi)
properties.targetResourceType False string Tipe sumber daya target peringatan
properties.scopes Benar string[] Id sumber daya Azure Id sumber daya AMW (untuk aturan berpusat ruang kerja) atau Id sumber daya Azure lainnya, id grup sumber daya, atau id langganan (untuk aturan berpusat sumber daya). Hanya satu item cakupan yang saat ini didukung.
properties.evaluationFrequency Benar string Interval evaluasi aturan Setara dengan Interval Prometheus.
properti.kriteria.allOf[].nama Benar string Nama kondisi
properties.criteria.allOf[].query Benar string Kueri aturan pemberitahuan Kueri PromQL, setara dengan ekspresi aturan pemberitahuan Prometheus
properties.criteria.allOf[].criterionType False string Jenis kondisi Pengaturan awal adalah StaticThresholdCriterion (ambang batas dinamis tidak didukung dalam pratinjau)
properti.kriteria.periodeGagal.untuk False string Durasi kondisi agar tetap benar sebelum pemberitahuan diaktifkan Setara dengan aturan peringatan Prometheus 'for'. Nilai - 'PT1M', 'PT5M' dll. Defaultnya adalah 0 (langsung diaktifkan)
properties.resolveConfigurations.autoResolved False Boolean Resolusi otomatis pemberitahuan diaktifkan Default = benar
properties.resolveConfigurations.timeToResolve False string Batas waktu penyelesaian otomatis pemberitahuan Default = "PT5M"
properties.actions[].actionGroupId false string daftar ID grup tindakan array grup tindakan yang dilakukan saat pemberitahuan diaktifkan atau diselesaikan
properties.actionProperties.SubjekEmail false string templat untuk subjek email kustom
properties.customProperties false string pasangan kunci/nilai untuk properti kustom peringatan

Wilayah yang didukung

  • US Timur
  • Eropa Barat
  • US Timur 2
  • Eropa Utara
  • US Tengah
  • Barat AS 2
  • UK Selatan
  • Asia Tenggara
  • India Tengah
  • US Barat
  • Jerman Barat Tengah
  • Jepang Timur
  • Kanada Tengah
  • US Tengah Selatan
  • Asia Timur
  • Australia Timur
  • Swedia Tengah
  • Swiss Utara
  • Prancis Tengah
  • UAE Utara
  • Norwegia Timur
  • Korea Tengah
  • Brasil Selatan
  • Barat AS 3
  • Australia Tenggara
  • Afrika Selatan Utara

Langkah selanjutnya

  • Last updated on