Menampilkan log dan error di dasbor kustom

Anda dapat menambahkan widget log dan error ke dasbor kustom Cloud Monitoring untuk melihat entri log dan grup error bersama data metrik Anda. Widget panel log menampilkan entri log, dan widget panel pelaporan error menampilkan grup error terbaru. Untuk mengidentifikasi tren dalam data log, Anda juga dapat menambahkan widget diagram Observability Analytics, yang menampilkan hasil kueri SQL.

Fitur ini hanya didukung untuk project Google Cloud . Untuk konfigurasi Pusat Aplikasi, pilih project host Pusat Aplikasi atau project pengelolaan.

Logs Explorer dan widget panel log

Logs Explorer adalah cara standar untuk menyelidiki log. Menambahkan widget panel log ke dasbor tidak akan mengubah cara Anda menggunakan Logs Explorer. Karena widget panel log dapat ditambahkan ke dasbor kustom, widget ini memberikan cara untuk melihat entri log dalam konteks yang sama dengan metrik Anda.

Logs Explorer dan widget panel log mendukung bahasa kueri yang sama, dan keduanya hanya menampilkan entri log yang izin aksesnya Anda miliki. Peran Identity and Access Management (IAM) Anda pada resource yang menyimpan entri log menentukan apakah Anda dapat melihat entri log yang disimpan.

Logs Explorer dan widget panel log telah dikonfigurasi sebelumnya untuk menelusuri entri log dari resource yang tercantum dalam cakupan log default. Jika cakupan tersebut tidak dapat diakses, mereka akan menelusuri entri log yang berasal dari project yang Anda pilih. Jika project dipilih, hasil penelusuran akan menyertakan entri log yang dirutekan ke project oleh sink di project lain, lalu disimpan dalam bucket log. Anda dapat mengonfigurasi resource mana yang ditelusuri untuk menemukan entri log. Misalnya, Anda dapat menelusuri entri log menurut tampilan log.

Widget panel log menampilkan satu entri log per baris, dengan kolom untuk tingkat keparahan, stempel waktu, dan ringkasan entri log. Untuk melihat representasi berformat JSON dari entri log, klik tombol Lihat detail log. Struktur setiap ringkasan entri bervariasi berdasarkan jenis log. Misalnya, gambar berikut menampilkan dua entri log:

Pada gambar sebelumnya, entri log pertama menampilkan informasi tentang permintaan layanan. Ringkasan menampilkan informasi tentang layanan, alamat email, dan versi struktur JSON yang diformat string untuk entri. Entri kedua menampilkan hasil permintaan, dan hanya menampilkan kalimat yang merangkum tindakan yang terjadi.

Untuk mengetahui informasi umum tentang Cloud Logging, lihat referensi berikut:

• Konsep dasar
• Bahasa kueri Logging
• Logs Explorer

Sebelum memulai

Untuk mendapatkan izin yang diperlukan untuk menambahkan widget panel log ke dasbor kustom menggunakan Google Cloud konsol, dan mengonfigurasinya untuk menampilkan entri log di project atau di tampilan log, minta administrator untuk memberi Anda peran IAM berikut:

• Monitoring Editor (roles/monitoring.editor) di project Anda.
• Logging Viewer (roles/logging.viewer) di setiap project yang entri lognya ingin Anda lihat. Peran ini tidak memberi Anda akses ke setiap entri log. Untuk mengetahui informasi selengkapnya tentang peran, lihat Kontrol akses Cloud Logging dengan IAM.
• Logs View Accessor (roles/logging.viewAccessor) di setiap project yang menyimpan bucket log untuk tampilan log yang ingin Anda akses. Peran Logs View Accessor memberikan akses ke semua tampilan log yang disimpan oleh project. Untuk mengetahui informasi tentang cara mendapatkan akses ke tampilan log tertentu, lihat Mengontrol akses ke tampilan log.

Untuk mengetahui informasi selengkapnya tentang pemberian peran, lihat Mengelola akses ke project, folder, dan organisasi.

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

Catatan: Widget panel log mengkueri project dan tampilan log yang tercantum dalam cakupan log default dan hanya menampilkan entri log yang izin aksesnya Anda miliki. Untuk memastikan widget dapat menampilkan semua entri yang tersedia, Anda mungkin memerlukan peran Logs Viewer di beberapa project dan peran Logs View Accessor di beberapa tampilan log.

Menampilkan entri log di dasbor

Bagian ini menjelaskan cara menambahkan dan mengonfigurasi widget panel log menggunakan konsol Google Cloud . Untuk mengetahui informasi tentang cara menggunakan Cloud Monitoring API, lihat Dasbor dengan widget LogsPanel.

Anda dapat menempatkan hingga 100 widget di dasbor.

Untuk menambahkan widget panel log ke dasbor menggunakan konsol, lakukan hal berikut:

1. Di konsol Google Cloud , buka halaman  Dashboards:

   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 Pusat Aplikasi, pilih project host Pusat Aplikasi atau project pengelolaan.
3. Pilih dasbor atau klik Buat dasbor.
4. Di toolbar, klik  Tambahkan widget.
5. Dalam dialog Add widget, pilih  Log.
6. Opsional: Untuk memperbarui judul, masukkan judul baru di kolom Judul widget.

7. Mengonfigurasi resource mana yang dicari untuk entri log:

   • Untuk menelusuri menurut project, tetapkan entri Cakupan menurut ke Project, lalu luaskan entri Project dan selesaikan dialog.

     Catatan: Anda harus meluaskan menu Project dan memilih setidaknya satu project. Tidak ada project yang dipilih secara otomatis.

     Menu Projects mencantumkan semua project Google Cloud dalam cakupan metrik saat ini. Jika entri dalam menu menyertakan teks "Anda tidak memiliki izin level project untuk melihat log dalam project ini", maka Anda tidak memiliki izin yang diperlukan untuk melihat entri log yang tersedia dalam project Google Cloud tersebut.

     Entri log yang ditampilkan mencakup entri yang berasal dari projectGoogle Cloud dan entri yang dirutekan ke projectGoogle Cloud oleh sink di project lain.

   • Untuk menelusuri entri log menurut tampilan log di bucket log, tetapkan entri Cakupan menurut ke Penyimpanan, lalu perluas entri Tampilan penyimpanan dan selesaikan dialog.

     Catatan: Anda harus meluaskan menu Tampilan penyimpanan dan memilih setidaknya satu tampilan log. Tidak ada tampilan log yang dipilih secara otomatis.

     Menu Tampilan penyimpanan mencantumkan tampilan log pada bucket log di project Google Cloud yang Anda pilih.

     Untuk memilih tampilan log di bucket log dalam project Google Cloud lain, di menu, klik Impor project, pilih project, lalu pilih satu atau beberapa tampilan log. Anda hanya dapat mengimpor project yang disertakan dalam cakupan metrik saat ini.

     Catatan: Jika pengguna saat ini tidak memiliki izin untuk mengakses semua tampilan log yang dicari oleh widget panel log untuk entri log, widget akan menampilkan error. Untuk mengetahui informasi selengkapnya, lihat Panel Log menampilkan pesan izin ditolak.

   • Untuk menelusuri resource yang disertakan dalam cakupan log, yang dapat mencakup project dan tampilan log, tetapkan entri Cakupan menurut ke Cakupan Log, lalu perluas entri Cakupan Log dan pilih cakupan log.

8. Opsional: Untuk membatasi log yang ditampilkan widget panel log, masukkan kueri di kolom Query Editor, dan jika Anda telah menonaktifkan kueri agar tidak dijalankan secara otomatis, klik Run query. Untuk pengantar singkat tentang kueri, lihat Contoh kueri.

   Kueri dapat berisi maksimal 2.000 karakter.

9. Opsional: Perbarui kueri atau konfigurasi widget agar bergantung pada variabel. Saat Anda mengubah nilai variabel, widget juga akan diperbarui. Untuk mengetahui sintaksis dan informasi lainnya, lihat Menambahkan variabel ke kueri.

10. Untuk menerapkan perubahan pada dasbor, di toolbar, klik Terapkan. Untuk menghapus perubahan, klik Batal.

11. Untuk menyimpan dasbor yang telah diubah, di toolbar, klik Simpan.

    Widget panel log menampilkan tabel entri log. Anda juga dapat menggunakan kolom filter widget untuk mengubah sementara entri log yang ditampilkan widget. Untuk mengetahui informasi selengkapnya, lihat bagian berjudul Memfilter entri log.

Contoh kueri

Untuk mengisi kolom Query Editor, Anda dapat memasukkan teks ke dalam kolom atau memilih dari menu. Kolom Query Editor menggunakan bahasa kueri yang sama dengan Logs Explorer. Untuk mengetahui informasi pemecahan masalah, lihat Masalah sintaksis.

Menu Severity dan Log name memungkinkan Anda memilih beberapa opsi. Berikut adalah contoh pernyataan kueri yang cocok dengan beberapa tingkat keparahan:

severity=(WARNING OR ERROR OR CRITICAL OR ALERT OR EMERGENCY)

Menu Resource memungkinkan Anda memfilter menurut resource. Anda dapat memilih jenis resource, seperti Audited Resource, atau Anda dapat menjelajahi menu untuk memilih metode tertentu.

Misalnya, untuk menambahkan kueri untuk Audited Resource, lakukan hal berikut:

1. Luaskan menu Resource.
2. Telusuri dan pilih Audited Resource.

3. Klik Terapkan.

   Langkah-langkah ini menambahkan klausa berikut ke kolom Query Editor:

   resource.type="audited_resource"
   

Demikian pula, untuk menambahkan kueri untuk log audit Cloud Run Functions, lakukan hal berikut:

1. Luaskan menu Resource.
2. Telusuri dan pilih Audited Resource.
3. Di menu layanan, pilih Cloud Functions.

4. Klik Terapkan.

   Langkah-langkah ini menambahkan klausa berikut ke kolom Query Editor:

   resource.type="audited_resource" resource.labels.service="cloudfunctions.googleapis.com"
   

Menambahkan variabel ke kueri Anda

Anda dapat menggunakan variabel dalam kueri atau di kolom lain dalam widget panel log. Saat Anda mengubah nilai variabel, data yang ditampilkan oleh widget juga akan berubah.

Untuk menambahkan variabel ke kueri, lakukan hal berikut:

1. Buat variabel. Di konsol Google Cloud , Anda dapat menggunakan opsi Setelan dasbor untuk membuat, mengedit, dan melihat variabel. Anda juga dapat menggunakan Cloud Monitoring API.

2. Untuk menerapkan variabel ke kueri, gunakan salah satu bentuk berikut:

   • Untuk variabel berbasis label, gunakan ${label_based_variable.value}.
   • Untuk variabel berbasis nilai, gunakan ${value_based_variable}.

   Misalnya, Anda membuat variabel khusus nilai value_only_severity_variable dan mengonfigurasinya agar memiliki salah satu dari tiga nilai: ERROR, INFO, dan NOTICE. Anda juga menambahkan pernyataan berikut ke kueri:

   severity =~ "${value_only_severity_variable}"
   

   Berikut ilustrasi bentuk yang dirender:

   severity =~ "^(ERROR|INFO|NOTICE)$"
   

   Untuk mengetahui informasi selengkapnya tentang variabel dan cara menerapkannya ke widget panel log atau ke widget lain, lihat Memperbarui kueri widget.

Untuk mengetahui informasi tentang cara menggunakan variabel untuk menampilkan atau menyembunyikan widget, lihat Menetapkan visibilitas widget.

Memfilter entri log

Catatan: Kueri dapat berisi maksimal 2.000 karakter.

Anda dapat mengubah entri log yang ditampilkan widget panel log dengan mengubah nilai kolom atau menu berikut:

• Pemilih waktu dasbor: Secara default, widget panel log hanya mengambil entri log yang ditulis dalam interval yang ditentukan oleh kolom ini. Jika Anda menginginkan interval yang berbeda, terapkan filter yang menyertakan klausa timestamp. Widget panel log tidak mendukung penggantian rentang waktu.

• Kolom Filter pada widget panel log: Filter yang Anda tentukan diterapkan setelah kueri selesai. Nilai kolom ini dipertahankan hanya untuk sesi saat ini.

• Menu Severity pada widget panel log: Filter menurut tingkat keparahan diterapkan setelah kueri selesai. Nilai kolom ini dipertahankan hanya untuk sesi saat ini.

• Kueri pada widget panel log: Widget panel log hanya menampilkan entri log yang cocok dengan kueri. Jika Anda tidak menentukan kueri, semua log dalam interval waktu yang dipilih akan ditampilkan. Jika Anda menentukan kueri, widget panel log akan menampilkan ikon Tampilkan kueri, yang menampilkan kueri saat ini sebagai tooltip.

  Untuk mengubah kueri, edit widget panel log.

• Google Cloud project di widget panel log: Untuk mengubah setelan ini, edit widget panel log.

• Filter dasbor: Jika ada filter dasbor, setelan filter diterapkan ke kueri widget panel log. Misalnya, jika Anda menambahkan filter dasbor cluster_name: mycluster, kueri akan diperbarui untuk menyertakan resource.labels."cluster_name"="mycluster". Untuk mengetahui informasi selengkapnya tentang filter dasbor, lihat Menambahkan filter sementara dan Menambahkan filter permanen.

Bagian selanjutnya dalam bagian ini memberikan informasi tambahan tentang cara memfilter entri log Anda.

Contoh: memfilter entri log menurut tanggal

Untuk menampilkan log terbaru di widget panel log, gunakan kolom waktu di toolbar dasbor. Misalnya, Anda dapat menyetel pemilih rentang waktu toolbar ke 1H. Selama Anda tidak memilih rentang waktu kustom, widget akan selalu menampilkan log terbaru, meskipun log tersebut lebih lama daripada rentang waktu yang dipilih.

Saat menyelidiki insiden, Anda mungkin ingin membatasi entri log ke entri yang berada dalam interval waktu tertentu. Untuk mengonfigurasi entri log agar hanya menampilkan log yang berada dalam interval waktu tetap, lakukan salah satu atau kedua hal berikut:

• Pilih rentang waktu menggunakan pemilih rentang waktu.
• Masukkan klausa timestamp di kolom Query Editor pada panel konfigurasi, lalu pilih Terapkan filter.

Saat Anda menentukan interval waktu, widget panel log tidak otomatis dimuat ulang.

Contoh: memfilter entri log menurut tingkat keparahan

Saat men-debug situasi kegagalan, Anda mungkin hanya ingin melihat pesan error, dan menyembunyikan semua entri log lainnya dari tampilan. Untuk mengonfigurasi widget panel log agar hanya menampilkan entri log yang memenuhi tingkat keparahan tertentu, lakukan salah satu atau kedua hal berikut:

• Untuk menerapkan filter sementara, pilih nilai untuk menu Severity di widget panel log. Menu ini menentukan tingkat keparahan minimum. Misalnya, nilai "Warning" akan menghasilkan entri log dengan tingkat keparahan "Error" yang diambil, tetapi entri log dengan tingkat keparahan "Notice" tidak diambil. Secara default, nilai untuk kolom ini ditetapkan ke Default, yang mencakup semua entri log.

  Setelan untuk menu Severity akan dihapus saat Anda keluar dari dasbor.

• Untuk menerapkan filter permanen, masukkan klausa severity di kolom Query Editor pada panel konfigurasi, lalu pilih Terapkan filter.

Contoh: memfilter entri log menurut string atau frasa

Memfilter entri log berdasarkan string atau frasa tertentu memungkinkan Anda menghilangkan entri log yang tidak menarik dari tampilan. Misalnya, untuk melihat entri log yang menyertakan alamat email tertentu, Anda dapat memfilter menurut alamat tersebut.

• Untuk menerapkan filter sementara agar Anda hanya melihat entri log yang berisi kata atau frasa tertentu, gunakan kolom Filter. Pengujian berisi tidak peka huruf besar/kecil.

  Jika Anda menambahkan beberapa filter, hanya log yang cocok dengan semua filter yang ditampilkan karena AND implisit disisipkan di antara filter yang berdekatan. Namun, Anda dapat memasukkan operator OR secara eksplisit:

  • Misalnya, saat Anda menambahkan filter Get dan Compute, entri log yang berisi kedua kata tersebut akan ditampilkan.

  • Misalnya, saat Anda menambahkan filter Get, OR, dan Compute, entri log yang berisi Get atau Compute akan ditampilkan.

  Nilai kolom Filter tidak persisten.

• Untuk menerapkan filter permanen, ubah kueri yang disimpan di kolom Editor Kueri, lalu pilih Terapkan filter. Untuk mengetahui informasi tentang sintaksis kueri, lihat Bahasa kueri logging.

  Misalnya, untuk hanya menampilkan entri log dengan kolom MESSAGE yang nilainya berisi string "lamp", tambahkan klausa jsonPayload.MESSAGE:"lamp" ke kolom Editor Kueri.

Melihat entri log di Logs Explorer

Widget panel log menampilkan kolom utama entri log; widget ini tidak menampilkan entri log lengkap. Untuk memeriksa semua kolom entri log, lakukan hal berikut:

1. Di widget panel log, pilih Lihat di Logs Explorer.

2. Dalam dialog, pilih project Google Cloud tempat Logs Explorer akan dibuka.

   Logs Explorer akan terbuka di tab browser baru, dan filter yang telah Anda pilih di widget panel log akan diterapkan secara otomatis.

3. Pilih entri log yang ingin Anda lihat.

Menampilkan diagram yang dibuat dari kueri Observability Analytics

Bagian ini menjelaskan cara mengonfigurasi dan menyimpan diagram yang dihasilkan dari kueri Observability Analytics ke dasbor kustom. Analisis Kemampuan Observasi memungkinkan Anda menelusuri dan menggabungkan log untuk menghasilkan insight yang berguna menggunakan kueri SQL.

Selain menggunakan halaman Observability Analytics untuk mengonfigurasi dan menyimpan diagram ke dasbor, Anda dapat menyimpan diagram Observability Analytics langsung di Monitoring dengan melakukan hal berikut:

1. Di konsol Google Cloud , buka halaman  Dashboards:

   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 Pusat Aplikasi, pilih project host Pusat Aplikasi atau project pengelolaan.
3. Pilih dasbor atau klik Buat dasbor.
4. Di toolbar, klik  Tambahkan widget.
5. Pada dialog Tambahkan widget, buka bagian Data, lalu pilih Observability Analytics.

6. Dalam dialog Konfigurasi widget, konfigurasi data yang akan ditampilkan, lalu klik Jalankan Kueri.

   Untuk memilih data yang akan ditampilkan, Anda dapat membuat kueri SQL atau memilih kueri tersimpan atau terbaru. Tampilan log dan tampilan analisis yang dapat Anda kueri tercantum di bagian Tampilan & Skema. Mengklik sumber data akan menampilkan daftar kolom untuk sumber data tersebut di bagian header Skema.

7. Opsional: Di tab Hasil, sesuaikan konfigurasi diagram dengan menggunakan panel Tampilan.

   Di panel Tampilan, Anda dapat mengubah jenis diagram dan menyesuaikan baris dan kolom yang diplot dengan mengubah dimensi, ukuran, dan perincian:

   • Dimensi: Dimensi harus berupa kolom stempel waktu, numerik, atau string. Secara default, dimensi ditetapkan ke kolom berbasis stempel waktu pertama dalam skema. Jika tidak ada stempel waktu dalam kueri, maka kolom string pertama akan dipilih sebagai dimensi. Anda juga dapat menyesuaikan dimensi di panel Tampilan diagram. Jika kolom stempel waktu dipilih sebagai dimensi, diagram akan menampilkan perubahan data dari waktu ke waktu. Saat kolom string dipilih sebagai dimensi untuk diagram batang, Anda dapat mengurutkan data menurut urutan menaik atau menurun, yang mengurutkan dimensi menurut urutan leksikal. Anda juga dapat mempertahankan tata urutan pengurutan `default`, yang mengurutkan dimensi berdasarkan nilai pengukuran yang sesuai dalam urutan menurun.

   • Pengukuran: Anda dapat memilih beberapa pengukuran di panel Tampilan diagram. Saat memilih ukuran, Anda juga harus memilih fungsi agregasi yang akan dilakukan pada nilai yang dikelompokkan, seperti count, sum, average, dan percentile-99. Misalnya, count-distinct menampilkan jumlah nilai unik dalam kolom tertentu.

   • Perincian: Untuk membagi satu deret data menjadi beberapa deret data berdasarkan kolom lain, tambahkan perincian.

   Untuk mengetahui informasi selengkapnya tentang cara menyesuaikan konfigurasi diagram, lihat Menyesuaikan konfigurasi diagram.

8. Untuk menyimpan dasbor yang telah diubah, di toolbar, klik Simpan.

Diagram Observability Analytics juga dapat diedit setelah disimpan ke dasbor. Untuk mengetahui informasi selengkapnya, lihat Mengubah konfigurasi widget.

Menampilkan error di dasbor

Bagian ini menjelaskan cara menambahkan dan mengonfigurasi panel pelaporan error menggunakan konsol Google Cloud . Untuk mengetahui informasi tentang cara menambahkan panel pelaporan error ke dasbor menggunakan Cloud Monitoring API, lihat Dasbor dengan widget ErrorReportingPanel.

Untuk menambahkan panel pelaporan error ke dasbor menggunakan konsol, lakukan hal berikut:

1. Di konsol Google Cloud , buka halaman  Dashboards:

   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 Pusat Aplikasi, pilih project host Pusat Aplikasi atau project pengelolaan.
3. Pilih dasbor atau klik Buat dasbor.
4. Di toolbar, klik  Tambahkan widget.
5. Di dialog Add widget, buka bagian Visualization, lalu pilih Error Reporting panel.
6. Luaskan Projects, lalu pilih project.
7. Opsional: Perbarui judul.

8. Opsional: Untuk membatasi resource yang menampilkan error, lakukan hal berikut:

   1. Luaskan Semua Resource dan pilih resource.

   2. Setelah memilih resource, Anda dapat memilih Terapkan, atau Anda dapat menggunakan menu tambahan untuk menyaring kriteria filter:

      • Untuk menampilkan error untuk resource App Engine, pilih GAE Services, lalu klik Apply.

      • Untuk menampilkan error untuk layanan App Engine tertentu, pilih GAE Services, pilih layanan, lalu klik Apply.

9. Untuk menerapkan perubahan pada dasbor, di toolbar, klik Terapkan. Untuk menghapus perubahan, klik Batal.

   Contoh berikut menunjukkan panel pelaporan error:

   

10. Untuk menyimpan dasbor yang telah diubah, di toolbar, klik Simpan.

Memecahkan masalah

• Panel log menunjukkan bahwa data yang ditampilkan adalah sebagian data
• Panel log melaporkan kueri yang tidak valid
• Panel log menampilkan pesan "Tidak ada entri yang ditemukan"

Langkah berikutnya

• Ringkasan cakupan metrik menjelaskan cara Cloud Monitoring memberikan visibilitas ke dalam metrik dan log yang disimpan di beberapa Google Cloud project.

• Ringkasan Error Reporting menjelaskan grup error.

• Untuk mengetahui informasi tentang cara mengonfigurasi dasbor untuk menampilkan log atau error menggunakan API, lihat artikel berikut:

  • Dasbor dengan widget LogsPanel.
  • Dasbor dengan widget ErrorReportingPanel.