Membuat atau mengedit aturan pemberitahuan

Artikel ini memperlihatkan kepada Anda cara membuat aturan pemberitahuan baru atau mengedit aturan pemberitahuan yang sudah ada. Untuk mempelajari selengkapnya tentang pemberitahuan, lihat gambaran umum pemberitahuan.

Anda membuat aturan peringatan dengan menggabungkan:

  • Sumber daya yang akan dipantau.
  • Sinyal atau data dari sumber daya.
  • Kondisi.

Anda kemudian menentukan elemen-elemen ini untuk tindakan pemberitahuan:

Pemberitahuan yang dipicu oleh aturan pemberitahuan ini berisi payload yang menggunakan skema pemberitahuan umum.

Membuat atau mengedit aturan pemberitahuan di portal Azure

Ada beberapa cara agar Anda dapat membuat aturan pemberitahuan baru.

Untuk membuat aturan pemberitahuan baru dari halaman beranda portal:

  1. Di portal, pilih Pantau>Pemberitahuan.

  2. Buka menu + Buat, dan pilih Aturan pemberitahuan.

    Screenshot that shows steps to create a new alert rule.

Untuk membuat aturan pemberitahuan baru dari sumber daya tertentu:

  1. Di portal, navigasikan ke sumber daya.

  2. Pilih Pemberitahuan dari panel kiri, lalu pilih + Buat>aturan Pemberitahuan.

    Screenshot that shows steps to create a new alert rule from a selected resource.

Untuk mengedit aturan pemberitahuan yang sudah ada:

  1. Di portal, baik dari halaman beranda atau dari sumber daya tertentu, pilih Pemberitahuan dari panel kiri.

  2. Pilih Aturan Pemberitahuan.

  3. Pilih aturan pemberitahuan yang ingin Anda edit, lalu pilih Edit.

    Screenshot that shows steps to edit an existing alert rule.

  4. Pilih salah satu tab untuk aturan pemberitahuan untuk mengedit pengaturan.

Mengatur cakupan aturan pemberitahuan

  1. Pada panel Pilih sumber daya , atur cakupan untuk aturan pemberitahuan Anda. Anda dapat memfilter berdasarkan langganan, jenis sumber daya, atau lokasi sumber daya.

  2. Pilih Terapkan.

  3. Pilih Berikutnya: Kondisi di bagian bawah halaman.

    Screenshot that shows the select resource pane for creating a new alert rule.

Mengatur kondisi aturan pemberitahuan

  1. Pada tab Kondisi , saat Anda memilih bidang Nama sinyal, sinyal yang paling umum digunakan ditampilkan di daftar drop-down. Pilih salah satu sinyal populer ini, atau pilih Lihat semua sinyal jika Anda ingin memilih sinyal yang berbeda untuk kondisi tersebut.

    Screenshot that shows popular signals when creating an alert rule.

  2. (Opsional) Jika Anda memilih untuk Melihat semua sinyal di langkah sebelumnya, gunakan panel Pilih sinyal untuk mencari nama sinyal atau memfilter daftar sinyal. Filter menurut:

    • Jenis sinyal: Jenis aturan pemberitahuan yang Anda buat.
    • Sumber sinyal: Layanan mengirim sinyal. Daftar telah diisi sebelumnya berdasarkan jenis aturan pemberitahuan yang Anda pilih.

    Tabel ini menjelaskan layanan yang tersedia untuk setiap jenis aturan pemberitahuan:

    Jenis sinyal Sumber sinyal Deskripsi
    Metrik Platform Untuk sinyal metrik, layanan monitor adalah namespace layanan metrik. "Platform" berarti metrik disediakan oleh penyedia sumber daya, yaitu, Azure.
    Azure.ApplicationInsights Metrik yang dilaporkan pelanggan, dikirim oleh SDK Application Insights.
    Azure.VM.Windows.GuestMetrics Metrik tamu VM, dikumpulkan oleh ekstensi yang berjalan pada VM. Dapat mencakup penghitung perf sistem operasi bawaan dan penghitung perf kustom.
    <namespace layanan kustom Anda> Namespace metrik kustom, yang berisi metrik kustom yang dikirim dengan API Metrik Azure Monitor.
    Log Analitik Log Layanan yang menyediakan sinyal "Pencarian log kustom" dan "Log (kueri tersimpan)".
    Log aktivitas Log aktivitas – Administratif Layanan yang menyediakan peristiwa log aktivitas Administratif.
    Log aktivitas – Kebijakan Layanan yang menyediakan peristiwa log aktivitas Kebijakan.
    Log aktivitas – Skala otomatis Layanan yang menyediakan peristiwa log aktivitas Skala Otomatis.
    Log aktivitas – Keamanan Layanan yang menyediakan peristiwa log aktivitas Keamanan.
    Kondisi sumber daya Kondisi sumber daya Layanan yang menyediakan status kesehatan tingkat sumber daya.
    Kondisi layanan Kondisi layanan Layanan yang menyediakan status kesehatan tingkat langganan.

    Pilih Nama sinyal dan Terapkan.

  3. Ikuti langkah-langkah di tab yang sesuai dengan jenis peringatan yang Anda buat.

    1. Pratinjau hasil sinyal metrik yang dipilih di bagian Pratinjau . Pilih nilai untuk bidang berikut ini.

      Bidang Deskripsi
      Rentang waktu Rentang waktu untuk disertakan dalam hasil. Bisa dari enam jam terakhir hingga minggu lalu.
      Deret waktu Rangkaian waktu untuk disertakan dalam hasil.
    2. Di bagian Logika peringatan:

      Bidang Deskripsi
      Ambang Pilih apakah ambang harus dievaluasi berdasarkan nilai statis atau nilai dinamis.
      Ambang statis mengevaluasi aturan dengan menggunakan nilai ambang batas yang Anda konfigurasikan.
      Ambang batas dinamis menggunakan algoritma pembelajaran mesin untuk terus mempelajari pola perilaku metrik dan menghitung ambang yang sesuai untuk perilaku tak terduga. Anda dapat mempelajari selengkapnya tentang menggunakan ambang dinamis untuk peringatan metrik.
      Operator Pilih operator yang digunakan untuk membandingkan nilai metrik dengan ambang.
      Jika Anda menggunakan ambang batas dinamis, aturan pemberitahuan dapat menggunakan ambang batas yang disesuaikan berdasarkan perilaku metrik untuk batas atas dan bawah dalam aturan pemberitahuan yang sama. Pilih salah satu operator ini:
      - Lebih besar dari ambang batas atas atau lebih rendah dari ambang batas bawah (default)
      - Lebih besar dari ambang batas atas
      - Lebih rendah dari ambang batas bawah
      Jenis agregasi Pilih fungsi agregasi untuk diterapkan pada poin data: Jumlah, Hitung, Rata-Rata, Min, atau Maks.
      Ambang nilai Jika Anda memilih ambang statis, masukkan nilai ambang untuk logika kondisi.
      Unit Jika sinyal metrik yang dipilih mendukung unit yang berbeda, seperti byte, KB, MB, dan GB, dan jika Anda memilih ambang statis , masukkan unit untuk logika kondisi.
      Sensitivitas ambang Jika Anda memilih ambang batas dinamis, masukkan tingkat sensitivitas. Tingkat sensitivitas memengaruhi jumlah penyimpangan dari pola seri metrik yang diperlukan untuk memicu pemberitahuan.
      - Tinggi: Ambang batas ketat dan dekat dengan pola seri metrik. Aturan pemberitahuan dipicu pada penyimpangan terkecil, menghasilkan lebih banyak pemberitahuan.
      - Sedang: Ambang batas kurang ketat dan lebih seimbang. Ada lebih sedikit pemberitahuan daripada dengan sensitivitas tinggi (default).
      - Rendah: Ambang longgar, memungkinkan penyimpangan yang lebih besar dari pola seri metrik. Aturan pemberitahuan hanya dipicu pada penyimpangan besar, menghasilkan lebih sedikit pemberitahuan.
      Granuralitas agregasi Pilih interval yang digunakan untuk mengelompokkan titik data dengan menggunakan fungsi jenis agregasi. Pilih granularitas agregasi (periode) yang lebih besar dari Frekuensi evaluasi untuk mengurangi kemungkinan hilangnya periode evaluasi pertama dari rangkaian waktu tambahan.
      Frekuensi evaluasi Pilih seberapa sering aturan pemberitahuan akan dijalankan. Pilih frekuensi yang lebih kecil dari granularitas agregasi untuk menghasilkan jendela geser untuk evaluasi.
    3. (Opsional) Bergantung pada jenis sinyal, Anda mungkin melihat bagian Pisahkan menurut dimensi.

      Dimensi adalah pasangan nama-nilai yang berisi lebih banyak data tentang nilai metrik. Dengan menggunakan dimensi, Anda dapat memfilter metrik dan memantau rangkaian waktu tertentu, alih-alih memantau agregat semua nilai dimensi.

      Jika Anda memilih lebih dari satu nilai dimensi, setiap deret waktu yang dihasilkan dari kombinasi akan memicu pemberitahuannya sendiri dan akan diisi secara terpisah. Misalnya, metrik transaksi akun penyimpanan dapat memiliki dimensi nama API yang berisi nama API yang dipanggil oleh setiap transaksi (misalnya, GetBlob, DeleteBlob, dan PutPage). Anda dapat memilih untuk mengaktifkan pemberitahuan saat ada sejumlah besar transaksi dalam API tertentu (data agregat). Atau Anda dapat menggunakan dimensi untuk memperingatkan hanya ketika jumlah transaksi tinggi untuk API tertentu.

      Bidang Deskripsi
      Nama dimensi Dimensi dapat berupa kolom angka atau string. Dimensi digunakan untuk memantau deret waktu tertentu dan memberikan konteks pada pemberitahuan yang diaktifkan.
      Pemisahan pada kolom Azure Resource ID membuat sumber daya yang ditentukan menjadi target pemberitahuan. Jika terdeteksi, kolom ResourceID dipilih secara otomatis dan mengubah konteks pemberitahuan yang dinyalakan ke sumber daya rekaman.
      Operator Operator yang digunakan pada nama dan nilai dimensi.
      Nilai dimensi Nilai dimensi yang ditampilkan didasarkan pada data dari 48 jam terakhir. Pilih Tambahkan nilai kustom untuk menambahkan nilai dimensi kustom.
      Sertakan semua nilai di masa mendatang Pilih bidang ini untuk menyertakan nilai di masa mendatang yang ditambahkan ke dimensi yang dipilih.
    4. (Opsional) Di bagian Kapan harus mengevaluasi :

      Bidang Deskripsi
      Periksa setiap Pilih seberapa sering aturan pemberitahuan memeriksa apakah kondisi terpenuhi.
      Periode lookback Pilih seberapa jauh ke belakang untuk melihat setiap kali data dicentang. Misalnya, setiap 1 menit, lihat kembali 5 menit.
    5. (Opsional) Di bagian Opsi tingkat lanjut, Anda dapat menentukan berapa banyak kegagalan dalam periode waktu tertentu yang memicu pemberitahuan. Misalnya, Anda dapat menentukan bahwa Anda hanya ingin memicu pemberitahuan jika ada tiga kegagalan dalam satu jam terakhir. Kebijakan bisnis aplikasi Anda harus menentukan pengaturan ini.

      Pilih nilai untuk bidang-bidang berikut:

      Bidang Deskripsi
      Jumlah pelanggaran Jumlah pelanggaran dalam jangka waktu yang dikonfigurasi yang memicu pemberitahuan.
      Periode evaluasi Periode waktu di mana jumlah pelanggaran terjadi.
      Abaikan data sebelumnya Gunakan pengaturan ini untuk memilih tanggal mulai menggunakan data historis metrik untuk menghitung ambang batas dinamis. Misalnya, jika sumber daya berjalan dalam mode pengujian dan dipindahkan ke produksi, Anda mungkin ingin mengabaikan perilaku metrik saat sumber daya sedang dalam pengujian.
    6. Pilih Selesai.

    Mulai saat ini, Anda dapat memilih tombol Tinjau + buat kapan saja.

Mengatur tindakan aturan pemberitahuan

  1. Pada tab Tindakan, pilih atau buat grup tindakan yang diperlukan.

    Screenshot that shows the Actions tab when creating a new alert rule.

Mengatur detail aturan pemberitahuan

  1. Pada tab Detail , tentukan detail Proyek.

    • Pilih Langganan.
    • Pilih Grup sumber daya.
  2. Tentukan Detail aturan peringatan.

    Screenshot that shows the Details tab when creating a new alert rule.

    1. Pilih Tingkat keparahan.

    2. Masukkan nilai untuk Nama aturan peringatan dan Deskripsi aturan peringatan.

    3. (Opsional) Jika Anda membuat aturan pemberitahuan metrik yang memantau metrik kustom dengan cakupan yang didefinisikan sebagai salah satu wilayah berikut dan Anda ingin memastikan bahwa pemrosesan data untuk aturan pemberitahuan berlangsung dalam wilayah tersebut, Anda dapat memilih untuk memproses aturan pemberitahuan di salah satu wilayah ini:

      • Eropa Utara
      • Eropa Barat
      • Swedia Tengah
      • Jerman Barat Tengah

      Kami terus menambahkan lebih banyak wilayah untuk pemrosesan data wilayah.

    4. (Opsional) Di bagian Opsi tingkat lanjut, Anda dapat mengatur beberapa opsi.

      Bidang Deskripsi
      Aktifkan saat pembuatan Pilih agar aturan peringatan mulai berjalan segera setelah Anda selesai membuatnya.
      Mengatasi peringatan secara otomatis (pratinjau) Pilih untuk menjadikan pemberitahuan berstatus. Saat pemberitahuan bersifat stateful, pemberitahuan diselesaikan saat kondisi tidak lagi terpenuhi.
      Jika Anda tidak memilih kotak centang ini, pemberitahuan metrik tidak memiliki status. Pemberitahuan stateless diaktifkan setiap kali kondisi terpenuhi, bahkan jika pemberitahuan sudah diaktifkan.
      Frekuensi pemberitahuan untuk pemberitahuan metrik stateless berbeda berdasarkan frekuensi aturan pemberitahuan yang dikonfigurasi:
      Frekuensi pemberitahuan kurang dari 5 menit: Meskipun kondisi terus terpenuhi, pemberitahuan dikirim di suatu tempat antara satu dan enam menit.
      Frekuensi pemberitahuan lebih dari 5 menit: Saat kondisi terus terpenuhi, pemberitahuan dikirim antara frekuensi yang dikonfigurasi dan menggandakan nilai frekuensi. Misalnya, untuk aturan pemberitahuan dengan frekuensi 15 menit, pemberitahuan dikirim di suatu tempat antara 15 hingga 30 menit.
  3. (Opsional) Di bagian Properti kustom, jika Anda telah mengonfigurasi grup tindakan untuk aturan pemberitahuan ini, Anda dapat menambahkan properti Anda sendiri untuk disertakan dalam payload pemberitahuan pemberitahuan. Anda dapat menggunakan properti ini dalam tindakan yang disebut oleh grup tindakan, seperti webhook, fungsi Azure, atau tindakan aplikasi logika.

    Properti kustom ditentukan sebagai pasangan kunci:nilai, menggunakan teks statis, nilai dinamis yang diekstrak dari payload pemberitahuan, atau kombinasi keduanya.

    Format untuk mengekstrak nilai dinamis dari payload pemberitahuan adalah: ${<path to schema field>}. Misalnya: ${data.essentials.monitorCondition}.

    Gunakan format skema pemberitahuan umum untuk menentukan bidang dalam payload, apakah grup tindakan yang dikonfigurasi untuk aturan pemberitahuan menggunakan skema umum atau tidak.

    Screenshot that shows the custom properties section of creating a new alert rule.

    Dalam contoh berikut, nilai dalam properti kustom digunakan untuk menggunakan data dari payload yang menggunakan skema pemberitahuan umum:

    Contoh 1

    Contoh ini membuat tag "Detail Tambahan" dengan data mengenai "waktu mulai jendela" dan "waktu akhir jendela".

    • Nama: "Detail Tambahan"
    • Nilai: "Evaluasi windowStartTime: ${data.alertContext.condition.windowStartTime}. windowEndTime: ${data.alertContext.condition.windowEndTime}"
    • Hasil: "AdditionalDetails:Evaluation windowStartTime: 2023-04-04T14:39:24.492Z. windowEndTime: 2023-04-04T14:44:24.492Z"

    Contoh 2 Contoh ini menambahkan data mengenai alasan menyelesaikan atau mengaktifkan pemberitahuan.

    • Nama: "Pemberitahuan ${data.essentials.monitorCondition} alasan"
    • Nilai: "${data.alertContext.condition.allOf[0].metricName} ${data.alertContext.condition.allOf[0].operator} ${data.alertContext.condition.allOf[0].threshold} ${data.essentials.monitorCondition}. Nilainya adalah ${data.alertContext.condition.allOf[0].metricValue}"
    • Hasil: Contoh hasilnya bisa seperti:
      • "Alasan Diselesaikan Pemberitahuan: Persentase CPU GreaterThan5 Diselesaikan. Nilainya adalah 3,585"
      • "Peringatan Alasan diaktifkan": "Persentase CPU GreaterThan5 Diaktifkan. Nilainya adalah 10,585"

    Catatan

    Skema umum menimpa konfigurasi kustom. Oleh karena itu, Anda tidak dapat menggunakan properti kustom dan skema umum untuk pemberitahuan log.

Selesaikan pembuatan aturan pemberitahuan

  1. Pada tab Tag , atur tag yang diperlukan pada sumber daya aturan pemberitahuan.

    Screenshot that shows the Tags tab when creating a new alert rule.

  2. Pada tab Tinjau + buat , aturan divalidasi, dan memberi tahu Anda tentang masalah apa pun.

  3. Saat validasi lolos dan Anda telah meninjau pengaturan, pilih tombol Buat.

    Screenshot that shows the Review and create tab when creating a new alert rule.

Membuat aturan pemberitahuan baru menggunakan CLI

Anda dapat membuat aturan peringatan baru menggunakan Azure CLI. Contoh kode berikut menggunakan Azure Cloud Shell. Anda dapat melihat daftar lengkap dari perintah Azure CLI untuk Azure Monitor.

  1. Di portal, pilih Cloud Shell. Pada perintah , gunakan perintah berikut.

    Untuk membuat aturan pemberitahuan metrik, gunakan az monitor metrics alert create perintah . Anda dapat melihat dokumentasi terperinci tentang perintah buat aturan pemberitahuan metrik di az monitor metrics alert create bagian dokumentasi referensi CLI untuk pemberitahuan metrik.

    Anda dapat membuat aturan peringatan metrik sederhana yang memantau jika Persentase CPU rata-rata di mesin virtual lebih besar dari 90:

     az monitor metrics alert create -n {nameofthealert} -g {ResourceGroup} --scopes {VirtualMachineResourceID} --condition "avg Percentage CPU > 90" --description {descriptionofthealert}
    

Membuat aturan pemberitahuan baru dengan PowerShell

Membuat aturan pemberitahuan baru menggunakan templat ARM

Anda dapat menggunakan templat Azure Resource Manager (templat ARM) untuk mengonfigurasi aturan pemberitahuan secara konsisten di semua lingkungan Anda.

  1. Buat sumber daya baru, menggunakan jenis sumber daya berikut:
    • Untuk pemberitahuan metrik: Microsoft.Insights/metricAlerts
    • Untuk pemberitahuan log: Microsoft.Insights/scheduledQueryRules
    • Untuk log aktivitas, kesehatan layanan, dan pemberitahuan kesehatan sumber daya: microsoft.Insights/activityLogAlerts

    Catatan

    • Pemberitahuan metrik untuk jenis sumber daya ruang kerja Azure Log Analytics (Microsoft.OperationalInsights/workspaces) dikonfigurasi secara berbeda dari pemberitahuan metrik lainnya. Untuk informasi selengkapnya, lihat Templat Sumber Daya untuk Pemberitahuan Metrik untuk Log.
    • Kami menyarankan agar Anda membuat pemberitahuan metrik menggunakan grup sumber daya yang sama dengan sumber daya target Anda.
  2. Salin salah satu templat dari contoh templat ARM ini.
  3. Edit file templat untuk berisi informasi yang sesuai untuk pemberitahuan Anda, dan simpan file sebagai <your-alert-template-file.json>.
  4. Edit file parameter yang sesuai untuk menyesuaikan pemberitahuan, dan simpan sebagai <your-alert-template-file.parameters.json>.
  5. Atur metricName parameter, menggunakan salah satu nilai dalam metrik yang didukung Azure Monitor.
  6. Sebarkan templat menggunakan PowerShell atau CLI.

Properti tambahan untuk templat ARM pemberitahuan log aktivitas

Catatan

  • Pemberitahuan log aktivitas ditentukan di tingkat langganan. Anda tidak dapat menentukan satu aturan pemberitahuan pada lebih dari satu langganan.
  • Mungkin perlu waktu hingga lima menit agar aturan pemberitahuan log aktivitas baru aktif.

Templat ARM untuk pemberitahuan log aktivitas berisi properti tambahan untuk bidang kondisi. Bidang Resource Health, Advisor, dan Service Health memiliki bidang properti tambahan.

Bidang Deskripsi
resourceId ID sumber daya dari sumber daya yang terpengaruh dalam peristiwa log aktivitas tempat pemberitahuan dibuat.
category Kategori peristiwa log aktivitas. Nilai yang mungkin adalah Administrative, , ResourceHealthServiceHealth, Autoscale, Security, Recommendation, atau Policy.
pemanggil Alamat email atau pengidentifikasi Microsoft Entra pengguna yang melakukan operasi peristiwa log aktivitas.
tingkat Tingkat aktivitas dalam peristiwa log aktivitas di mana peringatan harus dibuat. Nilai yang mungkin adalah Critical, Error, Warning, Informational, atau Verbose.
operationName Nama operasi dalam peristiwa log aktivitas. Nilai yang mungkin adalah Microsoft.Resources/deployments/write.
ResourceGroup Nama grup sumber daya untuk sumber daya yang terpengaruh dalam peristiwa log aktivitas.
resourceProvider Untuk informasi selengkapnya, lihat Penyedia dan jenis sumber daya Azure. Untuk daftar yang memetakan penyedia sumber daya ke layanan Azure, lihat Penyedia sumber daya untuk layanan Azure.
status String yang menjelaskan status operasi dalam peristiwa aktivitas. Kemungkinan nilainya adalah Started, In Progress, Succeeded, Failed, Active, atau Resolved.
subStatus Biasanya, bidang ini adalah kode status HTTP dari panggilan REST yang sesuai. Bidang ini juga dapat menyertakan string lain yang menjelaskan substatus. Contoh kode status HTTP termasuk OK (Kode Status HTTP: 200), No Content (Kode Status HTTP: 204), dan Service Unavailable (Kode Status HTTP: 503), di antara banyak lainnya.
resourceType Jenis sumber daya yang terpengaruh oleh peristiwa. Contohnya Microsoft.Resources/deployments.

Untuk informasi selengkapnya tentang bidang log aktivitas, lihat Skema peristiwa log aktivitas Azure.

Membuat aturan peringatan log aktivitas dari panel Log aktivitas

Anda juga dapat membuat peringatan log aktivitas pada peristiwa mendatang yang mirip dengan peristiwa log aktivitas yang sudah terjadi.

  1. Di portal, buka panel Log aktivitas.

  2. Filter atau temukan peristiwa yang diinginkan. Kemudian buat pemberitahuan dengan memilih Tambahkan pemberitahuan log aktivitas.

    Screenshot that shows creating an alert rule from an activity log event.

  3. Wizard Buat aturan peringatan terbuka, dengan cakupan dan ketentuan aturan peringatan yang sudah disediakan menurut peristiwa log aktivitas yang dipilih sebelumnya. Jika perlu, Anda dapat mengedit dan memodifikasi ruang lingkup dan ketentuan pada tahap ini. Secara default, cakupan dan kondisi yang tepat untuk aturan baru disalin dari atribut peristiwa asli. Misalnya, sumber daya yang tepat tempat peristiwa terjadi, dan nama pengguna atau layanan tertentu yang memulai peristiwa, keduanya disertakan secara default dalam aturan pemberitahuan baru.

    Jika Anda ingin membuat aturan pemberitahuan lebih umum, ubah cakupan dan kondisi yang sesuai. Lihat langkah 3-9 di bagian "Buat aturan pemberitahuan baru di portal Azure."

  4. Ikuti langkah-langkah lainnya dari Membuat aturan peringatan baru di portal Microsoft Azure.

Langkah berikutnya

Melihat dan mengelola instans pemberitahuan Anda