Mengonfigurasi dan mengelola notifikasi

Anda dapat mengonfigurasi Error Reporting untuk mengirim notifikasi error ke saluran notifikasi Cloud Monitoring yang dipilih.

Error Reporting mengirim notifikasi dalam kasus berikut:

• Saat error pertama kali terjadi di project Google Cloud, dan tidak dapat dikelompokkan dengan error sebelumnya.

• Jika error yang ditandai sebagai Selesai terjadi lagi.

Kelola saluran notifikasi

Anda membuat, mengedit, dan menghapus saluran notifikasi di Monitoring. Setelah membuat saluran notifikasi, Anda dapat mengonfigurasi Pelaporan Error untuk menggunakannya.

Pelaporan Error memungkinkan Anda memilih dari empat jenis saluran notifikasi: email, seluler, Slack, dan Webhook.

Sebelum memulai

Untuk mendapatkan izin yang diperlukan guna melihat dan mengonfigurasi saluran notifikasi 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 mengetahui informasi selengkapnya tentang peran Cloud Monitoring, lihat Mengontrol akses dengan Identity and Access Management.

Membuat saluran notifikasi

Untuk membuat saluran notifikasi menggunakan konsol Google Cloud, ikuti petunjuk khusus saluran yang terdapat dalam tabel berikut:

Email

Untuk menambahkan saluran notifikasi email, 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. Klik Edit notification channels.
3. Di bagian Email, klik Tambahkan baru.
4. Masukkan satu alamat email dan deskripsi.
5. Klik Simpan.

Jika Anda menggunakan alamat email grup sebagai saluran notifikasi untuk kebijakan pemberitahuan, konfigurasikan grup untuk menerima email dari [e-mail].

Aplikasi Seluler

Gunakan Aplikasi Seluler konsol Google Cloud untuk memantau resource konsol Google Cloud dan informasi Pemantauan dari mana saja. Notifikasi Aplikasi Seluler konsol Google Cloud dikirim ke perangkat tertentu atau ke pengguna tertentu:

• Perangkat menunjukkan bahwa notifikasi hanya dikirim ke perangkat tertentu yang membuat saluran notifikasi. Untuk saluran notifikasi cakupan perangkat, kolom Nama tampilan menyertakan informasi perangkat.
• Pengguna menunjukkan bahwa notifikasi dikirim ke semua perangkat Anda yang telah menginstal Aplikasi Seluler konsol Google Cloud.

Cloud Monitoring menentukan cakupan notifikasi saat saluran dibuat. Anda tidak dapat memilih atau mengubah cakupan.

Untuk mengonfigurasi saluran notifikasi Aplikasi Seluler konsol Google Cloud untuk project Google Cloud tertentu, lakukan hal berikut:

1. Instal Aplikasi Seluler konsol Google Cloud dari app store perangkat seluler Anda.

2. Pilih project untuk dilihat di Aplikasi Seluler Konsol Google Cloud.

   Setelah Anda memilih project, pertukaran data antara aplikasi dan project Google Cloud yang dipilih akan terjadi. Saluran notifikasi dibuat jika tidak ada, dan setelah beberapa menit, saluran ini akan tercantum di bagian Perangkat Seluler di halaman Saluran notifikasi.

Untuk menambahkan perangkat seluler sebagai saluran notifikasi untuk kebijakan pemberitahuan, di bagian Notifikasi pemberitahuan, pilih Konsol Google Cloud (seluler), lalu pilih perangkat seluler Anda dari daftar.

Slack

Catatan: Untuk menyelesaikan langkah-langkah ini, Anda harus menjadi Admin atau Pemilik Workspace Slack. Untuk informasi selengkapnya, lihat Mengelola permintaan undangan.

Untuk menyiapkan notifikasi Slack, lakukan tindakan berikut:

1. Di Slack: Buat ruang kerja dan saluran Slack di situs Slack. Catat URL channel.

2. Di konsol Google Cloud, buka halaman  Alerting:

   Buka Pemberitahuan

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

3. Klik Edit notification channels.

4. Di bagian Slack, klik Add new untuk membuka halaman login Slack:

   1. Pilih ruang kerja Slack Anda.
   2. Klik Izinkan untuk mengaktifkan akses Cloud Monitoring ke ruang kerja Slack Anda. Tindakan ini akan mengarahkan Anda kembali ke halaman Konfigurasi pemantauan untuk saluran notifikasi Anda.
   3. Di kolom Slack Channel Name, masukkan nama channel Slack yang ingin Anda gunakan untuk notifikasi.
   4. Di kolom Cloud Alerting Display Name, masukkan pernyataan deskriptif singkat. Monitoring menampilkan nilai kolom ini di halaman Notifikasi channel.
   5. (Opsional) Untuk menguji koneksi antara Cloud Monitoring dan ruang kerja Slack, klik Kirim notifikasi pengujian. Jika koneksi berhasil, Anda akan melihat pesan This is a test alert notification... di saluran notifikasi Slack yang Anda tentukan. Periksa saluran notifikasi untuk mengonfirmasi penerimaan.

5. Jika saluran Slack yang ingin Anda gunakan untuk notifikasi adalah saluran pribadi, Anda harus mengundang aplikasi Monitoring ke saluran tersebut secara manual:

   1. Buka Slack.

   2. Buka channel yang Anda tentukan sebagai saluran notifikasi Monitoring.

   3. Undang aplikasi Monitoring ke channel dengan memasukkan dan mengirim pesan berikut di channel:

      /invite @Google Cloud Monitoring

      Pastikan Anda mengundang aplikasi Monitoring ke saluran pribadi yang Anda tentukan saat membuat saluran notifikasi di Monitoring. Mengundang aplikasi Pemantauan ke saluran publik bersifat opsional.

Webhook

Sebelum mengonfigurasi saluran notifikasi Webhook, pertimbangkan hal-hal berikut:

• Webhook hanya mendukung endpoint publik.
• Jika fungsi Cloud Run dikonfigurasi sebagai endpoint webhook untuk saluran notifikasi, pastikan pengguna yang memanggil fungsi tersebut memiliki izin autentikasi yang diperlukan. Untuk informasi selengkapnya, lihat Mengautentikasi untuk pemanggilan dan Mengaktifkan akses ke fungsi.
• Saluran notifikasi Webhook tidak kompatibel dengan Microsoft Teams. Untuk mengirim data notifikasi dari Pemantauan ke Microsoft Teams, buat lapisan integrasi untuk menerima webhook Pemantauan, lalu alihkan ke Microsoft Teams.

Mengonfigurasi saluran notifikasi Webhook

Untuk mengonfigurasi notifikasi Webhook, lakukan hal berikut:

1. Pemroses webhook: Identifikasi URL endpoint publik untuk menerima data webhook dari Monitoring.

2. Di konsol Google Cloud, buka halaman  Alerting:

   Buka Pemberitahuan

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

3. Klik Edit notification channels.
4. Di bagian Webhook, klik Tambahkan baru.
5. Selesaikan dialog.
6. Klik Test Connection untuk mengirim payload pengujian ke endpoint Webhook. Anda dapat membuka endpoint penerima untuk memverifikasi pengiriman.
7. Klik Simpan.

Skema webhook

Untuk melihat struktur skema Webhook untuk Pelaporan Error, klik link berikut:

Struktur skema, versi 1.0

{
  "version": "1.0",
  "subject": string, deskripsi grup error baru atau yang dibuka kembali.
  "group_info": {
    "project_id": string, project yang memiliki grup error.
    "detail_link": string, link ke halaman Error Reporting Details untuk grup error.
  },
  "exception_info": {
    "type": string, jenis pengecualian yang dicatat dalam peristiwa.
    "message": string, pesan pengecualian untuk peristiwa.
  },
  "event_info": {
    "log_message": string
    "request_method": string
    "request_url": string
    "referrer": string
    "user_agent": string
    "service": string
    "version": string
    "response_status": string
  },
}

Autentikasi dasar

Selain permintaan webhook yang dikirim oleh Cloud Monitoring, autentikasi dasar menggunakan spesifikasi HTTP untuk nama pengguna dan sandi. Cloud Monitoring mengharuskan server Anda menampilkan respons 401 dengan header WWW-Authenticate yang tepat. Untuk mengetahui informasi selengkapnya tentang autentikasi dasar, lihat artikel berikut:

• Spesifikasi RFC
• Autentikasi dasar

Autentikasi token

Autentikasi Token memerlukan parameter string kueri di URL endpoint dan kunci yang diharapkan server bersifat rahasia antara server dan Monitoring. Berikut adalah contoh URL yang menyertakan token:

https://www.myserver.com/stackdriver-hook?auth_token=1234-abcd

Jika Pemantauan memposting insiden ke URL endpoint, server Anda dapat memvalidasi token yang terlampir. Metode autentikasi ini paling efektif jika digunakan dengan SSL/TLS untuk mengenkripsi permintaan HTTP sehingga mencegah penyadap mempelajari token.

Untuk contoh server di Python, lihat contoh server ini.

Mengedit dan menghapus saluran notifikasi

Untuk mengedit atau menghapus saluran notifikasi 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. Klik Edit notification channels.

   Dasbor Saluran notifikasi berisi bagian untuk setiap jenis saluran notifikasi. Setiap bagian mencantumkan semua konfigurasi untuk jenis tersebut:

   • Untuk mengubah entri, klik Edit. Klik Simpan setelah perubahan selesai.
   • Untuk menghapus entri, klik Hapus. Klik Hapus di dialog konfirmasi.

Catatan: Anda tidak dapat menghapus saluran notifikasi menggunakan konsol Google Cloud jika saluran tersebut dikaitkan dengan kebijakan pemberitahuan. Namun, Anda dapat menghapus saluran menggunakan Google Cloud CLI atau Cloud Monitoring API. Untuk informasi selengkapnya, lihat Membuat dan mengelola saluran notifikasi melalui API.

Memilih saluran notifikasi melalui konsol Google Cloud

Untuk memilih saluran notifikasi yang ada, Anda harus memiliki salah satu peran berikut:

• Error Reporting User
• Admin Pelaporan Error
• Project Editor
• Pemilik Project

Untuk memilih tempat Anda ingin mengirim notifikasi saat grup error baru terjadi, selesaikan langkah-langkah berikut.

1. Di konsol Google Cloud, buka halaman Pelaporan Error:

   Buka Error Reporting

   Anda juga dapat menemukan halaman ini menggunakan kotak penelusuran.

2. Klik Configure notifications untuk membuka halaman Error notifications.

3. Di menu drop-down Notification channels, pilih saluran yang ingin Anda kirimi notifikasi.

   Jika Anda tidak melihat saluran yang diperlukan, klik Kelola saluran notifikasi untuk membuat saluran baru. Untuk membuat saluran notifikasi, peran Anda harus salah satu yang tercantum di Membuat saluran.

4. Setelah memilih saluran, klik Simpan.

Informasi tambahan

Berikut adalah informasi tambahan yang berlaku saat membuat dan mengelola notifikasi di Pelaporan Error.

Konten notifikasi

Notifikasi untuk grup error berisi informasi yang terkait dengan entri log dalam grup. Informasi yang disertakan bergantung pada jenis resource yang dipantau tempat error terjadi. Misalnya, beberapa notifikasi mungkin berisi nama dan versi resource yang dipantau.

Pesan error hanya disertakan dalam notifikasi jika grup error diidentifikasi oleh entri log di bucket log yang region-nya adalah global.

Kapan notifikasi dikirim

Error Reporting mengirim notifikasi dalam dua skenario:

• Jika grup error belum pernah dilihat oleh Pelaporan Error.
• Saat error terjadi untuk grup error yang ada dan status grup error ditetapkan ke Resolved.

Untuk menerima notifikasi mendatang untuk grup error, Anda harus menetapkan status grup error ke Resolved. Tidak ada tindakan lain, seperti menggunakan API untuk menghapus grup error atau menunggu data habis masa berlakunya, yang akan menghasilkan notifikasi jika terjadi error lain.

Batas frekuensi notifikasi

Pelaporan Error menggunakan aturan berikut untuk membatasi jumlah notifikasi yang mungkin Anda terima karena error:

• Maksimum 5 notifikasi karena error dapat dikirim dalam jangka waktu 60 menit.

• Jika lebih dari 5 error terjadi dalam periode 60 menit, hal berikut akan terjadi:

  • Anda akan menerima notifikasi bahwa notifikasi selanjutnya akan dibisukan selama enam jam ke depan.

  • Entri log dengan tingkat keparahan peringatan akan ditulis.

• Saat Anda menyelesaikan grup error, notifikasi untuk grup error tersebut akan ditangguhkan selama lima menit.

Status penyelesaian

Jika error dengan status penyelesaian Diselesaikan terjadi lagi, meskipun sebelumnya telah dihapus, status penyelesaian akan berubah kembali menjadi Buka dan Pelaporan Error akan mengirimkan notifikasi.

Pelaporan Error tidak akan mengirim notifikasi jika error Diam terjadi lagi.

Untuk mengelola status penyelesaian error, buka Kelola error.

Notifikasi seluler

Error Reporting mengirim notifikasi seluler ke aplikasi Google Cloud di Android dan iOS. Untuk memilih ikut serta dalam notifikasi seluler, Anda harus menginstal aplikasi di perangkat seluler terlebih dahulu:

Mendownload aplikasi Google Cloud