Menampilkan log dan error di dasbor kustom

Dokumen ini menjelaskan cara menampilkan data log dan data error di dasbor kustom Anda.

Untuk menampilkan data log, Anda dapat menambahkan widget berikut ke dasbor:

• Untuk menampilkan entri log terbaru dalam project Google Cloud saat ini, tambahkan widget panel log. Anda juga dapat mengonfigurasi panel log untuk menampilkan entri log yang disimpan di project Google Cloud yang dapat diakses melalui cakupan metrik saat ini.

• Untuk mengidentifikasi pola dan tren dalam data log Anda, tambahkan widget diagram Log Analytics yang menampilkan hasil kueri SQL.

Untuk menampilkan grup error, Anda dapat menambahkan panel pelaporan error. Panel pelaporan error menampilkan grup error terbaru untuk satu project Google Cloud.

Saat Anda menambahkan panel log dan panel pelaporan error ke dasbor kustom, Anda dapat melihat log dan error dalam konteks yang sama dengan metrik Anda. Karena panel log memungkinkan Anda memfilter entri log, Anda dapat mengonfigurasinya agar hanya menampilkan entri log yang Anda minati. Demikian pula, panel pelaporan error memungkinkan Anda mengidentifikasi error dan memecahkan penyebab kegagalan.

Logs Explorer dan panel log

Logs Explorer adalah cara standar untuk menyelidiki log. Panel log tidak menggantikan Logs Explorer; tetapi, panel ini memberi cara untuk melihat entri log dalam konteks yang sama dengan metrik Anda.

Panel log menampilkan entri log pada baris dengan kolom untuk tingkat keparahan, stempel waktu, dan ringkasan entri log. Untuk melihat representasi entri log berformat JSON, klik tombol View log details. Struktur setiap ringkasan entri bervariasi berdasarkan jenis log. Misalnya, gambar berikut menunjukkan 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 berformat string untuk entri. Entri kedua menampilkan hasil permintaan, dan hanya menampilkan kalimat yang merangkum tindakan yang terjadi.

Panel log telah dikonfigurasi sebelumnya untuk menampilkan entri log yang disimpan di project Google Cloud Anda saat ini. Namun, Anda dapat mengonfigurasi panel log untuk menampilkan entri log yang disimpan di project mana pun dalam cakupan metrik saat ini.

Panel log mendukung bahasa kueri yang sama dengan Logs Explorer.

Panel log tidak mendukung tampilan penyimpanan. Jika log Anda hanya tersedia melalui tampilan penyimpanan, gunakan Logs Explorer. Untuk informasi tentang tampilan penyimpanan, lihat Menyempurnakan cakupan.

Untuk informasi umum tentang Cloud Logging, lihat referensi berikut:

• Konsep dasar
• Bahasa kueri logging
• Penjelajah Log

Sebelum memulai

• Untuk mendapatkan izin yang diperlukan untuk menambahkan widget log ke dasbor kustom dengan menggunakan Konsol Google Cloud, minta administrator Anda untuk memberi peran IAM berikut pada project Anda:

  • Monitoring Editor (roles/monitoring.editor)
  • Logging Viewer (roles/logging.viewer) di setiap project yang entri lognya ingin Anda lihat. Dasbor tidak menampilkan entri log untuk project yang log-nya tidak Anda miliki. Untuk mengetahui informasi selengkapnya tentang peran yang Anda perlukan untuk melihat entri log, lihat Kontrol akses Cloud Logging dengan IAM.

  Untuk mengetahui informasi selengkapnya tentang pemberian peran, lihat Mengelola akses.

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

• Anda dapat menempatkan hingga 40 widget di dasbor.

Panel Tambahkan dan konfigurasi log

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

Tambahkan panel log

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

1. Di panel navigasi konsol Google Cloud, pilih Monitoring, lalu pilih  Dashboards:

   Buka Dasbor

2. Pilih dasbor atau klik Buat dasbor.
3. Di toolbar, klik  Tambahkan widget.
4. Pada dialog Add widget, pilih  Logs.

5. Opsional: Perbarui konfigurasi default:

   1. Tambahkan judul.

   2. Untuk menampilkan log dari beberapa project Google Cloud, bukan hanya project saat ini, klik Project, lalu tentukan pilihan Anda.

   3. Untuk membatasi log yang ditampilkan panel log, masukkan kueri di kolom Query Editor.

   Untuk informasi selengkapnya tentang langkah sebelumnya, lihat Mengonfigurasi panel log:

6. Untuk menerapkan perubahan ke dasbor, di toolbar, klik Apply. Untuk menghapus perubahan, klik Batal.

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

Secara default, panel log menampilkan tabel entri log. Anda dapat menggunakan menu Severity dan setelan panel filter untuk mengubah log yang akan ditampilkan untuk sementara. Anda juga dapat mengubah ukuran dan posisi panel log menggunakan pointer.

Konfigurasi panel log

Panel log telah dikonfigurasi sebelumnya untuk menampilkan semua entri log yang disimpan dalam project Google Cloud saat ini. Namun, Anda mungkin hanya tertarik dengan entri log yang menunjukkan beberapa jenis kondisi error, atau Anda mungkin ingin melihat log untuk beberapa project. Bagian ini menjelaskan cara mengubah konfigurasi default panel log.

Untuk mengonfigurasi judul, daftar project yang log-nya ditampilkan, atau untuk memasukkan kueri, lakukan tindakan berikut:

1. Tempatkan kursor Anda di panel log untuk mengaktifkan toolbar, lalu pilih  Edit widget.

   Screenshot berikut adalah contoh panel konfigurasi:

   

2. Opsional: Tambahkan judul, yang ditampilkan di panel log.

3. Opsional: Untuk menampilkan log dari beberapa project Google Cloud, klik Project, lalu tentukan pilihan Anda.

   Secara default, hanya entri log dari project Google Cloud saat ini yang ditampilkan. Namun, panel log dapat menampilkan log untuk project Google Cloud yang dapat diakses melalui cakupan metrik saat ini.

   Jika Anda tidak memiliki izin untuk melihat log untuk project Google Cloud, menu Project akan menampilkan pesan "Anda tidak memiliki izin untuk melihat log dalam project ini". Untuk mengatasi error izin, hubungi administrator sistem dan minta administrator untuk memberi Anda peran Logs Viewer (roles/logging.viewer) pada project.

4. Opsional: Untuk membatasi log yang ditampilkan panel log, masukkan kueri di kolom Query Editor.

   Jika Anda telah menonaktifkan kueri agar tidak otomatis dijalankan, klik Jalankan kueri setelah Anda memasukkan kueri.

   Untuk mengisi kolom Query Editor, Anda dapat memasukkan teks ke 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 Keparahan dan Nama log 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 mengaktifkan menu tambahan dan tombol Add setelah Anda memilih resource satu per satu. Menu ini memungkinkan Anda memilih jenis resource, layanan untuk jenis resource tertentu, atau metode untuk layanan pada jenis resource tertentu. Misalnya, untuk menambahkan klausa untuk jenis resource yang diaudit, pilih Audited Resource, lalu pilih Add. Langkah-langkah ini menambahkan klausa berikut ke kolom Query Editor:

    resource.type="audited_resource"
   

   Demikian pula, untuk menambahkan klausa untuk layanan tertentu yang diaudit, pilih Audited Resource, pilih layanan dari menu All service, lalu pilih Add. Berikut adalah contoh klausa yang dibuat menggunakan pendekatan ini:

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

5. Opsional: Terapkan variabel template ke panel log. Untuk mengetahui informasi selengkapnya, lihat Menambahkan filter sementara ke dasbor kustom dan Menerapkan filter permanen ke widget.

6. Untuk menerapkan perubahan ke dasbor, di toolbar, klik Apply. Untuk menghapus perubahan, klik Batal.

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

Memfilter entri log

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

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

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

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

• Kueri yang ditentukan oleh panel log: Kolom kueri menentukan log yang diambil. Jika Anda tidak menentukan kueri, semua log dalam interval waktu yang dipilih akan diambil. Jika Anda menentukan kueri, panel log akan menampilkan ikon Show query, yang menampilkan kueri saat ini sebagai tooltip.

  Untuk mengubah kueri, lakukan salah satu hal berikut:

  • Untuk mengubah kueri secara permanen, edit panel log.
  • Untuk mengubah kueri sementara, gunakan toolbar dasbor untuk menambahkan filter pada label resource. Misalnya, jika Anda menambahkan filter tingkat dasbor cluster_name: mycluster, kueri akan diupdate untuk menyertakan resource.labels."cluster_name"="mycluster". Untuk mengetahui informasi selengkapnya, lihat Menambahkan filter sementara dan Menambahkan filter permanen.

• Project Google Cloud yang ditentukan oleh panel log: Untuk mengubah setelan ini, edit panel log.

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

Memfilter entri log menurut tanggal

Untuk menampilkan log terbaru di panel log, gunakan kolom waktu di toolbar dasbor. Misalnya, pilih 1H. Asalkan Anda tidak memilih rentang waktu kustom, panel log akan selalu menampilkan log terbaru, bahkan jika log tersebut lebih lama dari periode waktu yang dipilih.

Saat menyelidiki insiden, Anda dapat membatasi entri log ke entri log yang berada dalam interval waktu tertentu. Untuk mengonfigurasi entri log agar 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 Apply filter.

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

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 tampilan. Untuk mengonfigurasi panel log agar hanya menampilkan entri log yang memenuhi tingkat keparahan tertentu, lakukan salah satu atau kedua tindakan berikut:

• Untuk menerapkan filter sementara, pilih nilai untuk menu Severity di panel log. Menu ini menentukan tingkat keparahan minimum. Misalnya, nilai "Warning" menghasilkan entri log dengan tingkat keparahan "Error" diambil, tetapi entri log dengan tingkat keseriusan "Pemberitahuan" tersebut tidak diambil. Secara default, nilai untuk kolom ini ditetapkan ke Default, yang menyertakan 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 Apply filter.

Memfilter entri log menurut string atau frasa

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

• Untuk menerapkan filter sementara sehingga Anda hanya melihat entri log yang berisi kata atau frasa tertentu, gunakan kolom Filter . Uji berisi 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 menyisipkan operator OR secara eksplisit:

  • Misalnya, saat Anda menambahkan filter Get dan Compute, entri log yang berisi kedua kata 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 Apply filter. Untuk mengetahui informasi tentang sintaksis kueri, lihat Bahasa kueri logging.

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

Contoh konfigurasi

Berikut beberapa contoh konfigurasi:

• Untuk melihat log terbaru, setel toolbar dasbor ke 1H, biarkan kolom Query Editor kosong, dan biarkan kolom panel log pada nilai defaultnya.

• Untuk sementara hanya menampilkan log dengan tingkat keparahan minimal "Warning", pilih Warning di menu Severity pada panel log.

  Nilai menu Severity panel log direset ke Default saat Anda memuat ulang halaman atau keluar dari dasbor.

• Untuk mengonfigurasi panel log agar hanya menampilkan log yang memiliki tingkat keparahan "Warning", di kolom Query Editor, tambahkan klausa severity=WARNING.

  Kueri yang disimpan di kolom Query Editor akan disimpan. Meskipun Anda me-refresh halaman atau memuat ulang dasbor, panel log hanya menampilkan log yang cocok dengan level peringatan yang ditentukan.

• Untuk mengonfigurasi panel log agar hanya menampilkan log instance Compute Engine, di kolom Query Editor, tambahkan klausa resource.type="gce_instance".

Pesan "No entries found matching current filter" ditampilkan ketika tidak ada entri log yang memenuhi setelan saat ini. Jika Anda mengonfigurasi kueri di kolom Query Editor dan juga menyetel filter panel log, setelan tersebut mungkin saja bertentangan. Untuk mengetahui informasi selengkapnya, lihat Panel log menampilkan pesan "No entries found".

Melihat entri log di Logs Explorer

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

1. Pilih View in Logs Explorer di panel log.

2. Dalam dialog, pilih project Google Cloud untuk membuka Logs Explorer.

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

3. Pilih entri log yang ingin Anda lihat.

Menambahkan 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 Monitoring dengan melakukan hal berikut:

1. Di panel navigasi konsol Google Cloud, pilih Monitoring, lalu pilih  Dashboards:

   Buka Dasbor

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 untuk ditampilkan di diagram dengan membuat kueri menggunakan SQL, lalu klik Run query.

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

   Di panel Display, Anda dapat mengubah jenis diagram dan menyesuaikan baris dan kolom mana yang dipetakan dengan mengubah dimensi, ukuran, dan perincian:

   • Dimensi: Dimensi harus berupa stempel waktu, angka, atau kolom 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 untuk dijalankan 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 pengelompokan.

   Untuk mengetahui informasi selengkapnya tentang 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.

Menambahkan panel pelaporan error

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 tindakan berikut:

1. Di panel navigasi konsol Google Cloud, pilih Monitoring, lalu pilih  Dashboards:

   Buka Dasbor

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

7. Opsional: Untuk membatasi resource tempat error ditampilkan, lakukan langkah berikut:

   1. Klik All Resources dan pilih materi.

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

      • Jika ingin 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 ke dasbor, di toolbar, klik Apply. 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 logs menunjukkan bahwa panel tersebut menampilkan sebagian data
• Panel log melaporkan kueri yang tidak valid
• Panel logs menampilkan pesan "No entries found"

Langkah selanjutnya

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

• Untuk mengetahui informasi cara mengonfigurasi panel log menggunakan Cloud Monitoring API, lihat Dasbor dengan widget LogsPanel.

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