Menampilkan log dan error di dasbor kustom

Dokumen ini menjelaskan widget yang dapat Anda tambahkan ke dasbor kustom agar dapat melihat data log dan error dalam konteks yang sama dengan data metrik. Widget panel log menampilkan entri log. Widget panel pelaporan error menampilkan grup error terbaru. Kedua widget ini memberikan informasi yang mungkin berguna saat memecahkan masalah. Widget diagram Log Analytics, yang menampilkan hasil kueri SQL, memungkinkan Anda mengidentifikasi tren dalam data log.

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 menyediakan 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 izinnya Anda miliki untuk dilihat. Peran Identity and Access Management (IAM) Anda di 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 resource yang tercantum dalam cakupan log default untuk entri log. Jika cakupan tersebut tidak dapat diakses, penelusuran akan mencari entri log yang berasal dari project yang Anda pilih. Saat project dipilih, hasil penelusuran akan menyertakan entri log yang dirutekan ke project oleh sink dalam project lain, lalu disimpan di bucket log. Anda dapat mengonfigurasi resource mana yang akan ditelusuri untuk menemukan entri log. Misalnya, Anda dapat menelusuri entri log berdasarkan 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 entri log dalam format JSON, 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 guna menambahkan widget panel log ke dasbor kustom menggunakan konsol Google Cloud, dan mengonfigurasinya untuk menampilkan entri log dalam project atau dalam 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 tersebut, 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 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.

Menampilkan entri log di dasbor

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

Anda dapat menempatkan hingga 40 widget di dasbor.

Untuk menambahkan widget panel log ke dasbor menggunakan konsol, lakukan hal 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 atau klik Buat dasbor.
3. Di toolbar, klik  Tambahkan widget.
4. Pada dialog Tambahkan widget, pilih  Log.
5. Opsional: Untuk memperbarui judul, masukkan judul baru di kolom Judul widget.

6. Konfigurasikan resource yang ditelusuri 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 Project mencantumkan semua project Google Cloud dalam cakupan metrik saat ini. Jika entri di menu menyertakan teks "Anda tidak memiliki izin tingkat project untuk melihat log di project ini", berarti Anda tidak memiliki izin yang diperlukan untuk melihat entri log yang tersedia di project Google Cloud tersebut.

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

   • Untuk menelusuri entri log menurut tampilan log di bucket log, tetapkan entri Cakupan menurut ke Penyimpanan, lalu luaskan 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 di bucket log dalam project Google Cloud yang Anda pilih.

     Untuk memilih tampilan log di bucket log di project Google Cloud lainnya, di menu, klik Import 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 ditelusuri widget panel log untuk menemukan entri log, widget akan menampilkan error. Untuk 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 luaskan entri Cakupan Log dan pilih cakupan log.

     Cakupan log berada dalam Pratinjau Publik.

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

8. Opsional: Terapkan variabel ke widget panel log. Variabel adalah filter tingkat dasbor yang hanya berlaku untuk widget tertentu. Untuk mengetahui informasi selengkapnya, lihat Menerapkan variabel ke widget.

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

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

    Widget panel log menampilkan tabel entri log. Anda juga dapat menggunakan panel filter widget untuk sementara mengubah 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 membuat pilihan dari menu. Kolom Query Editor menggunakan bahasa kueri yang sama dengan Logs Explorer. Untuk 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 membuka jendela untuk memilih metode tertentu.

Misalnya, untuk menambahkan kueri Resource yang Diaudit, lakukan tindakan berikut:

1. Luaskan menu Resource.
2. Telusuri dan pilih Resource yang Diaudit.

3. Klik Terapkan.

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

   resource.type="audited_resource"
   

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

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

4. Klik Terapkan.

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

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

Memfilter entri log

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

• Pemilih waktu dasbor: Widget panel log hanya mengambil entri log yang ditulis dalam interval yang ditentukan oleh kolom ini.

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

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

• Kueri di 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 Show query, yang menampilkan kueri saat ini sebagai tooltip.

  Untuk mengubah kueri, edit widget panel log.

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

• Filter dasbor: Jika filter dasbor ada, setelan filter akan 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 dari 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, pilih 1H. Jika Anda tidak memilih rentang waktu kustom, widget akan selalu menampilkan log terbaru, meskipun log tersebut lebih lama dari periode waktu yang dipilih.

Saat menyelidiki insiden, Anda mungkin ingin membatasi entri log ke entri yang berada dalam interval waktu tertentu. Untuk mengonfigurasi entri log ke log tampilan 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 akan otomatis dimuat ulang.

Contoh: memfilter entri log menurut tingkat keparahan

Saat memantau proses debug situasi kegagalan, Anda mungkin hanya ingin melihat pesan error, dan menyembunyikan semua entri log lainnya dari layar. 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 Keparahan di widget panel log. Menu ini menentukan tingkat keparahan minimum. Misalnya, nilai "Peringatan" akan menyebabkan entri log dengan tingkat keparahan "Error" diambil, tetapi entri log tersebut dengan tingkat keparahan "Pemberitahuan" tidak diambil. Secara default, nilai untuk kolom ini ditetapkan ke Default, yang mencakup semua entri log.

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

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

Contoh: memfilter entri log menurut string atau frasa

Memfilter entri log menurut 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 sehingga Anda hanya melihat entri log yang berisi kata atau frasa tertentu, gunakan kolom Filter . Pengujian contains tidak peka huruf besar/kecil.

  Jika Anda menambahkan beberapa filter, hanya log yang cocok dengan semua filter yang akan 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 Query Editor, lalu pilih Terapkan filter. Untuk mengetahui informasi tentang sintaksis kueri, lihat Bahasa kueri logging.

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

Melihat entri log di Logs Explorer

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

1. Di widget panel log, pilih View in Logs Explorer.

2. Dalam dialog, pilih project Google Cloud tempat Anda ingin membuka Logs Explorer.

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

3. Pilih entri log yang ingin Anda lihat.

Menampilkan diagram yang dibuat dari kueri Log Analytics

Pratinjau

Fitur ini tunduk pada "Persyaratan Penawaran Pra-GA" di bagian Persyaratan Layanan Umum dalam Persyaratan Khusus Layanan. Fitur pra-GA tersedia "sebagaimana adanya" dan mungkin memiliki dukungan terbatas. Untuk mengetahui informasi selengkapnya, lihat deskripsi tahap peluncuran.

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

Selain menggunakan halaman Log Analytics untuk mengonfigurasi dan menyimpan diagram ke dasbor, Anda dapat menyimpan diagram Log Analytics langsung di Pemantauan dengan melakukan 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 atau klik Buat dasbor.
3. Di toolbar, klik  Tambahkan widget.
4. Pada dialog Add widget, buka bagian Data, lalu pilih Log Analytics.

5. Di panel Configure widget, konfigurasikan data yang akan ditampilkan, lalu klik Run query.

   Untuk memilih data yang akan ditampilkan, Anda dapat membuat kueri SQL atau memilih kueri tersimpan atau terbaru.

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

   Di panel Tampilan, Anda dapat mengubah jenis diagram dan menyesuaikan baris serta kolom yang dipetakan dengan mengubah dimensi, ukuran, dan pengelompokan:

   • 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, 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.

   • Ukuran: Anda dapat memilih beberapa ukuran 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.

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

Diagram Log 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 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  Dasbor:

   Buka Dasbor

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

2. Pilih dasbor atau klik Buat dasbor.
3. Di toolbar, klik  Tambahkan widget.
4. Di dialog Tambahkan widget, buka bagian Visualisasi, lalu pilih panel Pelaporan Error.
5. Pilih project yang grup error-nya ditampilkan, luaskan Projects, lalu buat pilihan.
6. Opsional: Perbarui judul.

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

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

   Contoh berikut menunjukkan panel pelaporan error:

   

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

Memecahkan masalah

• Panel log menunjukkan bahwa panel tersebut menampilkan data sebagian
• Panel log melaporkan kueri yang tidak valid
• Panel Log menampilkan pesan "Tidak ada entri yang ditemukan"

Langkah selanjutnya

• Untuk informasi tentang cara Cloud Monitoring memberikan visibilitas ke metrik dan log yang disimpan di beberapa project Google Cloud, lihat Ringkasan cakupan metrik.

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

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

• Untuk mempelajari grup error lebih lanjut, lihat Ringkasan Pelaporan Error.