Membuat kebijakan pemberitahuan batas metrik

Kebijakan pemberitahuan nilai minimum metrik di Cloud Monitoring mengirimkan notifikasi saat nilai metrik melewati nilai minimum yang Anda tentukan untuk jendela pengujian ulang yang ditentukan. Misalnya, Anda dapat mengonfigurasi kebijakan pemberitahuan untuk membuat pemberitahuan saat pemakaian CPU melebihi 80% selama minimal lima menit.

Konten ini tidak berlaku untuk kebijakan pemberitahuan berbasis log. Untuk mengetahui informasi tentang kebijakan pemberitahuan berbasis log, yang memberi tahu Anda saat pesan tertentu muncul di log, lihat Memantau log.

Untuk menerima notifikasi saat data berhenti masuk atau saat metrik diprediksi akan melanggar batas, lihat Membuat kebijakan pemberitahuan tanpa metrik dan Membuat kebijakan pemberitahuan nilai metrik yang diperkirakan. Untuk membuat kebijakan pemberitahuan secara terprogram menggunakan Cloud Monitoring API, lihat Membuat kebijakan pemberitahuan menggunakan API. Untuk membuat kebijakan pemberitahuan yang menggunakan kueri Monitoring Query Language (MQL) dengan nilai minimum statis atau dinamis, lihat Kebijakan pemberitahuan dengan MQL dan Membuat tingkat keparahan dinamis menggunakan MQL.

Fitur ini hanya didukung untuk project Google Cloud . Untuk konfigurasi App Hub, pilih project host atau project pengelolaan App Hub.

Sebelum memulai

  1. Untuk mendapatkan izin yang diperlukan guna membuat dan mengubah kebijakan pemberitahuan menggunakan konsol Google Cloud , minta administrator untuk memberi Anda peran IAM Monitoring Editor (roles/monitoring.editor) di project Anda. Untuk mengetahui informasi selengkapnya tentang pemberian peran, lihat Mengelola akses ke project, folder, dan organisasi.

    Anda mungkin juga bisa mendapatkan izin yang diperlukan melalui peran khusus atau peran bawaan lainnya.

    Untuk mengetahui informasi selengkapnya tentang peran Cloud Monitoring, lihat Mengontrol akses dengan Identity and Access Management.

  2. Pastikan Anda memahami konsep umum kebijakan pemberitahuan. Untuk mengetahui informasi tentang topik ini, lihat Ringkasan pemberitahuan.

  3. Konfigurasikan saluran notifikasi yang ingin Anda gunakan untuk menerima notifikasi. Untuk tujuan redundansi, sebaiknya buat beberapa jenis saluran notifikasi. Untuk mengetahui informasi selengkapnya, lihat Membuat dan mengelola saluran notifikasi.

Membuat kebijakan pemberitahuan

Untuk membuat kebijakan pemberitahuan yang membandingkan nilai metrik tersebut dengan nilai minimum statis, lakukan hal berikut:

  1. Di konsol Google Cloud , buka halaman  Pemberitahuan:

    Buka Pemberitahuan

    Jika Anda menggunakan kotak penelusuran untuk menemukan halaman ini, pilih hasil yang subjudulnya adalah Monitoring.

  2. Di toolbar konsol Google Cloud , pilih project Google Cloud Anda. Untuk konfigurasi App Hub, pilih project host atau project pengelolaan App Hub.
  3. Pilih Create Policy.

  4. Pilih deret waktu yang akan dipantau:

    1. Klik Select a metric, buka menu untuk memilih jenis resource dan jenis metrik, lalu klik Apply.

      Menu Select a metric berisi fitur yang membantu Anda menemukan jenis metrik yang tersedia:

      • Untuk menemukan jenis metrik tertentu, gunakan Filter bar. Misalnya, jika Anda memasukkan util, Anda membatasi menu untuk menampilkan entri yang menyertakan util. Entri ditampilkan saat lulus pengujian "berisi" yang tidak peka huruf besar/kecil.
      • Untuk menampilkan semua jenis metrik, bahkan yang tidak memiliki data, klik Active. Secara default, menu hanya menampilkan jenis metrik yang memiliki data. Untuk mengetahui informasi selengkapnya, lihat Metrik tidak tercantum dalam menu.

      Anda dapat memantau metrik bawaan atau metrik yang ditentukan pengguna.

    2. Opsional: Untuk memantau subset deret waktu yang cocok dengan jenis metrik dan resource yang Anda pilih di langkah sebelumnya, klik Add filter. Dalam dialog filter, pilih label yang akan digunakan untuk memfilter, pembanding, lalu nilai filter. Misalnya, filter zone =~ ^us.*.a$ menggunakan ekspresi reguler untuk mencocokkan semua data deret waktu yang nama zonanya dimulai dengan us dan diakhiri dengan a. Untuk mengetahui informasi selengkapnya, lihat Memfilter deret waktu yang dipilih.

    3. Opsional: Untuk mengubah cara titik dalam deret waktu diselaraskan, di bagian Transform data, tetapkan kolom Rolling window dan Rolling window function. Misalnya, periode 15 menit dengan max akan menghasilkan nilai maksimum dari 15 menit terakhir.

      Konsol Google Cloud menetapkan nilai default berdasarkan jenis metrik Anda. Jika Anda memantau metrik berbasis log, tetapkan kolom Rolling window ke minimal 10 menit.

      Jika Anda memilih count atau mean untuk Rolling window function, pastikan fungsi tersebut cocok dengan jenis metrik Anda. Fungsi count menghitung titik data, bukan nilainya, dan fungsi mean menghitung rata-rata perubahan per sampel pada metrik DELTA. Untuk memberi tahu total volume atau rasio untuk metrik DELTA, pilih sum, delta, atau rate. Untuk jenis metrik dan jenis nilai yang didukung, lihat Aligner.

      Anda juga dapat memantau tingkat perubahan nilai metrik dengan menggunakan kolom Rolling window function ke percent change. Untuk mengetahui informasi selengkapnya, lihat Memantau tingkat perubahan.

      Untuk mengetahui informasi selengkapnya, lihat Penyelarasan: regularisasi dalam deret

    4. Opsional: Gabungkan deret waktu jika Anda ingin mengurangi jumlah deret waktu yang dipantau oleh kebijakan, atau jika Anda hanya ingin memantau kumpulan deret waktu. Misalnya, daripada memantau penggunaan CPU setiap instance VM, Anda mungkin ingin menghitung rata-rata penggunaan CPU untuk semua VM di suatu zona, lalu memantau rata-rata tersebut. Secara default, deret waktu tidak digabungkan. Untuk informasi umum, lihat Pengurangan: menggabungkan deret waktu.

      Untuk menggabungkan semua deret waktu, lakukan hal berikut:

      1. Di bagian Across time series, klik Expand.
      2. Tetapkan kolom Agregasi deret waktu ke nilai selain none. Misalnya, untuk menampilkan nilai rata-rata deret waktu, pilih mean.
      3. Pastikan kolom Time series group by kosong.

      Untuk menggabungkan, atau mengelompokkan, deret waktu berdasarkan nilai label, lakukan hal berikut:

      1. Di bagian Across time series, klik Expand.
      2. Tetapkan kolom Agregasi deret waktu ke nilai selain none.
      3. Di kolom Time series group by, pilih label yang akan digunakan untuk mengelompokkan.

      Misalnya, jika Anda mengelompokkan menurut label zone, lalu menetapkan kolom agregasi ke nilai mean, diagram akan menampilkan satu deret waktu untuk setiap zona yang memiliki data. Deret waktu yang ditampilkan untuk zona tertentu adalah rata-rata dari semua deret waktu dengan zona tersebut.

    5. Klik Berikutnya.

  5. Konfigurasikan pemicu kondisi:

    1. Biarkan kolom Condition type pada nilai default Threshold.

    2. Opsional: Perbarui menu Pemicu pemberitahuan, yang memiliki nilai berikut:

      • Deret waktu mana pun melanggar: Setelan default. Setiap deret waktu yang melanggar batas untuk seluruh periode pengujian ulang akan menyebabkan kondisi terpenuhi.

      • Persentase deret waktu yang melanggar: Persentase deret waktu harus melanggar batas selama seluruh jendela pengujian ulang sebelum kondisi terpenuhi. Misalnya, Anda dapat diberi tahu saat 50% deret waktu yang dipantau melanggar batas untuk seluruh periode pengujian ulang.

      • Jumlah deret waktu yang melanggar: Jumlah deret waktu tertentu harus melanggar batas untuk seluruh periode pengujian ulang sebelum kondisi terpenuhi. Misalnya, Anda dapat diberi tahu saat 32 deret waktu yang dipantau melanggar nilai minimum untuk seluruh periode pengujian ulang.

      • Semua deret waktu melanggar: Semua deret waktu harus melanggar nilai minimum selama seluruh periode pengujian ulang sebelum kondisi terpenuhi.

      Untuk mengetahui informasi tentang interval yang digunakan Monitoring untuk menyelaraskan dan mengukur data deret waktu, lihat Periode penyelarasan dan periode pengujian ulang.

    3. Masukkan kapan nilai metrik melanggar nilai minimum menggunakan kolom Threshold position dan Threshold value. Misalnya, jika Anda menetapkan nilai ini ke Di atas nilai minimum dan 0.3, pengukuran yang lebih tinggi dari 0.3 akan melanggar nilai minimum.

    4. Opsional: Untuk memilih durasi pengukuran yang harus melanggar nilai minimum sebelum Monitoring mengirimkan notifikasi, luaskan Advanced options, lalu gunakan menu Retest window.

      Nilai defaultnya adalah Tanpa pengujian ulang. Dengan setelan ini, satu pengukuran dapat menghasilkan notifikasi. Untuk mengetahui informasi selengkapnya dan contohnya, lihat Setelan periode dan durasi penyelarasan.

    5. Opsional: Untuk menentukan cara Monitoring mengevaluasi kondisi saat data berhenti masuk, luaskan Advanced options, lalu gunakan menu Evaluation missing data.

      Menu Evaluation missing data dinonaktifkan jika nilai Retest window adalah No retest.

      Kolom "Evaluasi data yang tidak ada" diGoogle Cloud konsol
      		 Ringkasan Detail
      Data tidak ada kosong Notifikasi yang terbuka akan tetap terbuka.
      Notifikasi baru tidak dibuka.

      Untuk kondisi yang terpenuhi, kondisi tersebut akan terus terpenuhi saat data berhenti masuk. Jika pemberitahuan terbuka untuk kondisi ini, pemberitahuan akan tetap terbuka. Saat pemberitahuan terbuka dan tidak ada data yang masuk, timer penutupan otomatis akan dimulai setelah penundaan minimal 15 menit. Jika timer berakhir, pemberitahuan akan ditutup.

      Untuk kondisi yang tidak terpenuhi, kondisi tersebut akan terus tidak terpenuhi saat data berhenti masuk.
      Titik data yang tidak ada diperlakukan sebagai nilai yang melanggar kondisi kebijakan Notifikasi yang terbuka akan tetap terbuka.
      Notifikasi baru dapat dibuka.

      Untuk kondisi yang terpenuhi, kondisi tersebut akan terus terpenuhi saat data berhenti masuk. Jika pemberitahuan terbuka untuk kondisi ini, pemberitahuan akan tetap terbuka. Jika pemberitahuan terbuka dan tidak ada data yang masuk selama durasi tutup otomatis ditambah 24 jam, pemberitahuan akan ditutup.

      Untuk kondisi yang tidak terpenuhi, setelan ini menyebabkan kondisi nilai minimum metrik berperilaku seperti metric-absence condition. Jika data tidak masuk dalam waktu yang ditentukan oleh periode pengujian ulang, kondisi akan dievaluasi sebagai terpenuhi. Untuk kebijakan pemberitahuan dengan satu kondisi, kondisi yang terpenuhi akan menyebabkan pemberitahuan dibuka.
      Titik data yang tidak ada diperlakukan sebagai nilai yang tidak melanggar kondisi kebijakan Notifikasi terbuka ditutup.
      Notifikasi baru tidak dibuka.

      Untuk kondisi yang terpenuhi, kondisi tersebut akan berhenti terpenuhi saat data berhenti masuk. Jika pemberitahuan terbuka untuk kondisi ini, pemberitahuan akan ditutup.

      Untuk kondisi yang tidak terpenuhi, kondisi tersebut akan terus tidak terpenuhi saat data berhenti masuk.

    6. Klik Berikutnya.

  6. Opsional: Buat kebijakan pemberitahuan dengan beberapa kondisi.

    Sebagian besar kebijakan memantau satu jenis metrik, misalnya, kebijakan mungkin memantau jumlah byte yang ditulis ke instance VM. Jika Anda ingin memantau beberapa jenis metrik, buat kebijakan dengan beberapa kondisi. Setiap kondisi memantau satu jenis metrik. Setelah membuat kondisi, Anda menentukan cara penggabungan kondisi tersebut. Untuk mengetahui informasinya, lihat Kebijakan dengan beberapa kondisi.

    Untuk membuat kebijakan pemberitahuan dengan beberapa kondisi, lakukan langkah berikut:

    1. Untuk setiap kondisi tambahan, klik Add alert condition, lalu konfigurasikan kondisi tersebut.
    2. Klik Berikutnya dan konfigurasikan cara penggabungan kondisi.
    3. Klik Next untuk melanjutkan ke penyiapan notifikasi dan dokumentasi.

  7. Konfigurasikan notifikasi dan tambahkan label pengguna:

    1. Luaskan menu Notifications and name, lalu pilih saluran notifikasi Anda. Untuk tujuan redundansi, sebaiknya tambahkan beberapa jenis saluran notifikasi ke kebijakan pemberitahuan. Untuk mengetahui informasi selengkapnya, lihat Mengelola saluran notifikasi.

    2. Opsional: Untuk menggunakan baris subjek kustom dalam notifikasi, bukan baris subjek default, perbarui kolom Notification subject line.

    3. Opsional: Untuk menerima notifikasi saat pemberitahuan ditutup, pilih Notify on alert closure. Secara default, saat Anda membuat kebijakan pemberitahuan dengan konsol Google Cloud , notifikasi hanya dikirim saat pemberitahuan dibuat.

    4. Opsional: Untuk mengubah durasi tunggu Monitoring sebelum menutup pemberitahuan setelah data berhenti masuk, pilih opsi dari menu Alert autoclose duration. Secara default, saat data berhenti masuk, Monitoring akan menunggu tujuh hari sebelum menutup pemberitahuan yang terbuka.

    5. Opsional: Untuk mengaitkan kebijakan pemberitahuan Anda dengan aplikasi App Hub, di bagian Label aplikasi, pilih aplikasi dan layanan atau workload. Pemberitahuan dan notifikasi menampilkan label ini.

    6. Opsional: Pilih opsi dari menu Tingkat keparahan kebijakan. Notifikasi dan pemberitahuan menampilkan tingkat keparahan.

    7. Opsional: Untuk menambahkan label kustom ke kebijakan pemberitahuan, di bagian Label pengguna kebijakan, lakukan hal berikut:

      1. Klik Add label, dan di kolom Key, masukkan nama untuk label. Nama label harus diawali dengan huruf kecil, dan dapat berisi huruf kecil, angka, garis bawah, dan tanda hubung. Misalnya, masukkan severity.
      2. Klik Value dan masukkan nilai untuk label Anda. Nilai label dapat berisi huruf kecil, angka, garis bawah, dan tanda hubung. Misalnya, masukkan critical.

      Untuk mengetahui informasi tentang cara menggunakan label kebijakan untuk membantu Anda mengelola notifikasi, lihat Memberi anotasi pada pemberitahuan dengan label.

  8. Opsional: Di bagian Documentation, masukkan konten apa pun yang ingin Anda sertakan dalam notifikasi.

    Untuk memformat dokumentasi, Anda dapat menggunakan teks biasa, Markdown, dan variabel. Anda juga dapat menyertakan link untuk membantu pengguna men-debug pemberitahuan, seperti link ke playbook internal, Google Cloud dasbor, dan halaman eksternal. Misalnya, template dokumentasi berikut menjelaskan pemberitahuan pemakaian CPU untuk resource gce_instance dan menyertakan beberapa variabel untuk mereferensikan kebijakan pemberitahuan dan resource REST kondisi. Template dokumentasi kemudian mengarahkan pembaca ke halaman eksternal untuk membantu proses debug.

    Saat notifikasi dibuat, Monitoring mengganti variabel dokumentasi dengan nilainya. Nilai hanya menggantikan variabel dalam notifikasi. Panel pratinjau dan tempat lain di konsol Google Cloud hanya menampilkan pemformatan Markdown.

    Pratinjau

    ## CPU utilization exceeded

### Summary

The ${metric.display_name} of the ${resource.type}
${resource.label.instance_id} in the project ${resource.project} has
exceeded 90% for over 15 minutes.

### Additional resource information

Condition resource name: ${condition.name}  
Alerting policy resource name: ${policy.name}  

### Troubleshooting and Debug References

Repository with debug scripts: example.com  
Internal troubleshooting guide: example.com  
${resource.type} dashboard: example.com

    Format dalam notifikasi

    Contoh cara dokumentasi dirender dalam notifikasi.

    Untuk mengetahui informasi selengkapnya, lihat Menganotasi notifikasi dengan dokumentasi yang ditentukan pengguna dan Menggunakan kontrol saluran.

  9. Klik Nama pemberitahuan dan masukkan nama untuk kebijakan pemberitahuan itu.

  10. Klik Create policy.

Memfilter deret waktu yang dipilih

Filter memastikan bahwa hanya deret waktu yang memenuhi beberapa kumpulan kriteria yang dipantau. Saat menerapkan filter, Anda dapat mengurangi jumlah garis pada diagram, yang dapat meningkatkan performa diagram. Anda juga dapat mengurangi jumlah data yang dipantau dengan menerapkan agregasi. Filter memastikan bahwa hanya deret waktu yang memenuhi beberapa kumpulan kriteria yang digunakan. Saat Anda menerapkan filter, deret waktu yang perlu dievaluasi akan lebih sedikit, sehingga dapat meningkatkan performa pemberitahuan.

Filter terdiri dari label, pembanding, dan nilai. Misalnya, untuk mencocokkan semua deret waktu yang label zone-nya dimulai dengan "us-central1", Anda dapat menggunakan filter zone=~"us-central1.*", yang menggunakan ekspresi reguler untuk melakukan perbandingan.

Saat memfilter menurut project ID atau container resource, Anda harus menggunakan operator sama dengan, (=). Saat memfilter menurut label lain, Anda dapat menggunakan pembanding yang didukung. Biasanya, Anda dapat memfilter label metrik dan resource, serta menurut grup resource.

Jika Anda memberikan beberapa kriteria pemfilteran, hanya deret waktu yang memenuhi semua kriteria yang akan dipantau.

Untuk menambahkan filter, klik Add filter, lengkapi dialog, lalu klik Done. Dalam dialog, Anda menggunakan kolom Filter untuk memilih kriteria yang akan digunakan untuk memfilter, memilih operator perbandingan, lalu memilih atau memasukkan nilai. Menu drop-down hanya mencantumkan nilai yang muncul selama seminggu terakhir, tetapi Anda dapat memasukkan nilai apa pun. Setiap baris dalam tabel berikut mencantumkan operator perbandingan, artinya, dan contoh:

OperatorArtiContoh
= Kesetaraan resource.labels.zone = "us-central1-a"
!= Ketidaksetaraan resource.labels.zone != "us-central1-a"
=~ Kesetaraan Regular expression2 monitoring.regex.full_match("^us.*")
!=~ Ketidaksetaraan Regular expression2 monitoring.regex.full_match("^us.*")
starts_with Nilai diawali dengan resource.labels.zone = starts_with("us")
ends_with Nilai diakhiri dengan resource.labels.zone = ends_with("b")
has_substring Nilai berisi resource.labels.zone = has_substring("east")
one_of Salah satu resource.labels.zone = one_of("asia-east1-b", "europe-north1-a")
!starts_with Nilai tidak diawali dengan resource.labels.zone != starts_with("us")
!ends_with Nilai tidak diakhiri dengan resource.labels.zone != ends_with("b")
!has_substring Nilai tidak berisi resource.labels.zone != has_substring("east")
!one_of Nilai bukan salah satu dari resource.labels.zone != one_of("asia-east1-b", "europe-north1-a")

Memecahkan masalah

Bagian ini berisi tips pemecahan masalah.

Metrik tidak tercantum dalam menu metrik yang tersedia

Untuk memantau metrik yang tidak tercantum dalam menu Pilih metrik, lakukan salah satu hal berikut:

  • Untuk membuat kebijakan pemberitahuan yang memantau metrik Google Cloud , luaskan menu Select a metric, lalu klik Active. Jika dinonaktifkan, menu akan mencantumkan semua metrik untuk layananGoogle Cloud , dan semua metrik dengan data.

  • Untuk mengonfigurasi kondisi bagi jenis metrik kustom sebelum jenis metrik tersebut menghasilkan data, Anda harus menentukan jenis metrik menggunakan filter Monitoring:

    1. Pilih ? di header bagian Select metric, lalu pilih Direct filter mode di tooltip.

    2. Masukkan filter pemantauan atau pemilih deret waktu. Untuk mengetahui informasi tentang sintaksis, lihat dokumen berikut:

Memantau tingkat perubahan

Untuk memantau laju perubahan nilai metrik, tetapkan kolom Rolling window function ke percent change. Saat kondisi dievaluasi, Monitoring menghitung tingkat perubahan metrik sebagai persentase, lalu membandingkan persentase tersebut dengan nilai minimum kondisi. Proses perbandingan ini mengikuti dua langkah:

  1. Jika deret waktu memiliki jenis metrik DELTA atau CUMULATIVE, deret waktu tersebut akan dikonversi menjadi deret waktu yang memiliki jenis metrik GAUGE. Untuk informasi tentang konversi, lihat Jenis, tipe, dan konversi.
  2. Monitoring menghitung persentase yang berubah dengan membandingkan nilai rata-rata dalam periode pengamatan 10 menit terbaru dengan nilai rata-rata dari periode pengamatan 10 menit sebelum awal periode penyelarasan.

Anda tidak dapat mengubah periode pengamatan 10 menit yang digunakan untuk perbandingan dalam kebijakan pemberitahuan laju perubahan. Namun, Anda menentukan periode penyelarasan saat membuat kondisi.

Langkah berikutnya