Menampilkan peristiwa di dasbor

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.

Anda mungkin melihat jenis peristiwa berikut diaktifkan di dasbor atau tab Observabilitas, meskipun Anda belum memilih jenis peristiwa apa pun:

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:

Diagram yang menampilkan anotasi peristiwa peringatan dan informasi.

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.

  • Jika Anda ingin menampilkan peristiwa Service Health di dasbor, aktifkan Service Health API:

    Mengaktifkan 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:

  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. Pilih dasbor yang ingin Anda lihat.
  3. Di toolbar dasbor, klik Anotasi, lalu pilih jenis peristiwa yang ingin ditampilkan di dasbor.
  4. 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 hanya menampilkan jenis peristiwa 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.

  5. 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. Jika true, tombol berada di posisi on dan peristiwa ditampilkan di dasbor. Jika false, tombol berada di posisi off.
    • Kolom eventType, yang berisi nilai dari enumerasi EventType.
    • 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.

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:

  1. 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.

  2. Pastikan menu Dasbor disetel ke Standar. Peristiwa tidak dapat ditampilkan di dasbor kustom.

  3. 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 membuat kueri terhadap 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:

  1. Jika Anda belum mengonfigurasi saluran notifikasi, 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 channel.
    3. Buka jenis saluran notifikasi yang ingin Anda konfigurasi, klik Tambahkan baru, lalu selesaikan dialog.
  2. Di konsol Google Cloud, buka halaman Logs Explorer:

    Buka Logs Explorer

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

  3. Di toolbar, pilih Create Alert.

  4. Masukkan nama untuk kebijakan pemberitahuan, lalu klik Berikutnya.

  5. 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.

  6. Selesaikan dialog, lalu klik Simpan.

API

Untuk membuat kebijakan pemberitahuan berbasis log menggunakan Cloud Monitoring API, lakukan hal berikut:

  1. 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.

  2. Buat file JSON yang berisi representasi kebijakan pemberitahuan. Untuk mengetahui informasi selengkapnya tentang langkah ini dan contohnya, lihat Mendesain kebijakan pemberitahuan.

  3. 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