Lihat log menggunakan Logs Explorer

Dokumen ini menyajikan ringkasan tentang Logs Explorer di Konsol Google Cloud, yang dapat Anda gunakan untuk mengambil, melihat, dan menganalisis data log. Logs Explorer memungkinkan Anda menemukan dan melihat log sehingga Anda dapat memecahkan masalah. Anda juga dapat membaca log menggunakan Logging API dan Google Cloud CLI.

Setiap elemen histogram menampilkan perkiraan jumlah entri log yang diterima dalam interval waktu yang terkait dengan elemen tersebut. Untuk mendapatkan jumlah persis entri log yang diterima dalam interval waktu, gunakan Analisis Log atau salin log ke bucket Cloud Storage.

Untuk menjalankan operasi gabungan pada entri log Anda, seperti menghitung jumlah entri log yang berisi pola tertentu, upgrade bucket log untuk menggunakan Log Analytics, lalu jalankan kueri dari halaman Log Analytics. Anda dapat terus menggunakan Logs Explorer untuk melihat log di bucket log yang telah diupgrade untuk menggunakan Log Analytics. Untuk informasi selengkapnya, lihat artikel Ringkasan Analisis log.

Mulai

Untuk mendapatkan izin yang Anda perlukan guna melihat log di Logs Explorer, minta administrator Anda untuk memberi Anda peran IAM berikut:

  • Melihat semua log di bucket _Required, dan untuk melihat log dalam tampilan _Default di bucket _Default: Logs Viewer (roles/logging.viewer) di project Anda.
  • Melihat semua log di bucket _Required dan _Default, termasuk log akses data: Private Logs Viewer (roles/logging.privateLogViewer) di project Anda.
  • Melihat log yang disimpan dalam tampilan log di bucket log yang ditentukan pengguna: Logs View Accessor (roles/logging.viewAccessor) di project yang berisi bucket yang ditentukan pengguna. Jika memiliki peran Logs View Accessor tanpa kondisi yang dilampirkan, Anda dapat melihat log yang disimpan dalam tampilan log di bucket log yang ditentukan pengguna. Lihat Membaca log dari bucket untuk mengetahui contohnya.
  • Lihat kolom LogEntry yang dibatasi dalam bucket: Aksesor Kolom Logs (roles/logging.fieldAccessor) di project Anda. Untuk mengetahui informasi selengkapnya, lihat Mengonfigurasi akses tingkat kolom.

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.

Untuk mulai menggunakan Logs Explorer, lakukan langkah berikut:

  1. Di panel navigasi konsol Google Cloud, pilih Logging, lalu pilih Logs Explorer:

    Buka Logs Explorer

  2. Pilih project Google Cloud yang sesuai.

    Jika Anda menggunakan Amazon Web Services Elastic Compute Cloud (AWS EC2), entri log Anda berada di project konektor AWS yang menautkan akun AWS Anda ke layanan Google Cloud.

Antarmuka Logs Explorer

Antarmuka Logs Explorer memungkinkan Anda mengambil log, mengurai dan menganalisis data log, serta menyaring parameter kueri.

Antarmuka pengguna untuk Logs Explorer

Logs Explorer berisi bagian berikut, yang dijelaskan di halaman ini:

  1. Toolbar Action
  2. Panel Query
  3. Toolbar Hasil
  4. Panel Kolom log
  5. Histogram
  6. Panel hasil kueri

Toolbar Tindakan

Dengan menggunakan fitur toolbar Action, Anda dapat melakukan hal berikut:

  • Pertajam cakupan: Batasi penelusuran Anda berdasarkan log di project Google Cloud saat ini saja atau menurut satu atau beberapa tampilan penyimpanan. Untuk informasi selengkapnya tentang pencakupan, lihat Menyempurnakan cakupan.
  • Pelajari: Lihat link ke dokumentasi dan topik yang relevan.
  • Bagikan link: Buat URL kueri yang disingkat dan salin ke papan klip sehingga memudahkan Anda membagikan kueri. URL yang disalin memiliki rentang waktu absolut terkait yang diwakili oleh rentang waktu kueri Anda; misalnya, 7:49:37 PM - 8:49:37 PM.

Sempurnakan Cakupan

Jika log Anda disimpan dalam bucket log, Anda dapat melihat log tersebut di Logs Explorer. Bergantung pada project yang dipilih, Anda mungkin harus menyesuaikan cakupan Logs Explorer untuk melihat log yang disimpan dalam bucket log tertentu.

Secara default, Logs Explorer menampilkan semua log yang dihasilkan oleh resource dalam project saat ini atau yang dirutekan langsung ke project saat ini, lalu disimpan di bucket log mana pun. Secara default, Logs Explorer tidak menampilkan log yang dihasilkan oleh resource dalam project lain, lalu dirutekan ke bucket log dalam project saat ini.

Untuk menyesuaikan log yang ditampilkan di Logs Explorer, gunakan tombol Refine scope di toolbar Action:

  • Untuk melihat semua log yang dihasilkan, atau dirutekan langsung ke project saat ini, pilih Scope by current project.

    Sink log dapat merutekan log ke bucket log dalam project saat ini, ke bucket log dalam project berbeda, atau ke project yang berbeda. Untuk mengetahui informasi selengkapnya, lihat menurut Merutekan log ke tujuan yang didukung.

  • Untuk melihat log tertentu yang disimpan dalam bucket log dalam project saat ini, pilih Scope by storage, lalu pilih satu atau beberapa tampilan log. Gunakan opsi ini jika Anda menginginkan kontrol yang lebih terperinci terkait siapa yang memiliki akses ke log tertentu dalam bucket log dalam project saat ini.

    Untuk informasi selengkapnya tentang cara membuat dan mengelola tampilan log, lihat Mengonfigurasi tampilan log di bucket log.

  • Untuk melihat log tertentu yang disimpan di bucket log yang berada dalam project berbeda, pilih Scope by storage, klik Import project dalam pemilih tampilan log dan project, lalu pilih satu atau beberapa tampilan log. Gunakan opsi ini jika organisasi Anda memiliki beberapa project, yang masing-masing membuat log uniknya sendiri, dan Anda ingin melihat log tersebut secara bersamaan di Logs Explorer.

    Misalnya, untuk melihat semua log yang disimpan di bucket log, pilih tampilan _AllLogs:

    Dialog perbaiki cakupan yang menampilkan pemilih tampilan log dan project.

Panel Query

Gunakan fitur panel Query untuk melakukan hal berikut:

  • Tab Query: Bangun dan saring kueri menggunakan fitur berikut:

    • Pemilih rentang waktu: Tentukan rentang waktu untuk log yang ingin Anda lihat. Untuk informasi selengkapnya, lihat Menggunakan pemilih rentang waktu.

    • Kotak teks penelusuran: Menemukan entri log yang cocok dengan istilah atau frasa penelusuran Anda. Untuk mengetahui detailnya, lihat Menelusuri teks di seluruh kolom log.

    • Filter menu: Buat kueri berdasarkan Resource, Nama log, dan Keparahan. Untuk mengetahui informasi selengkapnya, lihat Menggunakan menu filter.

    • Kolom editor kueri: Membuat kueri lanjutan menggunakan bahasa kueri Logging. Untuk mengetahui detailnya, lihat bagian Menulis kueri lanjutan.

  • Tab Terbaru: Melihat kueri yang baru-baru ini Anda jalankan. Untuk mengetahui informasi selengkapnya, lihat Menggunakan kueri terbaru.

  • Tab Tersimpan: Melihat kueri dan kueri tersimpan Anda yang dibagikan oleh pengguna lain project Google Cloud kepada Anda. Untuk mengetahui informasi selengkapnya, lihat Menyimpan kueri dan Membagikan kueri.

  • Tab Suggested: Melihat kueri yang disarankan berdasarkan resource di project Google Cloud Anda. Untuk mengetahui informasi selengkapnya, lihat Menggunakan kueri yang disarankan.

  • Tab Library: Melihat dan menjalankan kueri yang disediakan Google berdasarkan kasus penggunaan Anda. Untuk mengetahui informasi selengkapnya, lihat Memilih kueri dari library.

  • Save: Menyimpan kueri yang dapat dilihat dan dijalankan dari tab Saved.

  • Clear query: Hapus dan reset pilihan yang Anda buat saat membuat kueri di panel Query.

  • Stream log: Melihat entri log saat Logging menyimpannya dalam bucket log. Untuk mengetahui informasi selengkapnya, lihat Streaming log.

  • Jalankan kueri: Jalankan kueri setelah Anda membuatnya di panel Query.

Jika Anda tidak melihat kolom editor kueri, aktifkan Tampilkan kueri. Jika Anda menambahkan istilah penelusuran apa pun di kotak teks penelusuran, istilah tersebut juga akan muncul di kolom editor kueri dan dievaluasi sebagai bagian dari ekspresi kueri Anda.

Setelah meninjau kueri, klik Jalankan kueri. Log yang cocok dengan kueri Anda akan tercantum di panel Query results. Panel Histogram dan Log fields juga menyesuaikan dengan ekspresi kueri.

Jalankan streaming log

Anda dapat melakukan streaming log karena Logging akan menyimpannya dalam bucket log, atau Anda dapat menambahkan kueri untuk hanya mengalirkan log yang cocok dengan kueri tersebut.

Untuk melakukan streaming log berdasarkan kueri, tambahkan kueri di panel Query, lalu pilih Stream logs. Karena Logging menyimpan data log di bucket log, hanya log yang cocok dengan kueri yang akan ditampilkan di panel Query results. Jika kueri tidak diberikan, Logging akan menampilkan setiap log saat disimpan.

Untuk menghentikan streaming, klik Stop streaming, atau scroll dalam panel Query results.

Toolbar Hasil

Dari toolbar Hasil, Anda memiliki opsi berikut:

  • Kolom log: Menampilkan atau menyembunyikan panel Kolom log dari tata letak halaman Logs Explorer. Untuk mengetahui informasi selengkapnya, lihat bagian panel Kolom log dalam dokumen ini.
  • Histogram: Menampilkan atau menyembunyikan panel Histogram dari tata letak halaman Logs Explorer Anda. Untuk mengetahui informasi selengkapnya, lihat bagian Histogram dalam dokumen ini.
  • Analisis hasil: Gabungkan dan buat diagram hasil kueri Anda menggunakan Log Analytics. Tombol ini hanya dapat dilihat jika cakupan yang Anda pilih berisi bucket log yang telah diupgrade untuk menggunakan Log Analytics. Untuk mengetahui informasi selengkapnya, lihat bagian Menganalisis hasil dalam dokumen ini.
  • Buat metrik: Menyiapkan metrik berbasis log.
  • Buat pemberitahuan: Menyiapkan pemberitahuan berbasis log.
  • Lompat ke sekarang: Lakukan refresh paksa terhadap hasil kueri Anda untuk menyertakan waktu saat ini. Jika pemilih rentang waktu menggunakan rentang kustom dan waktu berakhir telah ditetapkan, kueri akan dijalankan dengan rentang waktu default satu jam. Jika tidak, kueri akan diperbarui dengan tanggal mulai atau durasi saat ini, lalu menjalankan kueri. Perhatikan bahwa ekspresi kueri tidak berubah saat Anda menggunakan fitur ini.
  • Tindakan lainnya: Gunakan opsi lebih lanjut ini untuk mengelola pemberitahuan berbasis log atau membuat sink.

Analisis hasil

Anda dapat menggabungkan, menganalisis, dan membuat diagram data log dengan menggunakan kueri SQL di halaman Log Analytics jika project Anda berisi bucket log yang diupgrade untuk menggunakan Log Analytics. Untuk membuka halaman Log Analytics dari Logs Explorer, di toolbar Results, klik Analyze results.

Tombol Analisis hasil hanya dapat dilihat jika cakupan yang Anda pilih berisi bucket log yang telah diupgrade untuk menggunakan Log Analytics. Misalnya, jika Anda memilih Cakupan menurut cakupan penyimpanan dengan menggunakan tombol Refine scope, tombol Analyze results akan ditampilkan saat setidaknya satu bucket dalam cakupan penyimpanan diupgrade untuk menggunakan Log Analytics. Untuk informasi cara mengupgrade bucket log agar dapat menggunakan Log Analytics, lihat Mengupgrade bucket log untuk menggunakan Log Analytics.

Hal berikut terjadi saat Anda mengklik Analyze results:

  • Rentang waktu di Logs Explorer dapat disesuaikan secara otomatis sehingga ada data log yang berarti di halaman Log Analytics.

  • Halaman Log Analytics akan terbuka di tab baru dan secara otomatis menerjemahkan kueri bahasa kueri Logging saat ini menjadi kueri SQL.

  • Cakupan yang Anda pilih di Logs Explorer dikonversi menjadi klausa FROM yang setara dalam kueri SQL:

    • Jika Anda memilih Cakupan menurut project saat ini, bucket _Required dan _Default akan dikueri.

    • Jika Anda memilih Cakupan menurut penyimpanan dengan satu atau beberapa tampilan log dipilih, hanya bucket log dalam project saat ini yang berisi tampilan log yang dipilih yang akan dikueri.

    • Jika Anda memilih Cakupan menurut penyimpanan dan menentukan tampilan log di project yang berbeda, tidak ada bucket log yang akan dikueri.

Di halaman Log Analytics, Anda dapat melihat hasil dalam bentuk tabel, atau sebagai diagram. Di tab Chart, Anda dapat memilih data yang dipetakan, menyesuaikan konfigurasi diagram, atau menyimpan diagram ke dasbor kustom. Untuk mengetahui informasi tentang cara membuat diagram dari hasil kueri dan menyimpan diagram ke dasbor kustom, lihat Membuat diagram hasil kueri dengan Log Analytics.

Untuk mengetahui informasi mengenai penggunaan SQL untuk menulis kueri di Log Analytics, baca artikel Membuat kueri dan melihat log di Log Analytics.

Panel Kolom log

Panel Log columns menawarkan ringkasan tingkat tinggi dari data log dan menyediakan cara yang efisien untuk menyaring kueri. Panel ini menunjukkan entri log yang diperinci berdasarkan dimensi berbeda, sesuai dengan kolom dalam entri tersebut.

Setelah Anda menjalankan kueri di kolom editor kueri, panel Log fields akan diisi berdasarkan hasil kueri. Panel ini menampilkan jumlah entri log untuk setiap dimensi yang didukung. Untuk setiap dimensi, Anda bisa membuat satu pilihan. Dimensi berikut selalu tersedia:

  • Jenis aset

    Jika Anda menggunakan BindPlane untuk menulis log hybrid cloud dan lokal, lalu pilih jenis resource Generic Node.

  • Keseriusan

    Jika Anda ingin kueri memfilter menurut beberapa tingkat keparahan, gunakan menu Keparahan.

Anda mungkin melihat dimensi Layanan:

  • Jika Anda memiliki log dengan jenis resource Kubernetes Container, dan jika Anda belum memfilter log berdasarkan jenis resource, menu Service akan terisi. Entri dalam menu ini ditentukan secara dinamis oleh nilai label k8s-pod/app resource.

    Misalnya, jika entri log yang serupa dengan yang berikut ditampilkan sebagai hasil kueri Anda, menu layanan akan menyertakan layanan bernama myservice:

    {
     ...
     labels: {
         compute.googleapis.com/resource_name: "mycluster1"
         k8s-pod/app: "myservice"
         k8s-pod/pod-template-hash: "5ffcd94fdd"
      }
      logName: "projects/my-project/logs/stdout"
      resource: {
         labels: {6}
         type: "k8s_container"
      }
      ...
    }
    
  • Jika Anda memfilter menurut jenis resource Audited Resource, menu Service akan diisi. Entri dalam menu ini ditentukan secara dinamis oleh nilai label service resource.

Dimensi lain, seperti Project ID, dicantumkan berdasarkan pilihan Anda. Misalnya, dimensi Project ID akan dicantumkan saat kueri Anda membatasi entri log ke entri log yang jenis resource-nya adalah Kubernetes Container, atau jika Anda telah memilih Scope by storage.

Saring kueri Anda

Untuk menyaring kueri, pilih nilai dari panel Log fields. Misalnya, jika Anda memilih Error pada judul Severity, panel kueri akan diperbarui untuk menyertakan severity=ERROR.

Screenshot berikut mengilustrasikan kolom editor kueri setelah tingkat keparahan dan jenis resource dipilih menggunakan panel Log fields:

Contoh panel Log fields dengan dua pilihan.

Untuk menghapus pilihan, klik Hapus X.

Menambahkan kolom ke panel Log fields

Anda dapat menambahkan pasangan nilai kunci LogEntry tertentu ke panel Kolom log dari entri log yang diisi di panel Query results. Misalnya, jika Anda sering memfilter menurut nilai kolom jsonPayload.message, maka tambahkan kolom tersebut ke panel Logs field.

Untuk menambahkan kolom ke panel Logs field, lakukan langkah-langkah berikut:

  1. Di panel Query results, luaskan entri log dengan mengklik Expand.

  2. Pilih nilai kolom. Dari menu, pilih Add field to Log fields pane.

    Kolom kustom muncul di panel Log fields sebagai daftar key-value pair.

Untuk menghapus kolom kustom dari panel Log fields, klik Remove di samping kolom tersebut.

Perlu diperhatikan bahwa jenis kolom berikut tidak dapat ditambahkan ke panel Log fields:

  • Kolom yang terkait dengan waktu; misalnya, receiveTimestamp dan protoPayload.startTime.
  • Kolom dengan kardinalitas tinggi; misalnya, insertId dan protoPayload.latency.
  • Kolom dengan indeks array di jalurnya; misalnya, protoPayload.authorizationInfo[0].resource.

Histogram

Dengan panel Histogram, Anda dapat memvisualisasikan distribusi log dari waktu ke waktu. Histogram dibuat ulang saat Anda menjalankan kueri, sehingga lebih mudah untuk melihat tren dalam data log dan memecahkan masalah.

Untuk menampilkan atau menyembunyikan panel Histogram, klik Histogram di toolbar Results.

Fitur Histogram

Panel histogram.

  1. Batang histogram: Setiap batang histogram mewakili rentang waktu. Setiap batang berisi pengelompokan tiga warna untuk level keparahan log yang ditangkap dalam rentang waktu setiap batang. Warna mewakili keparahan log berikut:

    • Biru: Tingkat keseriusan rendah seperti Default, Debug, Info, dan Notice.
    • Kuning: Keseriusan sedang, seperti Peringatan.
    • Merah: Tingkat keseriusan tinggi, seperti Error, Kritis, Peringatan, dan Darurat.

    Setiap panel histogram menampilkan menu dengan opsi untuk menganalisis log Anda.

  2. Kontrol waktu: Memungkinkan Anda menyesuaikan rentang waktu log yang Anda lihat di panel Query results. Untuk mengetahui detail tentang opsi ini, lihat Menganalisis log menggunakan kontrol waktu.

  3. Linimasa: Menunjukkan rentang waktu log, yang diwakili oleh batang histogram, yang ditampilkan dalam panel Query results. Linimasa membantu mengarahkan Anda ke log yang Anda lihat dalam rentang waktu kueri yang lebih panjang.

Menganalisis log menggunakan kontrol waktu

Anda dapat menggunakan kontrol waktu histogram untuk membantu menyelidiki dan menganalisis data log Anda.

Sesuaikan waktu dengan cepat

Histogram menyediakan kontrol waktu yang memungkinkan Anda menyesuaikan dengan cepat data yang Anda lihat di Logs Explorer.

Linimasa panel Histogram menampilkan kontrol waktu cepat.

  • Tuas waktu: Tarik tuas linimasa ke dalam untuk mempersempit data atau ke luar guna memperluas data di linimasa histogram. Klik Run.

  • Menggeser linimasa ke depan dan ke belakang: Klik Panah maju untuk menggeser linimasa ke waktu berikutnya. Klik Panah mundur untuk menggeser linimasa ke waktu sebelumnya.

  • Memperbesar dan memperkecil: Klik Zoom-out untuk memperluas data yang ditampilkan di linimasa. Klik Zoom-in untuk mempersempit data yang ditampilkan di linimasa.

Perubahan linimasa dibatasi antara waktu saat ini ("sekarang") dan 30 hari yang lalu.

Scroll atau zoom ke waktu

Selain kontrol waktu yang tercantum sebelumnya, histogram menyediakan fitur Scroll to time dan Zoom to time untuk memberi Anda kontrol yang lebih mendalam terhadap histogram dan data yang Anda lihat di panel lain di Logs Explorer.

Linimasa panel Histogram menampilkan scroll ke waktu dan zoom ke kontrol waktu.

Mungkin batang histogram tertentu menarik minat Anda berdasarkan ukuran relatif atau tingkat keparahannya. Anda dapat memilih batang histogram untuk menyesuaikan data log yang Anda lihat di Logs Explorer.

Anda dapat menggunakan fitur Scroll to time untuk menjelajahi data log tanpa mengubah nilai di panel Histogram dan Log fields. Saat Anda memilih fitur Scroll to time, hal berikut akan terjadi:

  • Data log yang Anda lihat di panel Query results menyesuaikan dengan rentang waktu yang diambil oleh batang histogram yang dipilih.

    Kueri tidak dijalankan, tetapi pemuatan ulang sebagian data mungkin terjadi untuk memastikan Anda melihat log di panel Query results yang sesuai dengan rentang waktu batang histogram yang dipilih.

  • URL konsol akan diupdate agar memuat timestamp log terbaru yang diambil oleh rentang waktu panel histogram yang dipilih.

Untuk memilih fitur Scroll to time, lakukan tindakan berikut:

  1. Tahan kursor ke batang di linimasa histogram. Akan muncul panel yang berisi informasi ringkasan tentang data log untuk rentang waktu yang ditentukan.

  2. Di panel, pilih Scroll to time.

    Atau, mengklik pada batang histogram sama dengan memilih Scroll to time.

Fitur Zoom ke waktu mirip dengan Scroll ke waktu, tetapi fitur ini menjalankan kueri pada data log Anda berdasarkan rentang waktu yang diambil oleh batang histogram yang dipilih. Saat Anda memilih fitur Zoom ke waktu, hal berikut akan terjadi:

  • Data log yang Anda lihat di panel Query results akan dimuat ulang dan dipersempit sesuai dengan batasan rentang waktu dari batang histogram yang dipilih.
  • URL konsol akan diupdate agar memuat timestamp log terbaru yang diambil oleh rentang waktu panel histogram yang dipilih.
  • Histogram berubah untuk hanya menampilkan log yang memiliki nilai timestamp yang berada dalam rentang waktu batang histogram yang dipilih. oleh batang histogram yang dipilih.
  • Data di panel Log fields disesuaikan dengan rentang waktu yang diambil oleh batang histogram yang dipilih.

Untuk memilih fitur Zoom ke waktu, lakukan hal berikut:

  1. Arahkan kursor ke batang di linimasa Histogram. Akan muncul panel yang berisi informasi ringkasan tentang data log untuk rentang waktu yang ditentukan.

  2. Di panel, pilih Zoom ke waktu.

Hasil kueri

Untuk melihat hasil kueri, gunakan panel Query results. Untuk membantu memecahkan masalah aplikasi, Anda dapat melihat detail setiap entri log, serta mengelompokkan dan menganalisis entri log untuk menemukan pola dalam log Anda. Jika Gemini diaktifkan di project tempat Anda melihat log, Anda juga dapat menggunakan Gemini untuk meringkas entri log.

Mengonfigurasi kolom Waktu

Kolom Time di panel Query results menampilkan stempel waktu entri log Anda. Anda dapat menyesuaikan kolom Time sehingga hanya bagian stempel waktu tertentu yang terlihat. Hal ini menciptakan lebih banyak ruang horizontal, sehingga Anda dapat melihat lebih banyak informasi dalam entri log.

Untuk memilih bagian stempel waktu yang akan ditampilkan, klik menu Additional time options di kolom Time, lalu pilih salah satu opsi berikut:

  • Tanggal, waktu, dan zona waktu

  • Tanggal dan waktu (default)

  • Waktu saja

Temukan pola di log Anda dengan menggunakan kolom ringkasan

Misalkan Anda melihat entri log dalam hasil kueri dan ingin membaca cepat hasilnya berdasarkan kolom LogEntry tertentu. Atau, mungkin Anda ingin mengelompokkan entri log Anda berdasarkan pasangan nilai kolom tertentu. Anda dapat menambahkan kolom ringkasan ke hasil, yang muncul sebagai chip di awal setiap baris entri log. Misalnya, gambar berikut menampilkan hasil kueri dengan kolom ringkasan resource.type yang ditambahkan ke setiap baris entri log:

Logs Explorer menampilkan log yang diawali dengan teks hijau yang menampilkan
jenis resource.

Logs Explorer menawarkan kolom ringkasan default dan kolom ringkasan kustom. Kolom ringkasan default bergantung pada hasil kueri Anda saat ini, dan kolom ringkasan kustom memungkinkan Anda memilih kolom di LogEntry.

Untuk menyembunyikan kolom ringkasan di hasil kueri Anda, gunakan tombol Kolom ringkasan. Saat tombol ini diaktifkan, hasilnya ditampilkan dalam format teks mentah. Secara default, konten setiap entri log dipotong agar sesuai dalam satu baris. Agar dapat menampilkan hingga 10 baris untuk setiap entri log, gunakan tombol Wraplines. Ruang putih dipertahankan di setiap entri log.

Untuk menyembunyikan kolom ringkasan tertentu, aktifkan Ringkasan kolom, lalu klik Sembunyikan kolom ringkasan.

Untuk mengubah kolom ringkasan, lakukan hal berikut:

  1. Klik tombol Edit di kolom Ringkasan untuk membuka menu pengeditan.

    Panel hasil kueri menampilkan tombol untuk mengedit kolom ringkasan.

  2. Dalam dialog Kelola kolom ringkasan, Anda dapat melakukan hal berikut:

    • Tambahkan nama kolom kustom ke Kolom ringkasan kustom.

      Pilihan kolom ringkasan memiliki fitur berikut:

      • Pelengkapan otomatis menggunakan log yang ditampilkan di hasil kueri Anda.
      • Koreksi kolom untuk karakter legal dalam tanda kutip.

      Misalnya, jika Anda mengetik jsonPayload.id-field, alamat tersebut akan berubah menjadi jsonPayload."id-field".

      Anda juga dapat memilih kolom LogEntry mana pun, terlepas dari apakah kolom tersebut disarankan kepada Anda dengan fungsi pelengkapan otomatis.

      Untuk menghapus kolom ringkasan kustom yang ada, klik X dalam chip-nya.

    • Aktifkan dan nonaktifkan pemotongan untuk kolom ringkasan kustom Anda.

      Untuk mempersingkat tampilan nilai kolom ringkasan, gunakan tombol di samping Truncate custom summary fields. Anda dapat memilih jumlah karakter yang ditampilkan sebelum kolom dipotong, dan apakah awal atau akhir kolom akan ditampilkan.

    • Menyembunyikan atau menampilkan kolom ringkasan default:

      Untuk menyesuaikan kolom ringkasan default yang ditampilkan di hasil kueri, luaskan menu Sembunyikan atau tampilkan kolom ringkasan default.

  3. Klik Terapkan.

    Kolom ringkasan kini diperbarui di hasil kueri Anda.

Menelusuri hasil kueri

Untuk menelusuri konten Query results, klik Find in results di panel Query results, lalu masukkan istilah penelusuran Anda. Filter ini memungkinkan Anda menemukan informasi dalam entri log tanpa membuat kueri baru.

Istilah yang cocok dengan kriteria penelusuran akan ditandai dalam entri log di dalam panel Query results:

Entri log dengan istilah penelusuran yang cocok akan ditandai.

Lihat entri log serupa

Anda dapat melihat entri log yang mirip dengan entri log yang dipilih, sehingga Anda dapat berfokus pada log yang diinginkan.

Untuk menampilkan entri log yang serupa, lakukan hal berikut:

  1. Di panel Query results, pada entri log, klik Expand.

  2. Klik Similar entri, lalu pilih Show Similar entries.

    Kueri ini diupdate dengan kueri yang mirip dengan berikut ini dan memuat ulang hasil kueri:

    --Show similar entries
    protoPayload.methodName="io.k8s.core.v1.configmaps.update"
    --End of show similar entries
    

Untuk melihat pratinjau entri log yang serupa, lakukan langkah berikut:

  1. Di panel Query results, pada entri log, klik Expand.

  2. Luaskan menu Similar entri, lalu pilih Preview Similar entries.

    Dialog terpisah akan terbuka dengan informasi berikut:

    • Pola yang ditemukan
    • Persentase entri log yang berisi pola
    • Contoh entri log yang berisi pola

    Dalam dialog ini, Anda dapat menyembunyikan atau menampilkan entri log:

    Dialog pratinjau entri log memungkinkan Anda menyembunyikan atau menampilkan entri log serupa.

Sembunyikan entri log serupa

Anda dapat menyembunyikan entri log serupa, sehingga Anda dapat menghapus log dari hasil kueri.

Ada dua cara untuk menyembunyikan entri log serupa:

  • Menyembunyikan sejumlah besar entri log yang dikelompokkan secara otomatis. Saat Anda menjalankan kueri, hasil kueri akan dianalisis untuk pola, dan entri log kemudian dikelompokkan secara otomatis berdasarkan konten kolom log yang serupa. Jika pola yang signifikan terdeteksi, banner akan muncul di panel Query results yang menunjukkan persentase hasil yang dapat disembunyikan:

    Sembunyikan banner log serupa.

    Sembunyikan entri serupa: Tombol ini menambahkan klausa ke kueri dan memuat ulang hasil kueri.

    Pratinjau: Jendela terpisah akan terbuka yang mendeskripsikan pola yang ditemukan, dan menampilkan contoh entri.

    Jika Anda menyembunyikan log serupa, tidak ada informasi yang disimpan di luar sesi Logs Explorer, dan setiap kueri akan menghasilkan analisis baru, yang hanya didasarkan pada log yang ditampilkan. Kueri yang berbeda menganalisis bagian entri log yang berbeda, bergantung pada jenis log yang ditampilkan.

  • Menyembunyikan entri log yang mirip dengan entri log tertentu. Untuk menyembunyikan entri log yang mirip dengan entri log, lakukan langkah berikut:

    1. Pada entri log, klik Expand, klik menu Similar entri, lalu pilih Hide serupa entri.

      Kueri akan diperbarui dan panel Query results akan dimuat ulang. Entri log yang serupa dengan entri log yang dipilih tidak ditampilkan.

Melihat atau menyembunyikan entri log yang cocok dengan kolom

Anda dapat melihat atau menyembunyikan entri log yang cocok dengan kolom dalam entri log sehingga Anda dapat berfokus pada entri yang berisi konten kolom yang sama.

Untuk menampilkan atau menyembunyikan entri log yang cocok dengan kolom tertentu dalam entri log, lakukan hal berikut:

  1. Di panel Query results, pada entri log, klik Expand.

  2. Klik nilai kolom dalam entri log, seperti compute.googleapis.com, yang merupakan serviceName.

    Anda akan melihat menu berikut:

    Menu dengan opsi untuk menyembunyikan dan menampilkan entri log berdasarkan kolom tertentu.

  3. Pilih Tampilkan entri yang cocok atau Sembunyikan entri yang cocok.

    Kueri diperbarui dengan kueri yang menampilkan atau menyembunyikan entri serupa, dan Query results akan dimuat ulang dengan hasil baru.

Sematkan entri log

Setelah menjalankan kueri, Anda dapat menandai entri log dengan menyematkannya. Entri log yang disematkan akan tetap berada di tengah panel Query results. Jika menjalankan kueri baru dan entri log yang disematkan tidak disertakan, Anda akan diminta untuk melepas pin entri log.

Untuk menyematkan entri log, lakukan langkah-langkah berikut:

  1. Tahan kursor ke entri log yang ingin Anda sematkan.
  2. Klik Pasang Pin.

Setelah Anda menyematkan entri log, latar belakangnya akan digelapkan, dan ikon Pin akan ditampilkan. Ikon pin juga muncul di panel Histogram berdasarkan timestamp entri log yang disematkan:

Logs Explorer menampilkan entri log yang disematkan di panel Query results dan Histogram.

Untuk melepas pin entri log, klik ikon pin lagi.

Tampilkan log yang cocok dengan resource entri log tersemat

Setelah menyematkan entri log, Anda dapat menjalankan kueri baru yang menampilkan entri log yang cocok dengan jenis resource atau label resource dari log yang disematkan.

Untuk menyematkan entri log dan menampilkan entri log yang cocok dengan jenis resource atau label resource yang sama, lakukan tindakan berikut:

  1. Klik Panah bawah di samping log yang disematkan untuk meluaskan menu penyematan.

  2. Tentukan pilihan dari menu penyematan:

    • Untuk menjalankan kembali kueri dengan resource.type yang sama seperti log yang disematkan, pilih Same resource.type.

      Misalnya, Anda menyematkan entri log dengan resource.type berupa k8s_node. Jika Anda memilih Same resource.type, kueri akan dijalankan ulang untuk menampilkan semua entri log dengan resource.type="k8s_node".

    • Untuk menjalankan kembali kueri dengan resource.labels yang sama seperti log yang disematkan, pilih Same resource.labels.

    • Untuk menjalankan kembali kueri dengan trace yang sama seperti log yang disematkan, pilih Pelacakan yang sama.

    • Untuk menghapus kueri dan menampilkan semua entri log, pilih Tampilkan semua.

Melihat entri log yang disematkan di panel Histogram

Anda dapat menggunakan panel Histogram untuk menandai, men-scroll, dan memeriksa lebih lanjut entri log yang disematkan.

Di panel Histogram, klik Pin, lalu pilih dari opsi menu berikut:

  • Scroll to log entry: Pindahkan entri log ke panel Query results saat ini dan lihat entri log yang disematkan dalam konteks log di sekitar.
  • Zoom ke entri log: Persempit rentang waktu yang ditampilkan panel Histogram dan saring kueri Anda untuk mengisolasi log di dekat log yang disematkan.

Melihat data trace

Jika entri log berisi trace dan kolom terkait latensi, ikon latensi dan trace akan muncul.

Tampilan entri log yang berisi data trace.

Jika entri log hanya berisi kolom trace, hanya ikon trace yang muncul.

Tampilan entri log yang hanya berisi kolom trace memiliki ikon trace.

Untuk melihat data trace yang terkait dengan entri log, klik ikon trace. Anda memiliki opsi berikut:

  • Melihat detail rekaman aktivitas: Menampilkan rekaman aktivitas span induk dan turunan beserta detail tentang rekaman aktivitas. Untuk melihat detail selengkapnya tentang trace, buka Cloud Trace dengan mengklik View in Trace. Untuk mengetahui informasi selengkapnya tentang konten di panel detail, lihat Menemukan dan menjelajahi rekaman aktivitas.
  • Tampilkan semua log untuk trace ini: Menyempurnakan dan menjalankan kueri dengan menambahkan kolom trace yang ditetapkan ke ID trace yang terkait dengan entri log.

  • Hanya tampilkan permintaan yang dilacak: Menyempurnakan dan menjalankan kueri dengan menambahkan kolom traceSampled yang disetel ke True. Untuk informasi selengkapnya tentang pengambilan sampel, lihat Frekuensi sampling.

Melihat data Monitoring

Untuk log tertentu, seperti log GKE dan Compute Engine, Anda dapat memilih jenis resource dari baris ringkasan log untuk menampilkan menu dengan opsi berikut:

  • Lihat detail pemantauan: membuka panel detail untuk resource GKE. Untuk mengetahui informasi tentang panel detail, lihat Melihat detail resource.
  • View in Monitoring: membuka halaman Monitoring untuk resource.
  • Lihat di GKE atau Lihat di Compute Engine: membuka halaman Detail untuk resource dalam antarmuka pengguna GKE atau Compute Engine.

Tampilan menu Logs Explorer untuk resource GKE.

Untuk membagikan link ke log, luaskan entri log, lalu pilih Salin link. Link akan disalin ke papan klip. Anda dapat mengirim link kepada pengguna yang memiliki akses ke project Google Cloud. Saat pengguna menempelkan link ke browser atau memilihnya, Logging akan menyematkan entri log di panel Query results.

Salin link untuk membagikan entri log kepada orang lain.

Download log

Anda dapat mendownload log dalam format CSV atau JSON. Anda memerlukan salah satu peran Identity and Access Management berikut untuk mendownload log:

  • Admin Logging (roles/logging.admin)
  • Aksesor Tampilan Log (roles/logging.viewAccessor)

Untuk mendownload log, lakukan langkah-langkah berikut:

  1. Klik Download di toolbar untuk panel Query results.

  2. Pada dialog Download logs, pilih format CSV atau JSON, lalu klik Download.

  3. Pilih tindakan yang harus dilakukan dengan data log. Anda memiliki opsi berikut ini:

    • Download data ke komputer Anda.
    • Download data ke Google Drive.
    • Lihat data di tab baru.

    Saat menyimpan CSV dan memilih Google Drive, Anda dapat membuka file di Google Spreadsheet.

Untuk informasi pemecahan masalah, lihat Download log gagal.

Contoh kueri

Untuk kueri yang disarankan, yang disusun oleh produk dan kasus penggunaan Google Cloud, lihat Contoh kueri menggunakan Logs Explorer. Misalnya, Anda dapat menjalankan kueri terkait Kubernetes untuk menemukan log Google Kubernetes Engine.

Lihat log Compute Engine

Untuk jenis resource Compute Engine tertentu, seperti gce_instance dan gce_network, Anda akan melihat nama resource dengan ID resource sebagai subteks di beberapa tempat di Logs Explorer. Misalnya, untuk jenis resource gce_instance, Anda akan melihat nama VM bersama dengan ID VM. Nama resource membantu Anda mengidentifikasi ID resource yang benar, yang dapat digunakan untuk mem-build kueri.

Anda mungkin melihat nama resource Compute Engine di tempat berikut:

  • Menu filter panel Query: Jenis resource Compute Engine menampilkan nama resource, dengan ID resource yang sesuai sebagai subteks.
  • Kolom log: Jenis resource Compute Engine menampilkan nama resource, bukan ID resource, pada dimensi kolom.
  • Hasil kueri: Untuk log instance VM Compute Engine, kolom resource.labels menampilkan metadata dengan nama resource yang sesuai.
  • Kolom ringkasan: Untuk log instance VM Compute Engine, chip menampilkan nama resource, bukan ID resource.

Memecahkan masalah

Bagian ini berisi petunjuk untuk memecahkan masalah umum saat menggunakan Logs Explorer.

Jika Anda mengalami masalah saat mencoba melihat log di tujuan sink, lihat Memecahkan masalah perutean dan sink.

Download log gagal

Anda menggunakan Logs Explorer, lalu klik Download. Perintah dimulai tetapi kemudian gagal diselesaikan atau melaporkan error.

Untuk mengatasi masalah ini, kurangi waktu yang diperlukan untuk mengeksekusi perintah dengan mencoba tindakan berikut:

  • Dalam dialog Download logs, kurangi nilai Maximum log entries.
  • Kurangi jangka waktu kueri log.
  • Di toolbar hasil kueri, klik Sembunyikan entri serupa sebelum memulai download.
  • Ubah kueri Anda untuk menggunakan kolom terindeks.

Tidak dapat menemukan log konsol untuk instance VM

Log yang ditulis ke konsol instance Compute Engine mungkin tidak tersedia di Logs Explorer. Untuk melihat log ini, lakukan langkah berikut:

  1. Di panel navigasi Konsol Google Cloud, pilih Compute Engine, lalu pilih VM instances:

    Buka instance VM

  2. Pilih instance, lalu pilih Serial port 1 (console) di bagian Logs pada halaman tersebut.

Anda dapat mengonfigurasi instance sehingga output port serialnya dikirim ke Cloud Logging. Untuk mengetahui informasi selengkapnya, lihat Mengaktifkan dan menonaktifkan logging output port serial.

Mendapatkan ID organisasi atau project Google Cloud

Untuk mendapatkan project Google Cloud atau ID organisasi dari mana saja di Konsol Google Cloud, luaskan daftar project Google Cloud dari pemilih project dan organisasi Google Cloud, lalu temukan project ID Google Cloud di kolom ID:

ID untuk project ditampilkan

Tidak dapat melihat entri log

Jika Anda tidak melihat entri log apa pun, periksa hal berikut:

  • Apakah project Google Cloud yang benar telah dipilih? Jika tidak, pilih project Google Cloud yang benar dari pemilih organisasi dan project Google Cloud.

  • Apakah project Google Cloud Anda menggunakan resource yang membuat log dan apakah ada aktivitas pada resource tersebut? Meskipun project Google Cloud masih baru, project tersebut harus memiliki log audit yang mencatat fakta bahwa project tersebut dibuat. Pastikan Anda menggunakan resource yang menghasilkan log, dengan membuka bagian "Mapping services to resource types" di halaman Daftar resource yang dipantau.

  • Apakah rentang waktu terlalu sempit? Verifikasi bahwa rentang waktu dalam kueri Anda sudah benar.

  • Lihat kueri pengecualian saat ini untuk memastikan log yang Anda cari tidak dikecualikan secara tidak sengaja.

  • Apakah cakupan yang benar digunakan untuk melihat log? Untuk mendapatkan petunjuk tentang cara menyesuaikan cakupan penelusuran, lihat Mempertajam cakupan.

Kueri saya benar, tetapi saya masih tidak melihat entri log

  • Anda tidak dapat melihat entri log yang lebih lama dari periode retensi data Logging. Lihat Periode retensi log untuk mengetahui periode retensi log yang berlaku.

  • Selama periode beban berat, mungkin ada penundaan dalam pengiriman log ke Logging atau dalam menerima dan menampilkan log.

  • Logs Explorer tidak menampilkan entri log yang memiliki stempel waktu di masa mendatang hingga waktu saat ini "terdapat" olehnya. Ini adalah situasi yang tidak biasa, mungkin disebabkan oleh kemiringan waktu dalam aplikasi yang mengirimkan log.

  • Cakupan kueri ditetapkan terlalu besar dan tidak dapat diselesaikan dalam jangka waktu yang wajar. Anda mungkin melihatnya sebagai "batas waktu berakhir sebelum operasi selesai". Coba buat kueri Anda lebih spesifik atau kurangi rentang waktunya.

Kueri menampilkan error

Jika Anda mengeluarkan kueri atas resource tanpa menentukan bucket, Cloud Logging akan menggunakan histori sink di project Google Cloud guna menentukan tempat entri mungkin ditulis untuk resource tersebut. Jika Cloud Logging mengidentifikasi lebih dari 200 bucket tempat entri mungkin telah ditulis, kueri akan gagal dengan pesan Error: Invalid query.

Untuk mengatasi masalah ini, persempit cakupan kueri Anda ke subset penyimpanan. Untuk informasi selengkapnya, lihat Menyempurnakan cakupan.

Rentang waktu hasil kueri tidak cocok dengan kueri

Data log yang Anda lihat di panel Query results dan Log fields menyesuaikan dengan rentang waktu yang diambil oleh linimasa histogram. Anda menyesuaikan linimasa histogram menggunakan kontrol waktu histogram atau pemilih rentang waktu. Menyesuaikan kontrol waktu ini tidak akan mengubah ekspresi kueri di panel Query.

Jika Anda memiliki kueri dengan stempel waktu, pemilih rentang waktu akan dinonaktifkan, dan kueri tersebut menggunakan ekspresi stempel waktu sebagai batasan rentang waktunya. Jika kueri tidak menggunakan ekspresi stempel waktu, kueri akan menggunakan pemilih rentang waktu sebagai batasan rentang waktunya.

Dapatkan dukungan

Untuk mengetahui informasi tentang cara mendapatkan dukungan, lihat halaman dukungan Kemampuan Observasi Google Cloud.