Mengelola kebijakan pemberitahuan

Dokumen ini menjelaskan cara mengedit, mencantumkan, dan melihat kebijakan pemberitahuan Anda menggunakan konsol Google Cloud. Misalnya, panduan ini menjelaskan cara mengedit kebijakan sehingga dikaitkan dengan aplikasi App Hub. Halaman ini juga menjelaskan cara melihat representasi JSON kebijakan, cara menambahkan kebijakan pemberitahuan ke dasbor kustom, yang memungkinkan Anda melihat kebijakan dalam konteks yang sama dengan data metrik.

Dokumen ini tidak menjelaskan cara mengedit, mencantumkan, dan melihat kebijakan pemberitahuan Anda menggunakan Cloud Monitoring API. Untuk mengetahui informasi selengkapnya, lihat Mengelola kebijakan pemberitahuan menurut API.

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

Sebelum memulai

Selesaikan langkah-langkah berikut di project Google Cloud yang menyimpan kebijakan pemberitahuan Anda:

  1. Untuk mendapatkan izin yang Anda perlukan 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 cara memberikan 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 informasi selengkapnya tentang peran Cloud Monitoring, lihat Mengontrol akses dengan Identity and Access Management.

  2. Pastikan Anda sudah memahami konsep umum kebijakan pemberitahuan. Untuk mengetahui informasi selengkapnya, lihat Ringkasan pemberitahuan.

Mengedit, mencantumkan, atau menghapus kebijakan pemberitahuan

  1. Di konsol Google Cloud, buka halaman  Alerting:

    Buka Pemberitahuan

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

    Halaman Pemberitahuan menampilkan panel yang mencantumkan informasi ringkasan, insiden, dan kebijakan pemberitahuan.

  2. Di toolbar konsol Google Cloud, pilih project Google Cloud Anda. Untuk konfigurasi App Hub, pilih project host App Hub atau project pengelolaan folder yang mengaktifkan aplikasi.

  3. Klik Lihat semua kebijakan di panel Kebijakan.

    Halaman Kebijakan mencantumkan semua kebijakan, menyertakan panel filter, dan untuk setiap kebijakan, opsi untuk mengedit, menyalin, atau menghapus kebijakan:

    • Untuk memfilter daftar kebijakan pemberitahuan, lakukan salah satu tindakan berikut:

      • Masukkan nama di panel filter. Misalnya, untuk hanya menampilkan kebijakan yang namanya berisi Example, masukkan Example. Perbandingan peka huruf besar/kecil menguji apakah kebijakan tercantum.
      • Klik Filter policies, pilih properti filter, lalu masukkan nilai untuk filter atau pilih nilai dari menu.

      Saat Anda menambahkan beberapa filter, AND logis akan menggabungkan filter tersebut.

  4. Opsional: Untuk melihat detail kebijakan, klik nama kebijakan. Untuk informasi tentang halaman Detail kebijakan, lihat Melihat kebijakan pemberitahuan.

  5. Opsional: Untuk mengedit atau menyalin kebijakan, klik Opsi lainnya, lalu pilih opsi yang sesuai. Mengedit dan menyalin kebijakan mirip dengan membuat kebijakan pemberitahuan berbasis metrik. Namun, tidak semua kolom dapat diubah. Setelah selesai, klik Simpan kebijakan.

  6. Opsional: Untuk menghapus kebijakan, klik Opsi lainnya dan pilih Hapus. Dalam dialog konfirmasi, pilih Hapus.

    Jika dasbor berisi diagram yang menampilkan data untuk kebijakan pemberitahuan, diagram tersebut akan berhenti menampilkan data saat kebijakan pemberitahuan dihapus. Untuk mengetahui informasi selengkapnya, lihat Widget kebijakan pemberitahuan tidak menampilkan data apa pun.

Melihat kebijakan pemberitahuan

  1. Di konsol Google Cloud, buka halaman  Alerting:

    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 App Hub atau project pengelolaan folder yang mengaktifkan aplikasi.

  3. Untuk mencantumkan semua kebijakan, klik Lihat semua kebijakan di panel Kebijakan.

  4. Temukan kebijakan yang ingin Anda lihat, lalu pilih kebijakan tersebut.

    Halaman detail untuk kebijakan pemberitahuan akan terbuka. Di sini, Anda dapat memantau atau mengedit kebijakan dan melihat data terkait, seperti insiden dan notifikasi. Selain itu, Anda dapat melakukan hal berikut:

    • Ubah rentang waktu untuk data yang ditampilkan dalam diagram. Diagram memiliki resolusi terbatas dan mungkin tidak menampilkan setiap pengukuran untuk beberapa rentang waktu.

    • Edit pemberitahuan untuk menambahkan label buatan pengguna, yang akan disertakan dalam insiden dan notifikasi Anda. Untuk informasi selengkapnya, lihat Menambahkan anotasi pada insiden dengan label.

    • Ubah status aktif kebijakan. Jika kebijakan dinonaktifkan, Anda tidak akan mendapatkan notifikasi.

Melihat representasi JSON kebijakan pemberitahuan

Saat membuat atau mengubah kebijakan pemberitahuan menggunakan Cloud Monitoring API, Anda memberikan representasi JSON kebijakan tersebut ke metode API. Anda dapat membuat JSON sendiri dengan menggunakan dokumentasi API untuk memandu konten. Alternatifnya adalah membuat kebijakan menggunakan konsol Google Cloud, lalu mendownload kebijakan ke sistem lokal Anda. File JSON yang Anda download dapat diedit dan digunakan sebagai template untuk kebijakan lainnya. Untuk contoh kebijakan yang dijelaskan oleh JSON, lihat Contoh kebijakan.

Untuk mendownload representasi JSON kebijakan pemberitahuan, lakukan hal berikut:

  1. Di konsol Google Cloud, buka halaman  Alerting:

    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 App Hub atau project pengelolaan folder yang mengaktifkan aplikasi.
  3. Temukan kebijakan yang ingin Anda lihat, lalu klik nama kebijakan untuk membuka halaman Detail kebijakan.
  4. Klik JSON.

Untuk melihat representasi JSON kebijakan pemberitahuan saat Anda mengeditnya, klik  Lihat kode.

Menambahkan kebijakan pemberitahuan ke dasbor

Untuk melihat kebijakan pemberitahuan dalam konteks yang sama dengan data metrik, tambahkan kebijakan tersebut ke dasbor kustom. Saat Anda melihat dasbor tersebut, dasbor tersebut akan menampilkan diagram untuk setiap kebijakan pemberitahuan yang Anda tambahkan. Diagram ini menampilkan metrik yang dipantau, nilai minimum, dan jumlah insiden yang terbuka untuk kebijakan. Diagram ini juga berisi link yang memungkinkan Anda melihat atau mengedit kebijakan.

Anda dapat menambahkan kebijakan dengan satu kondisi ke dasbor kustom. Kebijakan yang berisi beberapa kondisi hanya dapat dilihat dari konteks pemberitahuan.

Untuk menampilkan ringkasan kebijakan pemberitahuan di dasbor kustom, lakukan tindakan berikut:

  1. Di konsol Google Cloud, buka halaman  Dasbor:

    Buka Dasbor

    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 App Hub atau project pengelolaan folder yang mengaktifkan aplikasi.
  3. Pilih dasbor atau klik Buat dasbor.
  4. Di toolbar, klik  Tambahkan widget.
  5. Pada dialog Tambahkan widget, pilih Alert Policy.
  6. Klik Alert policy, lalu pilih kebijakan pemberitahuan. Hanya kebijakan pemberitahuan satu kondisi yang dapat dipilih dari menu Kebijakan pemberitahuan.
  7. Untuk menerapkan perubahan pada dasbor, di toolbar, klik Terapkan. Untuk menghapus perubahan, klik Batal.

Screenshot berikut mengilustrasikan diagram untuk kebijakan pemberitahuan:

Contoh diagram untuk kebijakan pemberitahuan.

Dalam contoh ini, kebijakan pemberitahuan memantau penggunaan CPU dari dua VM yang berbeda. Garis putus-putus menunjukkan nilai minimum kondisi, yang ditetapkan ke 50%. Chip hijau dengan label No incidents menunjukkan bahwa tidak ada insiden terbuka untuk kebijakan pemberitahuan. Jika Anda menempatkan kursor pada chip yang menampilkan jumlah insiden terbuka, dialog akan terbuka yang tertaut ke kebijakan pemberitahuan yang mendasarinya.

Untuk informasi selengkapnya, lihat Menampilkan kebijakan pemberitahuan dan insiden di dasbor.

Mengaitkan kebijakan pemberitahuan dengan aplikasi App Hub

Dengan menambahkan label yang ditentukan pengguna ke kebijakan pemberitahuan, Anda dapat mengaitkannya dengan layanan atau beban kerja yang merupakan bagian dari aplikasi App Hub. Label ini disertakan dalam insiden dan notifikasi, dan kebijakan pemberitahuan juga tercantum di dasbor Pemantauan Aplikasi. Untuk mempelajari label lebih lanjut, lihat artikel Menambahkan anotasi pada insiden dengan label.

Untuk mengaitkan kebijakan pemberitahuan dengan beban kerja atau layanan menggunakan konsol Google Cloud, lakukan hal berikut:

  1. Di konsol Google Cloud, buka halaman  Alerting:

    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 App Hub atau project pengelolaan folder yang mengaktifkan aplikasi.
  3. Temukan kebijakan pemberitahuan, klik Lihat lainnya, pilih Edit, lalu buka bagian Notifikasi dan nama.
  4. Di bagian Application labels, pilih aplikasi, lalu pilih beban kerja atau layanan Anda.
  5. Klik Save policy.

Setelah Anda menyelesaikan langkah-langkah ini, label dengan kunci berikut akan dilampirkan ke kebijakan pemberitahuan Anda. Label ini mengidentifikasi aplikasi dan layanan atau beban kerja Anda:

  • apphub_application_location
  • apphub_application_id
  • apphub_service_id atau apphub_workload_id

Anda juga dapat menambahkan label pengguna ke kebijakan pemberitahuan menggunakan Google Cloud CLI, Terraform, atau Cloud Monitoring API. Namun, Anda harus menggunakan kunci label yang ditampilkan dalam contoh sebelumnya. Untuk informasi selengkapnya, lihat referensi berikut: