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:

• Ketika error pertama kali terjadi dalam project Google Cloud, dan error tersebut tidak dapat dikelompokkan dengan error sebelumnya.

• Jika error yang ditandai sebagai Terselesaikan terjadi kembali.

Kelola saluran notifikasi

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

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

Sebelum memulai

Untuk mendapatkan izin yang diperlukan untuk melihat dan mengonfigurasi saluran notifikasi dengan 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.

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

Untuk mengetahui informasi lebih lanjut tentang peran Cloud Monitoring, baca artikel Mengontrol akses dengan Identity and Access Management.

Buat saluran notifikasi

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

Email

Untuk menambahkan saluran notifikasi email, lakukan hal berikut:

1. Pada panel navigasi Konsol Google Cloud, pilih Monitoring, lalu pilih  Alerting:

   Buka Alerting

2. Klik Edit saluran notifikasi.
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].

Apl Seluler

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

• Perangkat menunjukkan bahwa notifikasi hanya dikirimkan 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 Google Cloud Console.

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 Google Cloud Console dari app store perangkat seluler Anda.

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

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

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

Slack

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

Untuk menyiapkan notifikasi Slack, lakukan langkah berikut:

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

2. Pada panel navigasi Konsol Google Cloud, pilih Monitoring, lalu pilih  Alerting:

   Buka Alerting

3. Klik Edit saluran notifikasi.

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 membawa Anda kembali ke halaman konfigurasi Monitoring untuk saluran notifikasi.
   3. Di kolom Slack Channel Name, masukkan nama saluran 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 Notifications channel.
   5. (Opsional) Untuk menguji koneksi antara Cloud Monitoring dan ruang kerja Slack Anda, klik Send test notification. 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 tanda terima.

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

   1. Buka Slack.

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

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

      /invite @Google Cloud Monitoring

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

Webhook

Catatan: Webhook hanya mendukung endpoint publik.

Catatan: Jika Cloud Function dikonfigurasi sebagai endpoint webhook untuk saluran notifikasi, pastikan pengguna yang memanggil fungsi tersebut memiliki izin autentikasi yang diperlukan. Untuk mengetahui informasi selengkapnya, lihat Mengautentikasi fungsi ke panggilan fungsi dan Mengaktifkan akses ke fungsi.

Untuk mengonfigurasi notifikasi Webhook, lakukan hal berikut:

1. Pengendali webhook: Mengidentifikasi URL endpoint publik untuk menerima data webhook dari Monitoring.

2. Pada panel navigasi Konsol Google Cloud, pilih Monitoring, lalu pilih  Alerting:

   Buka Alerting

3. Klik Edit saluran notifikasi.
4. Di bagian Webhook, klik Add new.
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

Guna melihat struktur skema Webhook untuk Error Reporting, klik opsi 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 referensi berikut:

• Spesifikasi RFC
• Autentikasi dasar

Autentikasi token

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

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

Jika Monitoring memposting insiden ke URL endpoint, server Anda dapat memvalidasi token yang terpasang. Metode autentikasi ini paling efektif saat digunakan dengan SSL/TLS untuk mengenkripsi permintaan HTTP yang mencegah pengintai mempelajari token.

Untuk server contoh di Python, lihat server contoh ini.

Mengedit dan menghapus saluran notifikasi

Untuk mengedit atau menghapus saluran notifikasi menggunakan Google Cloud Console, lakukan langkah berikut:

1. Pada panel navigasi Konsol Google Cloud, pilih Monitoring, lalu pilih  Alerting:

   Buka Alerting

2. Klik Edit saluran notifikasi.

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

   • Untuk mengubah entri, klik Edit. Klik Save setelah perubahan Anda selesai.
   • Untuk menghapus entri, klik Hapus. Klik Delete 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 dengan API.

Memilih saluran notifikasi melalui konsol Google Cloud

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

• Pengguna Error Reporting
• Admin Error Reporting
• Editor Project
• Pemilik Project

Untuk memilih tujuan pengiriman notifikasi saat ada grup error baru, selesaikan langkah-langkah berikut.

1. Pada panel navigasi Google Cloud Console, pilih Error Reporting, lalu pilih project Google Cloud Anda:

   Buka Error Reporting

2. Klik Konfigurasi notifikasi untuk membuka halaman Notifikasi error.

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, Anda harus memiliki peran yang tercantum dalam Membuat saluran.

4. Setelah memilih saluran, klik Simpan.

Informasi tambahan

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

Kapan notifikasi dikirim

Error Reporting mengirim notifikasi dalam dua skenario:

• Saat grup error belum pernah dilihat oleh Error Reporting.
• Saat terjadi error pada grup error yang sudah ada dan status grup error tersebut disetel ke Resolved.

Agar dapat menerima notifikasi mendatang untuk grup error, Anda harus menyetel 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 kapasitas notifikasi

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

• Maksimal 5 notifikasi karena sebuah error dapat dikirimkan dalam periode 60 menit.

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

  • Anda akan menerima notifikasi bahwa notifikasi selengkapnya akan disenyapkan selama enam jam ke depan.

  • Entri log dengan tingkat keparahan peringatan ditulis.

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

Status penyelesaian

Jika error dengan status resolusi Resolved muncul kembali, meskipun sebelumnya error tersebut telah dihapus, status penyelesaiannya akan berubah kembali menjadi Open dan Error Reporting akan mengirimkan notifikasi.

Error Reporting tidak akan mengirim notifikasi jika error Dibisukan terjadi kembali.

Untuk mengelola status penyelesaian error, buka Mengelola error.

Notifikasi seluler

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

Mendownload aplikasi Google Cloud