Dokumen ini menjelaskan cara mengonfigurasi dasbor untuk menampilkan anotasi peristiwa. Peristiwa adalah aktivitas, seperti deployment atau error, yang memengaruhi operasi sistem. Menampilkan anotasi peristiwa dapat membantu Anda mengaitkan data dari berbagai sumber saat memecahkan masalah.
Tentang anotasi peristiwa
Anda dapat menampilkan peristiwa di sebagian besar dasbor yang tercantum di halaman Dasbor di konsol Google Cloud. Demikian pula, Anda dapat mengonfigurasi beberapa tab Observabilitas khusus layanan, seperti tab untuk Compute Engine dan Google Kubernetes Engine, untuk menampilkan peristiwa. Untuk mengonfigurasi jenis peristiwa yang ditampilkan oleh dasbor atau di tab Observability, Anda dapat menggunakan Konsol Google Cloud. Untuk dasbor yang Anda buat, yang diklasifikasikan sebagai dasbor kustom, Anda juga dapat menggunakan Cloud Monitoring API.
Kecuali jika Anda menggunakan Cloud Monitoring API atau mengambil tindakan untuk menyimpan pilihan jenis peristiwa, pilihan Anda hanya berlaku untuk sesi saat ini. Saat Anda menggunakan konsol Google Cloud, sematkan pilihan Anda untuk menyimpannya.
Untuk mengetahui daftar jenis peristiwa, referensi pemecahan masalah, dan informasi lainnya, lihat halaman Jenis peristiwa.
Jenis peristiwa yang direkomendasikan
Anda mungkin melihat jenis peristiwa berikut diaktifkan di dasbor atau tab Observabilitas, meskipun Anda belum memilih jenis peristiwa apa pun:
- Notifikasi dibuka.
- Insiden Personalized Service Health, saat Service Health API diaktifkan.
- Untuk setiap jenis resource dengan data yang ditampilkan di dasbor, satu jenis peristiwa.
Jika jenis peristiwa ditambahkan secara otomatis, jenis peristiwa tersebut adalah jenis peristiwa yang direkomendasikan. Anda dapat membiarkan jenis peristiwa ini dalam status yang direkomendasikan, menyimpannya ke JSON dasbor, atau menutupnya, yang akan menghapus rekomendasi. Untuk menentukan jenis peristiwa yang disimpan, luaskan menu Annotations, lalu lihat bagian Pinned.
Cara peristiwa diidentifikasi
Dasbor mengkueri berbagai sumber data untuk mengidentifikasi peristiwa yang akan ditampilkan di dasbor Anda:
Peristiwa pemberitahuan diidentifikasi oleh Pemantauan. Peristiwa pemberitahuan memberikan informasi tentang waktu insiden dibuka.
Peristiwa Personalized Service Health diidentifikasi oleh kueri yang dikirim Pemantauan ke Service Health API. Peristiwa ini menunjukkan kapan terjadi gangguan pada layanan Google Cloud.
Semua jenis peristiwa lainnya diidentifikasi dengan menganalisis entri log yang melewati sink Cloud Logging di project Google Cloud Anda. Entri log ini mencakup entri yang dihasilkan oleh project Anda dan yang dirutekan ke project Anda. Untuk mendapatkan notifikasi saat salah satu peristiwa ini terjadi, Anda dapat membuat kebijakan pemberitahuan berbasis log. Dalam kebijakan pemberitahuan, gunakan kueri yang disediakan di halaman Jenis peristiwa.
Cara peristiwa ditampilkan
Untuk semua peristiwa, saat peristiwa tersebut terjadi, diagram di dasbor Anda akan dianotasi. Peristiwa yang diidentifikasi dengan menganalisis entri log ditampilkan dengan satu referensi waktu. Sebaliknya, peristiwa Kesehatan Layanan ditampilkan dengan waktu mulai, lalu latar belakang diagram diubah selama durasi peristiwa. Peristiwa ini juga menampilkan ikon hati.
Screenshot berikut mengilustrasikan diagram yang menampilkan beberapa peristiwa yang diidentifikasi dengan menganalisis entri log, dan satu peristiwa Kesehatan Layanan:
Seperti yang ditunjukkan pada screenshot sebelumnya, tooltip untuk peristiwa menyertakan informasi seperti berikut:
- Nama peristiwa.
- Tanggal dan waktu mulai acara.
- Untuk peristiwa Service Health, chip yang menampilkan jumlah produk dan lokasi yang terpengaruh. Untuk mencantumkan produk atau lokasi yang terpengaruh, tempatkan kursor pada chip yang sesuai.
- Tombol Lihat, yang jika dipilih akan membuka halaman yang menampilkan informasi selengkapnya tentang peristiwa. Misalnya, tindakan ini dapat membuka Logs Explorer, sehingga Anda dapat melihat entri log, atau dapat membuka halaman detail untuk peristiwa Status Layanan.
Filter dasbor, yang membatasi data yang ditampilkan oleh dasbor, biasanya memfilter data deret waktu dan peristiwa.
Sebelum memulai
-
Untuk mendapatkan izin yang Anda perlukan guna melihat dan menampilkan peristiwa di dasbor, serta untuk membuat kebijakan pemberitahuan, minta administrator untuk memberi Anda peran IAM berikut di project Anda:
-
Melihat dan membuat dasbor serta kebijakan pemberitahuan:
Editor Monitoring (
roles/monitoring.editor
). -
Melihat dan menampilkan peristiwa yang diidentifikasi dari entri log non-akses data yang dibuat di project Google Cloud Anda:
Logs Viewer (
roles/logging.viewer
). -
Melihat dan menampilkan peristiwa yang diidentifikasi dari entri log yang dibuat di project Google Cloud Anda:
Private Logs Viewer (
roles/logging.privateLogViewer
). -
Melihat peristiwa Status Layanan:
Pelihat Status Layanan yang dipersonalisasi (
roles/servicehealth.viewer
)
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.
-
Melihat dan membuat dasbor serta kebijakan pemberitahuan:
Editor Monitoring (
Jika Anda ingin menampilkan peristiwa Service Health di dasbor, aktifkan Service Health API:
Tampilkan peristiwa
Bagian ini menjelaskan cara mengonfigurasi dasbor atau tab Observabilitas untuk menampilkan peristiwa.
Mengonfigurasi dasbor untuk menampilkan peristiwa
Bagian ini menjelaskan cara mengonfigurasi dasbor yang tercantum di halaman Dasbor di Konsol Google Cloud untuk menampilkan peristiwa.
Untuk mengetahui daftar jenis peristiwa, referensi pemecahan masalah, dan kueri yang dapat digunakan dengan Logs Explorer atau dengan kebijakan pemberitahuan berbasis log, lihat halaman Jenis peristiwa.
Konsol
Untuk menampilkan peristiwa di dasbor, lakukan tindakan berikut:
-
Di konsol Google Cloud, buka halaman Dasbor:
Jika Anda menggunakan kotak penelusuran untuk menemukan halaman ini, pilih hasil yang subjudulnya adalah Monitoring.
- Pilih dasbor yang ingin Anda lihat.
- Di toolbar dasbor, klik Anotasi, lalu pilih jenis peristiwa yang ingin ditampilkan di dasbor.
Lakukan salah satu hal berikut:
Untuk menyimpan pilihan Anda sehingga peristiwa ditampilkan saat Anda memuat ulang dasbor, klik Sematkan yang Dipilih. Jika Anda menonaktifkan simpan otomatis di dasbor, buka toolbar dasbor, lalu klik Simpan.
Saat menyematkan pilihan, Anda akan mengubah definisi JSON dashboard. Oleh karena itu, saat dasbor dibuka kembali, pilihan Anda akan dimuat dan dasbor akan menampilkan anotasi untuk jenis peristiwa yang sesuai.
Untuk menampilkan jenis peristiwa hanya untuk sesi saat ini, klik Terapkan.
Setelah Anda memperbarui daftar jenis peristiwa yang akan ditampilkan, Cloud Monitoring akan mengeluarkan kueri, yang memerlukan waktu beberapa saat, lalu menambahkan anotasi ke diagram di dasbor.
Untuk melihat ringkasan peristiwa atau mengakses link ke informasi tambahan, gunakan kursor untuk mengaktifkan tooltip.
API
Untuk mengonfigurasi dasbor kustom agar menampilkan peristiwa,
sertakan kolom annotations
dalam objek Dashboard
.
Kolom annotations
berisi instance objek DashboardAnnotations
,
yang berisi dua kolom:
Kolom
defaultResourceName
mencantumkan default tingkat dasbor untuk project Google Cloud guna menelusuri peristiwa. Jika Anda tidak menentukan kolom ini, project yang dipilih akan ditelusuri.Array objek
EventAnnotation
. Setiap objek berisi hal berikut:- Kolom
displayName
, yang memungkinkan Anda menentukan label pada tombol khusus peristiwa. Jika kolom ini tidak ditentukan atau jika nilai kolom ini adalah string kosong, nama default untuk peristiwa akan ditampilkan. - Kolom
enabled
, yang mengontrol nilai tombol peristiwa. Jikatrue
, tombol berada di posision
dan peristiwa ditampilkan di dasbor. Jikafalse
, tombol berada di posisioff
. - Kolom
eventType
, yang berisi nilai dari enumerasiEventType
. - Kolom
filter
, yang memungkinkan Anda menentukan kueri untuk ditambahkan ke kueri khusus peristiwa. Jika nilai kolom ini adalah string kosong, kueri khusus peristiwa akan digunakan. - Kolom
resourceNames
, yang memungkinkan Anda menentukan daftar project Google Cloud untuk menelusuri peristiwa. Jika kolom ini adalah array kosong, project yang Anda pilih akan ditelusuri.
- Kolom
Berikut adalah contoh objek annotations
untuk peristiwa update
cluster. Kolom filter
dalam contoh ini membatasi peristiwa ke
cluster tertentu:
"annotations": {
"defaultResourceNames": [],
"eventAnnotations": [
{
"displayName": "",
"enabled": true,
"eventType": "GKE_CLUSTER_UPDATE",
"filter": "resource.labels.cluster_name=my-cluster",
"resourceNames": []
}
]
}
Untuk informasi mendetail tentang cara menggunakan Cloud Monitoring API untuk membuat dasbor, lihat Membuat dan mengelola dasbor menurut API dan Contoh: mengaktifkan peristiwa di dasbor.
Mengonfigurasi tab Kemampuan Observasi untuk menampilkan peristiwa
Bagian ini menjelaskan cara mengonfigurasi tab Observability untuk menampilkan peristiwa. Beberapa layanan, seperti Compute Engine dan Google Kubernetes Engine, menyediakan tab Observability yang menampilkan data metrik dan log.
Konsol
Untuk mengonfigurasi tab Observabilitas agar menampilkan peristiwa, lakukan hal berikut:
Buka tab Observability untuk layanan atau produk.
Misalnya, Anda dapat membuka halaman Kubernetes Clusters, lalu memilih tab Observability. Demikian pula, Anda dapat membuka halaman Workload Kubernetes atau halaman detail untuk instance virtual machine (VM), lalu memilih tab Observability.
Pastikan menu Dasbor disetel ke Standar. Peristiwa tidak dapat ditampilkan di dasbor kustom.
Di toolbar, klik Annotations, dan selesaikan dialog.
Setelah Anda memperbarui daftar peristiwa yang akan ditampilkan, kueri akan dikeluarkan untuk mengambil data peristiwa, lalu dasbor akan diperbarui.
Jika menu Annotations tidak ditampilkan, tab tidak dapat dikonfigurasi untuk menampilkan peristiwa.
API
Tidak tersedia.
Melihat detail acara
Saat melihat diagram yang menampilkan anotasi peristiwa, Anda dapat menggunakan link yang disediakan di tooltip untuk mengakses informasi tambahan.
Untuk mengakses detail tentang peristiwa tertentu, klik Lihat.
Halaman konsol Google Cloud yang dibuka oleh tombol Lihat ditentukan oleh jenis peristiwa. Misalnya, untuk peristiwa pemeriksaan uptime, tombol ini akan membuka dasbor untuk pemeriksaan uptime. Untuk jenis peristiwa yang berbeda, Logs Explorer mungkin akan terbuka.
Membuat kebijakan pemberitahuan
Saat peristiwa diidentifikasi dengan menganalisis entri log yang melewati sink Cloud Logging di project Google Cloud, Anda dapat menerima notifikasi saat peristiwa ini terjadi dengan mengonfigurasi pemberitahuan berbasis log. Kebijakan pemberitahuan berbasis log mengkueri entri log saat diterima. Jika kueri menampilkan hasil yang tidak kosong, insiden akan dibuat dan notifikasi akan dikirim.
Konsol
Untuk membuat pemberitahuan berbasis log, lakukan hal berikut:
Jika Anda belum mengonfigurasi saluran notifikasi, lakukan hal berikut:
-
Di konsol Google Cloud, buka halaman notifications Alerting:
Jika Anda menggunakan kotak penelusuran untuk menemukan halaman ini, pilih hasil yang subjudulnya adalah Monitoring.
- Klik Edit notification channel.
- Buka jenis saluran notifikasi yang ingin Anda konfigurasi, klik Tambahkan baru, lalu selesaikan dialog.
-
-
Di konsol Google Cloud, buka halaman Logs Explorer:
Jika Anda menggunakan kotak penelusuran untuk menemukan halaman ini, pilih hasil yang subjudulnya adalah Logging.
Di toolbar, pilih Create Alert.
Masukkan nama untuk kebijakan pemberitahuan, lalu klik Berikutnya.
Di bagian Menentukan entri log yang akan diberi pemberitahuan, masukkan kueri atau perbarui kueri yang disalin dari panel Kueri saat Anda memilih Buat Pemberitahuan.
Untuk setiap jenis peristiwa, halaman Jenis peristiwa mencantumkan kueri yang sesuai untuk digunakan dalam kebijakan pemberitahuan berbasis log.
Selesaikan dialog, lalu klik Simpan.
API
Untuk membuat kebijakan pemberitahuan berbasis log menggunakan Cloud Monitoring API, lakukan hal berikut:
Identifikasi kueri yang akan disertakan dalam kondisi kebijakan pemberitahuan. Untuk setiap jenis peristiwa, halaman Jenis peristiwa mencantumkan kueri yang sesuai untuk digunakan dalam kebijakan pemberitahuan berbasis log.
Buat file JSON yang berisi representasi kebijakan pemberitahuan. Untuk mengetahui informasi selengkapnya tentang langkah ini dan contohnya, lihat Mendesain kebijakan pemberitahuan.
Panggil metode API alertPolicies.create. Misalnya, Anda dapat mengeluarkan perintah
gcloud alpha monitoring policies create
.
Sembunyikan peristiwa
Konsol
Untuk menyembunyikan semua peristiwa, di toolbar dasbor, klik Anotasi, pilih Hapus, lalu pilih Terapkan.
Untuk menyembunyikan satu jenis peristiwa, klik Anotasi, hapus pilihan untuk jenis peristiwa tersebut, lalu pilih Terapkan.
API
Untuk menyembunyikan satu jenis peristiwa di dasbor kustom, temukan objek EventAnnotation
untuk jenis peristiwa, lalu tetapkan kolom enabled
ke false
.
Untuk informasi mendetail tentang cara menggunakan Cloud Monitoring API, lihat Membuat dan mengelola dasbor menurut API.
Langkah selanjutnya
- Membagikan dasbor kustom
- Menjelajahi data dalam diagram
- Mengakses dasbor khusus resource
- Menambahkan filter sementara ke dasbor kustom
- Menambahkan filter permanen ke dasbor kustom