Halaman ini diterjemahkan oleh Cloud Translation API.

Lihat log menggunakan Logs Explorer

Dokumen ini memberikan ringkasan tentang Logs Explorer di konsol Google Cloud, yang dapat Anda gunakan untuk mengambil, melihat, dan menganalisis entri log yang disimpan di bucket log. Melihat dan menganalisis setiap entri log dan urutan entri log dapat membantu Anda memecahkan masalah. Anda juga dapat membaca data log menggunakan Logging API dan Google Cloud CLI.

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

Bagian selanjutnya dari dokumen ini menjelaskan cara menggunakan Logs Explorer.

Sebelum memulai

Untuk mendapatkan izin yang diperlukan agar dapat menggunakan Logs Explorer untuk melihat entri log, minta administrator untuk memberi Anda peran IAM berikut:

Untuk melihat entri log di bucket _Required dan entri log di tampilan _Default di bucket _Default, atau untuk memilih cakupan log: Logs Viewer (roles/logging.viewer) di project, folder, atau organisasi Anda.
Untuk melihat semua entri log di bucket _Required dan _Default: Private Logs Viewer (roles/logging.privateLogViewer) di project, folder, atau organisasi Anda.
Untuk melihat kolom LogEntry yang dibatasi di bucket log: Logs Field Accessor (roles/logging.fieldAccessor) di project, folder, atau organisasi yang menyimpan bucket log. Untuk informasi tentang cara membatasi akses ke kolom LogEntry, lihat Mengonfigurasi akses tingkat kolom.
Untuk melihat dan mendownload entri log yang disimpan di tampilan log di bucket log: Logs View Accessor (roles/logging.viewAccessor) di project, folder, atau organisasi yang berisi bucket log. Untuk mengetahui informasi tentang cara mendapatkan akses hanya 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.

Mulai

Untuk mulai menggunakan Logs Explorer, lakukan hal berikut:

Di konsol Google Cloud, buka halaman Logs Explorer:
Buka Logs Explorer

Jika Anda menggunakan kotak penelusuran untuk menemukan halaman ini, pilih hasil yang subjudulnya adalah Logging.
Pilih project, folder, atau organisasi Google Cloud.

Entri log yang ditampilkan oleh halaman Logs Explorer bergantung pada hal berikut:
- Resource yang menelusuri entri log.
- Setelan rentang waktu.
- Peran Identity and Access Management (IAM) Anda di resource yang ditelusuri.
- Kueri Anda akan memfilter hasil penelusuran. Misalnya, menambahkan kueri severity>=ERROR akan menghasilkan tampilan yang hanya mencantumkan entri log tersebut dengan tingkat keparahan setidaknya ERROR.
Secara default, halaman Logs Explorer menelusuri resource yang tercantum dalam cakupan log default untuk entri log. Jika cakupan tersebut tidak dapat diakses, halaman akan menelusuri entri log yang berasal dari project, folder, atau organisasi yang Anda pilih. Saat project dipilih, hasil penelusuran akan menyertakan entri log yang dirutekan ke project oleh sink di project lain, lalu disimpan dalam bucket log.

Setelah halaman Logs Explorer terbuka, Anda dapat memilih resource yang akan ditelusuri untuk menemukan entri log oleh Logs Explorer. Perubahan yang Anda buat dengan menggunakan menu Pertajam cakupan hanya berlaku untuk sesi Anda saat ini.

Antarmuka Logs Explorer

Antarmuka Logs Explorer memungkinkan Anda menampilkan entri log, mengurai dan menganalisisnya, serta menentukan parameter kueri. Logs Explorer berisi bagian berikut, yang dijelaskan di halaman ini:

Toolbar utama
Panel Kueri
Panel Kolom log
Linimasa
Toolbar Hasil kueri
Panel hasil kueri

Toolbar utama

Dengan menggunakan toolbar utama, Anda dapat melakukan hal berikut:

Library kueri: Melihat kueri tersimpan, terbaru, dan yang disarankan. Untuk mengetahui informasi selengkapnya, lihat Menyimpan dan membagikan kueri.
Bagikan link: Buat URL singkat kueri dan salin ke papan klip, sehingga memudahkan Anda membagikan kueri. URL yang disalin memiliki rentang waktu absolut yang sesuai yang diwakili oleh rentang waktu kueri Anda; misalnya, 7:49:37 PM - 8:49:37 PM.
Preferensi: Sesuaikan tampilan halaman Logs Explorer, dan sesuaikan format hasil kueri Anda. Untuk mengetahui informasi selengkapnya, lihat Menetapkan preferensi untuk melihat data log.
Pemilih rentang waktu: Tentukan rentang waktu untuk entri log yang ingin Anda lihat. Untuk mengetahui informasi selengkapnya, lihat menggunakan pemilih rentang waktu.
Streaming log: Melihat entri log saat Logging menyimpannya di bucket log. Untuk informasi selengkapnya, lihat Log streaming.
Pelajari: Melihat link ke dokumentasi dan topik yang relevan.

Melihat kueri terbaru, tersimpan, dan yang disarankan

Untuk melihat kueri yang baru saja Anda jalankan, kueri yang Anda simpan untuk digunakan di lain waktu, dan kueri yang disarankan, klik tombol Library kueri.

Di tab Koleksi kueri, Anda dapat melihat hal berikut:

Kueri terbaru: Melihat kueri yang baru saja Anda jalankan. Untuk mengetahui informasi selengkapnya, lihat Menggunakan kueri terbaru.
Kueri tersimpan: Melihat kueri tersimpan dan kueri yang dibagikan oleh pengguna project Google Cloud lainnya kepada Anda. Untuk mengetahui informasi selengkapnya, lihat Menyimpan dan membagikan kueri.
Kueri yang disarankan: Melihat kueri yang disarankan berdasarkan resource di project Google Cloud Anda. Untuk mengetahui informasi selengkapnya, lihat Menggunakan kueri yang disarankan.
Kueri yang disediakan oleh Google Cloud: Melihat kueri yang disediakan oleh Google Cloud berdasarkan kasus penggunaan umum untuk berbagai layanan Google Cloud. Untuk mengetahui informasi selengkapnya, lihat Memilih kueri dari library.

Menetapkan preferensi untuk melihat data log

Untuk menyesuaikan cara data log ditampilkan dalam hasil kueri, klik tombol Preferensi , lalu pilih Lihat, Format, atau Kelola kolom ringkasan:

Untuk menampilkan atau menyembunyikan panel Linimasa dan Bidang log, untuk menyembunyikan chip ringkasan dalam hasil kueri, atau untuk mengubah urutan pengurutan log, pilih Tampilan.
Untuk mengonfigurasi kolom Time dari hasil kueri, pilih Format. Untuk informasi selengkapnya, lihat Mengonfigurasi kolom Waktu.
Untuk menampilkan hingga 10 baris untuk setiap entri log, pilih Format, lalu klik Gabungkan baris. Secara default, konten setiap entri log dipotong agar muat dalam satu baris. Ruang kosong dipertahankan di setiap entri log.
Untuk menemukan pola dalam log menggunakan kolom ringkasan, pilih Kelola kolom ringkasan. Untuk mengetahui informasi selengkapnya, lihat Menemukan pola dalam log menggunakan kolom ringkasan.

Mengonfigurasi kolom Waktu

Kolom Time di panel Query results menampilkan stempel waktu entri log Anda. Anda dapat menyesuaikan kolom Waktu sehingga hanya bagian stempel waktu tertentu yang terlihat. Tindakan ini akan membuat lebih banyak ruang horizontal sehingga Anda dapat melihat lebih banyak informasi di entri log.

Untuk memilih bagian stempel waktu yang akan ditampilkan, klik menu Preferensi , pilih Format, lalu pilih salah satu opsi berikut:

Tanggal, waktu, dan zona waktu
Tanggal dan waktu (default)
Hanya waktu

Menemukan pola dalam log menggunakan kolom ringkasan

Misalnya, Anda melihat entri log dalam hasil kueri dan ingin melihat sekilas hasil dengan cepat berdasarkan kolom LogEntry tertentu. Atau mungkin Anda ingin mengelompokkan entri log menurut pasangan nilai kolom tertentu. Anda dapat menambahkan kolom ringkasan ke hasil, yang muncul sebagai chip di awal setiap baris entri log.

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 apa pun di LogEntry.

Untuk menampilkan atau menyembunyikan semua chip kolom ringkasan dalam hasil kueri, klik tombol Preferensi, pilih Tampilan, lalu Tampilkan chip ringkasan. Jika opsi ini diaktifkan, hasilnya akan ditampilkan dalam format teks mentah.

Untuk menyembunyikan kolom ringkasan tertentu, aktifkan Kolom ringkasan, lalu klik Sembunyikan kolom ringkasan. Untuk mengubah kolom ringkasan, lakukan tindakan berikut:

Klik tombol Preferensi, lalu pilih Kelola kolom ringkasan.
Pada dialog Kelola kolom ringkasan, Anda dapat melakukan hal berikut:
- Tambahkan nama kolom kustom ke Kolom ringkasan kustom.
  
  Kolom ringkasan mendukung pelengkapan otomatis dan koreksi kolom untuk karakter yang sah dalam tanda kutip. Misalnya, jika Anda mengetik jsonPayload.id-field, huruf tersebut akan diubah menjadi jsonPayload."id-field".
  
  Anda juga dapat memilih kolom LogEntry, terlepas dari apakah kolom tersebut disarankan kepada Anda dengan fungsi pelengkapan otomatis.
  
  Untuk menghapus kolom ringkasan kustom yang ada, klik X di chip-nya.
- Aktifkan dan nonaktifkan pemotongan untuk kolom ringkasan kustom Anda.
  
  Untuk mempersingkat tampilan nilai kolom ringkasan, gunakan tombol di samping Pangkas kolom ringkasan kustom. Anda dapat memilih jumlah karakter yang akan ditampilkan sebelum kolom dipangkas, dan apakah awal atau akhir kolom ditampilkan.
  
  Tips: Untuk menampilkan nilai lengkap kolom ringkasan, arahkan kursor ke kolom ringkasan yang terpotong dalam hasil kueri Anda.
- Menyembunyikan atau menampilkan kolom ringkasan default:
  
  Untuk menyesuaikan kolom ringkasan default yang ditampilkan dalam hasil kueri, luaskan menu Sembunyikan atau tampilkan kolom ringkasan default.
Klik Terapkan.

Kolom ringkasan Anda kini diperbarui di hasil kueri.

Melihat log menurut rentang waktu

Untuk menentukan rentang waktu entri log yang ingin Anda lihat, gunakan pemilih rentang waktu.

Untuk melakukan refresh paksa hasil kueri agar menyertakan waktu saat ini, klik keyboard_tab Langsung ke sekarang.

Jalankan streaming log

Anda dapat menstreaming log karena Logging menyimpannya dalam bucket log, atau Anda dapat menambahkan kueri untuk hanya menstreaming log yang cocok dengan kueri.

Untuk melakukan streaming log berdasarkan kueri, tambahkan kueri di panel Kueri, lalu pilih tombol Streaming log di toolbar utama. Karena logging menyimpan data log dalam bucket log, hanya log yang cocok dengan kueri yang ditampilkan di panel Query results. Jika kueri tidak diberikan, Logging akan menampilkan setiap entri log saat disimpan.

Untuk menghentikan streaming, klik Hentikan streaming, atau scroll secara manual untuk menjeda streaming.

Panel Kueri

Untuk membuat kueri di Logs Explorer, gunakan panel kueri. Di panel kueri, Anda dapat membuat dan menyaring kueri menggunakan fitur berikut:

Telusuri semua kolom: Menemukan entri log yang cocok dengan istilah atau frasa penelusuran Anda. Setiap istilah penelusuran yang ditambahkan ke kolom Search all fields akan ditambahkan ke kolom editor kueri dan dievaluasi sebagai bagian dari ekspresi kueri Anda. Untuk informasi selengkapnya, lihat Menelusuri teks di seluruh kolom log.
Menu filter: Buat kueri menggunakan berbagai menu untuk memilih resource, nama log, tingkat keparahan, dan korelasi ke log lainnya. Untuk mengetahui informasi selengkapnya, lihat Menggunakan menu filter.
Kolom editor kueri: Buat kueri lanjutan menggunakan bahasa kueri Logging. Jika Anda tidak melihat kolom editor kueri, aktifkan Show query. Untuk mengetahui informasi selengkapnya, lihat Menulis kueri lanjutan menggunakan bahasa kueri Logging.

Catatan: Jika kueri berisi beberapa pernyataan, Anda dapat menentukan cara pernyataan tersebut digabungkan atau mengandalkan Cloud Logging yang secara implisit menambahkan batasan konjungtif, AND, di antara pernyataan. Misalnya, dialog kueri atau filter berisi dua pernyataan, resource.type = "gce_instance" dan severity >= "ERROR". Kueri sebenarnya adalah resource.type = "gce_instance" AND severity >= "ERROR". Cloud Logging mendukung batasan disjungtif, OR, dan batasan konjungtif, AND. Saat menggunakan pernyataan OR, sebaiknya Anda mengelompokkan klausa dengan tanda kurung. Untuk mengetahui informasi selengkapnya, lihat dokumentasi Bahasa kueri logging.

Setelah meninjau kueri, klik Jalankan kueri. Log yang cocok dengan kueri Anda akan tercantum di panel Query results. Panel Linimasa dan Kolom log juga disesuaikan sesuai dengan ekspresi kueri.

Memilih resource yang ditelusuri untuk entri log

Saat Anda membuka halaman Logs Explorer, halaman tersebut akan mengambil entri log yang berasal dari resource yang telah Anda pilih, dan yang memiliki izin untuk dilihat. Untuk project Google Cloud, entri log yang diambil juga mencakup entri yang dirutekan ke project oleh sink di project lain. Jika Anda memasukkan kueri, Logs Explorer hanya akan menampilkan entri log yang diambil dan juga cocok dengan kueri. Misalnya, menambahkan kueri severity>=ERROR akan menghasilkan tampilan yang hanya mencantumkan entri log tersebut dengan tingkat keparahan setidaknya ERROR.

Untuk sesi saat ini, Anda dapat mengonfigurasi resource yang akan ditelusuri oleh Logs Explorer untuk menemukan entri log menggunakan menu Persempit cakupan. Misalnya, saat memecahkan masalah, Anda mungkin hanya ingin memeriksa entri log yang disertakan dalam tampilan log atau yang berasal dari project Google Cloud tertentu.

Menu Pertajam cakupan memungkinkan Anda menelusuri menurut project saat ini, menurut tampilan log, atau menurut cakupan log:

Untuk menelusuri berdasarkan project, folder, atau organisasi yang dipilih dengan pemilih project, luaskan menu Pertajam cakupan, lalu pilih Project saat ini.

Untuk semua resource, hasil penelusuran menyertakan entri log yang berasal dari resource. Untuk project Google Cloud, hasil penelusuran juga menyertakan entri log yang dirutekan ke project oleh sink di project lain.
Untuk menelusuri tampilan log, luaskan menu Pertajam cakupan, pilih Tampilan log, lalu pilih satu atau beberapa tampilan log dari menu.

Catatan: Gunakan setelan ini jika Anda ingin melihat entri log yang dirutekan oleh sink gabungan.

Saat project dipilih dengan pemilih project, menu akan mencantumkan tampilan log di bucket log yang disimpan oleh project yang dipilih. Namun, saat folder atau organisasi dipilih, menu akan mencantumkan semua tampilan log yang menyimpan entri log yang berasal dari resource tersebut.

Untuk mengubah menu tampilan log agar menyertakan tampilan log di bucket log yang disimpan dalam project, klik Import project, lalu pilih project.
Untuk menelusuri resource yang disertakan dalam cakupan log, yang dapat mencakup project dan tampilan log, luaskan menu Pertajam cakupan, pilih Cakupan log, lalu pilih cakupan log.

Jika Anda ingin mengonfigurasi cakupan log, klik Kelola cakupan. Untuk informasi selengkapnya, lihat Membuat dan mengelola cakupan log.

Cakupan log berada dalam Pratinjau Publik.

Panel Kolom log

Panel Kolom log menawarkan ringkasan data log tingkat tinggi dan memberikan cara yang efisien untuk menyaring kueri. Panel menampilkan entri log yang dibagi berdasarkan dimensi yang berbeda, yang sesuai dengan kolom dalam entri ini.

Setelah Anda mengeksekusi 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 dapat membuat satu pilihan. Dimensi berikut selalu tersedia:

Jenis resource

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

Jika Anda ingin kueri memfilter berdasarkan 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 menurut jenis resource, menu Service akan diisi. Entri dalam menu ini ditentukan secara dinamis oleh nilai label k8s-pod/app resource.

Misalnya, jika entri log yang mirip dengan 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 Resource yang Diaudit, menu Layanan 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 dicantumkan saat kueri Anda membatasi entri log ke entri yang jenis resource-nya adalah Kubernetes Container, atau saat Anda telah memilih tampilan log.

Mempersempit kueri Anda

Untuk menyaring kueri, pilih nilai dari panel Kolom log. Misalnya, jika Anda memilih Error di judul Severity, panel kueri akan diperbarui untuk menyertakan severity=ERROR.

Untuk menghapus pilihan, klik tombol Hapus.

Menambahkan kolom ke panel Kolom log

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

Untuk menambahkan kolom ke panel Kolom log, lakukan hal berikut:

Di panel Query results, luaskan entri log dengan mengklik Expand this log entry.
Pilih nilai kolom. Dari menu, pilih Tambahkan kolom ke panel Kolom log.

Kolom kustom akan muncul di panel Kolom log sebagai daftar pasangan nilai kunci.

Untuk menghapus kolom kustom dari panel Kolom log, klik Hapus di samping kolom.

Perhatikan bahwa jenis kolom berikut tidak dapat ditambahkan ke panel Kolom log:

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.

Linimasa

Dengan panel Linimasa, Anda dapat memvisualisasikan distribusi log dari waktu ke waktu. Linimasa akan dibuat ulang saat Anda menjalankan kueri, sehingga mempermudah Anda melihat tren dalam data log dan memecahkan masalah.

Untuk menampilkan atau menyembunyikan panel Linimasa, klik keyboard_capslock Ciutkan linimasa.

Fitur Linimasa

Batang linimasa: Setiap batang linimasa mewakili rentang waktu. Setiap batang berisi perincian tiga warna untuk tingkat keparahan log yang diambil dalam rentang waktu setiap batang. Warna mewakili tingkat keparahan log berikut:
- Biru: Tingkat keparahan rendah seperti Default, Debug, Info, dan Notifikasi.
- Kuning: Tingkat keparahan sedang seperti Peringatan.
- Merah: Tingkat keparahan tinggi seperti Error, Critical, Alert, dan Emergency.
Setiap batang di Linimasa menampilkan menu dengan opsi untuk menganalisis log Anda.
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.
Rentang waktu: Menampilkan rentang waktu log, yang diwakili oleh batang histogram. Linimasa membantu mengarahkan Anda ke log yang Anda lihat dalam rentang waktu yang lebih besar dari kueri Anda.

Menganalisis log menggunakan kontrol waktu

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

Menyesuaikan kontrol waktu

Linimasa menyediakan kontrol waktu yang memungkinkan Anda menyesuaikan data yang Anda lihat di Logs Explorer:

Tombol waktu: Tarik tombol linimasa ke dalam untuk mempersempit data atau ke luar untuk memperluas data dalam linimasa. Klik Run.
Geser linimasa maju dan mundur: Klik Panah maju untuk menggeser linimasa ke waktu berikutnya. Klik Panah mundur untuk menggeser linimasa ke waktu sebelumnya.
Memperbesar dan memperkecil: Klik Perkecil untuk memperluas data yang ditampilkan di linimasa. Klik Perbesar untuk mempersempit data yang ditampilkan di linimasa.
Menyembunyikan linimasa: Klik keyboard_capslock Ciutkan linimasa untuk menyembunyikan linimasa.

Modifikasi linimasa dibatasi antara waktu saat ini ("sekarang") dan hingga 30 hari sebelumnya.

Men-scroll atau melakukan zoom ke waktu

Selain kontrol waktu yang tercantum sebelumnya, linimasa menyediakan fitur Scroll ke waktu dan Zoom ke waktu untuk memberi Anda kontrol yang lebih mendalam terhadap linimasa dan data yang Anda lihat di panel lain di Logs Explorer. Mungkin batang tertentu dalam linimasa menarik minat Anda berdasarkan ukuran atau tingkat keparahannya yang relatif. Anda dapat memilih batang tersebut 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 Linimasa dan Kolom log. Saat Anda memilih fitur Scroll to time, hal berikut akan terjadi:

Data log yang Anda lihat di panel Query results disesuaikan sesuai dengan rentang waktu yang diambil oleh panel linimasa yang dipilih.

Kueri tidak berjalan, tetapi pemuatan ulang sebagian data mungkin terjadi untuk memastikan Anda melihat log di panel Hasil kueri yang sesuai dengan rentang waktu panel linimasa yang dipilih.
URL konsol diperbarui untuk berisi timestamp log terbaru yang diambil oleh rentang waktu batang linimasa yang dipilih.

Untuk memilih fitur Scroll to time, lakukan hal berikut:

Tahan kursor ke batang di linimasa. Panel yang berisi informasi ringkasan tentang data log untuk rentang waktu yang ditentukan akan muncul.
Di panel, pilih Scroll to time.

Atau, mengklik batang linimasa setara dengan memilih Scroll to time.

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

Data log yang Anda lihat di panel Hasil kueri akan dimuat ulang dan dipersempit sesuai dengan batasan rentang waktu panel linimasa yang dipilih.
URL konsol diperbarui untuk berisi timestamp log terbaru yang diambil oleh rentang waktu batang linimasa yang dipilih.
Linimasa berubah untuk hanya menampilkan log yang memiliki nilai timestamp yang berada dalam rentang waktu panel linimasa yang dipilih.
Data di panel Log fields disesuaikan sesuai dengan rentang waktu yang diambil oleh panel linimasa yang dipilih.

Untuk memilih fitur Zoom to time, lakukan tindakan berikut:

Tahan kursor ke batang di linimasa. Panel yang berisi informasi ringkasan tentang data log untuk rentang waktu yang ditentukan akan muncul.
Di panel, pilih Zoom to time.

Toolbar Hasil kueri

Di toolbar Query results, Anda memiliki opsi berikut:

Menganalisis hasil: Menggabungkan dan membuat diagram hasil kueri menggunakan Log Analytics. Tombol ini hanya dapat dilihat jika cakupan yang Anda pilih berisi bucket log yang telah diupgrade untuk menggunakan Log Analytics. Untuk informasi selengkapnya, lihat bagian Menganalisis hasil dalam dokumen ini.

Tindakan: Pilih dari berbagai opsi untuk menganalisis data log Anda lebih lanjut:
- ink_highlighter Sorot dalam hasil: Masukkan teks yang akan disorot dalam hasil kueri Anda.
- Buat metrik: Siapkan metrik berbasis log.
- Create sink: Membuat sink log yang mengisi otomatis filter penyertaan sink dengan ekspresi kueri saat ini.
- Buat pemberitahuan log: Siapkan kebijakan pemberitahuan berbasis log.
- Kelola pemberitahuan: Melihat dan mengelola kebijakan pemberitahuan.
- Download: Download log dalam format CSV atau JSON. Untuk mengetahui informasi selengkapnya, lihat Mendownload log.

Analisis hasil

Anda dapat menggabungkan, menganalisis, dan membuat diagram data log 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 Analyze results hanya terlihat jika cakupan yang Anda pilih berisi bucket log yang telah diupgrade untuk menggunakan Log Analytics. Misalnya, jika Anda memilih Tampilan log menggunakan menu Pertajam cakupan, tombol Analisis hasil akan ditampilkan jika setidaknya satu bucket dalam cakupan penyimpanan diupgrade untuk menggunakan Log Analytics. Untuk mengetahui informasi selengkapnya, lihat Mengupgrade bucket log untuk menggunakan Log Analytics.

Hal berikut akan terjadi saat Anda mengklik Analisis hasil:

Rentang waktu di Logs Explorer mungkin disesuaikan secara otomatis sehingga ada data log yang bermakna di halaman Log Analytics.
Halaman Log Analytics akan terbuka di tab baru dan otomatis menerjemahkan kueri bahasa kueri Logging saat ini menjadi kueri SQL.
Resource yang dipilih oleh pemilih project Google Cloud dan nilai setelan Pertajam cakupan menentukan cara klausa FROM dalam kueri SQL dibuat. Resource yang dipilih dapat berupa project, folder, atau organisasi:
- Jika menu Pertajam cakupan mencantumkan Project, bucket _Required dan _Default resource akan dikueri.
- Jika menu Pertajam cakupan mencantumkan Tampilan, tampilan log di bucket log dalam project saat ini akan dikueri. Tampilan log di bucket log yang disimpan oleh resource yang berbeda akan diabaikan.
- Jika setelan Pertajam cakupan mencantumkan nama cakupan log, aturan sebelumnya akan diterapkan ke resource yang tercantum dalam cakupan log yang dipilih. Misalnya, jika cakupan log berisi tampilan log, hanya tampilan log tersebut di bucket log yang disimpan oleh resource yang akan dikueri. Cakupan log berada dalam Pratinjau Publik.
Catatan: Log Analytics tidak mendukung kueri di seluruh project atau region. Jika setelan Pertajam cakupan menyertakan entri log yang disimpan di beberapa project atau region, Log Analytics mungkin menampilkan entri log yang berbeda dengan halaman Logs Explorer.

Di halaman Log Analytics, Anda dapat melihat hasil dalam bentuk tabel, atau sebagai diagram. Di tab Diagram, 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 informasi tentang cara menggunakan SQL untuk menulis kueri, lihat Mengkueri dan melihat log di Log Analytics.

Menelusuri hasil kueri

Untuk menelusuri konten Hasil kueri, klik Menandai di hasil di panel Hasil kueri, lalu masukkan istilah penelusuran Anda. Filter ini memungkinkan Anda menemukan informasi dalam entri log tanpa membuat kueri baru.

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

Entri log dengan istilah penelusuran yang cocok akan ditandai.

Download log

Untuk mendapatkan izin yang diperlukan guna mendownload log, minta administrator untuk memberi Anda peran IAM Logs View Accessor (roles/logging.viewAccessor) di project Anda. Untuk mengetahui informasi selengkapnya tentang cara memberikan peran, lihat Mengelola akses ke project, folder, dan organisasi.

Peran ini berisi izin logging.logEntries.download. Anda juga dapat memberikan peran yang berisi izin logging.logEntries.list, yang memungkinkan akun utama melihat dan mendownload log.

Anda mungkin juga bisa mendapatkan izin ini dengan peran khusus atau peran bawaan lainnya.

Untuk mendownload log, lakukan tindakan berikut:

Di menu Tindakan pada panel Hasil kueri, klik Download.
Pada dialog Download logs, pilih format CSV atau JSON, lalu klik Download.
Pilih tindakan untuk 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 mengetahui informasi pemecahan masalah, lihat Download log gagal.

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

Melihat entri log serupa

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

Untuk menampilkan entri log yang serupa, lakukan hal berikut:

Di panel Query results, pada entri log, klik Expand.
Klik Similar entries, lalu pilih Show similar entries.

Kueri diperbarui dengan kueri yang mirip dengan berikut 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:

Di panel Query results, pada entri log, klik Expand.
Luaskan menu Similar entries, 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:

Menyembunyikan entri log yang serupa

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

Ada dua cara untuk menyembunyikan entri log yang serupa:

Menyembunyikan entri log yang dikelompokkan secara otomatis dalam jumlah besar. Saat Anda menjalankan kueri, hasil kueri akan dianalisis untuk menemukan pola, lalu entri log akan otomatis dikelompokkan berdasarkan konten kolom log yang serupa.

Jika pola yang signifikan terdeteksi, banner akan muncul di panel Query results yang menampilkan persentase hasil yang dapat disembunyikan.

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

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

Saat Anda menyembunyikan log serupa, tidak ada informasi yang disimpan di luar sesi Logs Explorer. Setiap kueri menghasilkan analisis baru, hanya berdasarkan log yang ditampilkan. Kueri yang berbeda menganalisis bagian yang berbeda dari entri log, bergantung pada jenis log yang ditampilkan.
Menyembunyikan entri log yang mirip dengan entri log tertentu.

Untuk menyembunyikan entri log yang mirip dengan entri log, klik Luaskan, klik menu Entri serupa, lalu pilih Sembunyikan entri serupa.

Kueri akan diperbarui dan panel Query results akan dimuat ulang. Entri log yang mirip 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, yang memungkinkan Anda berfokus pada entri yang berisi konten kolom yang sama.

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

Di panel Query results, pada entri log, klik Expand.
Klik nilai kolom dalam entri log, seperti compute.googleapis.com, yang merupakan serviceName.
Dari menu, pilih Show matching entries atau Hide matching entries.

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

Menyematkan entri log

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

Untuk menyematkan entri log, lakukan hal berikut:

Tahan kursor di atas entri log yang ingin disematkan.
Klik Pasang Pin.

Setelah Anda menyematkan entri log, latar belakangnya akan menjadi gelap, dan ikon Sematkan akan ditampilkan. Ikon pin juga muncul di panel Linimasa berdasarkan timestamp entri log yang disematkan.

Untuk melepas pin entri log, klik ikon pin lagi.

Menampilkan log yang cocok dengan resource entri log yang disematkan

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:

Klik Panah bawah di samping log yang disematkan untuk meluaskan menu sematkan.
Buat pilihan dari menu pin:
- Untuk menjalankan kembali kueri dengan resource.type yang sama dengan log yang disematkan, pilih Same resource.type.
  
  Misalnya, Anda menyematkan entri log dengan resource.type dari k8s_node. Jika Anda memilih Same resource.type, kueri akan dijalankan ulang untuk menampilkan semua entri log dengan resource.type="k8s_node".
- Untuk menjalankan ulang kueri dengan resource.labels yang sama dengan log yang disematkan, pilih resource.labels yang sama.
- Untuk menjalankan kembali kueri dengan trace yang sama dengan log yang disematkan, pilih Rekaman aktivitas yang sama.
- Untuk menghapus kueri dan menampilkan semua entri log, pilih Tampilkan semua.

Melihat entri log yang disematkan di Linimasa

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

Menggunakan Linimasa, klik Sematkan, lalu pilih dari opsi menu berikut:

Scroll ke entri log: Membawa entri log ke panel Query results saat ini dan melihat entri log yang disematkan dalam konteks log di sekitar.
Zoom ke entri log: Persempit rentang waktu yang ditampilkan panel Linimasa dan pertajam kueri Anda untuk mengisolasi log di dekat log yang disematkan.
Lepas pin: Lepaskan pin entri log.

Melihat data rekaman aktivitas

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

Tampilan entri log yang berisi data rekaman aktivitas.

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

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

Lihat detail trace: Menampilkan span induk dan trace turunan beserta detail tentang trace. Untuk melihat detail selengkapnya tentang trace, buka Cloud Trace dengan mengklik Lihat di Trace. Untuk mengetahui informasi selengkapnya tentang konten di panel detail, lihat Menemukan dan menjelajahi trace.

Tampilkan semua log untuk rekaman aktivitas ini: Memfilter dan menjalankan kueri dengan menambahkan kumpulan kolom trace ke ID rekaman aktivitas yang terkait dengan entri log.
Tampilkan permintaan yang dilacak saja: Memfilter dan menjalankan kueri dengan menambahkan kolom traceSampled yang ditetapkan ke True. Untuk informasi sampling selengkapnya, 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 informasi tentang panel detail, lihat Melihat detail resource.
Lihat di 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.

Menyalin link ke entri log

Untuk membagikan link ke log, luaskan entri log, lalu pilih Salin. Anda dapat memilih untuk menyalin log dalam JSON, atau link ke log. Link akan disalin ke papan klip Anda. Anda dapat mengirimkan link tersebut 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.

Contoh kueri

Untuk kueri yang disarankan, yang disusun berdasarkan 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.

Melihat 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, tempat Anda dapat membuat kueri.

Anda mungkin melihat nama resource Compute Engine di tempat berikut:

Menu filter panel Kueri: 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, dalam 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 akan menampilkan nama resource, bukan ID resource.

Memecahkan masalah

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

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

Download log gagal

Anda menggunakan Logs Explorer dan mengklik Download. Perintah dimulai, tetapi kemudian gagal selesai atau melaporkan error.

Untuk mengatasi masalah ini, kurangi waktu yang diperlukan untuk menjalankan perintah dengan mencoba hal berikut:

Di dialog Download logs, kurangi nilai Maximum log entries.
Kurangi jangka waktu kueri log.
Di toolbar hasil kueri, klik Sembunyikan entri serupa sebelum Anda memulai download.

Ubah kueri Anda untuk menggunakan kolom yang diindeks.

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

Di Konsol Google Cloud, buka halaman Instance VM:
Buka instance VM

Jika Anda menggunakan kotak penelusuran untuk menemukan halaman ini, pilih hasil yang subjudulnya adalah Compute Engine.
Pilih instance, lalu pilih Serial port 1 (konsol) di bagian Logs halaman.

Mendapatkan ID project atau organisasi Google Cloud

Untuk mendapatkan project atau ID organisasi Google Cloud 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.

Tidak dapat melihat entri log

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

Pastikan project Google Cloud yang benar telah dipilih.
Pastikan project Google Cloud Anda menggunakan resource yang menghasilkan log dan ada aktivitas di resource tersebut. Meskipun project Google Cloud masih baru, project tersebut harus memiliki log audit yang mencatat fakta bahwa project tersebut telah dibuat. Untuk informasi tentang cara memverifikasi bahwa Anda menggunakan resource yang menghasilkan log, lihat Memetakan layanan ke jenis resource.
Pastikan rentang waktu tidak terlalu sempit.
Lihat kueri pengecualian saat ini untuk memastikan bahwa log yang Anda cari tidak dikecualikan secara tidak sengaja.
Pastikan Anda memiliki izin untuk melihat entri log dalam project dan tampilan log yang dirujuk oleh setelan menu Pertajam cakupan. Untuk mengetahui informasi tentang cara menyesuaikan cakupan penelusuran, lihat Menyempurnakan cakupan.

Kueri saya sudah benar, tetapi saya masih tidak melihat entri log

Anda tidak dapat melihat entri log yang lebih lama dari periode retensi 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 "menyamai" entri log tersebut. Ini adalah situasi yang tidak biasa, kemungkinan disebabkan oleh penyimpangan waktu dalam aplikasi yang mengirim 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 waktu.

Kueri menampilkan error

Jika Anda mengeluarkan kueri melalui resource tanpa menentukan bucket, Cloud Logging akan menggunakan histori sink di project Google Cloud untuk menentukan tempat entri mungkin telah 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, pertajam cakupan kueri Anda ke subset penyimpanan. Untuk mengetahui informasi selengkapnya, lihat Menyempurnakan cakupan.

Rentang waktu hasil kueri tidak cocok dengan kueri

Data log yang Anda lihat di panel Hasil kueri dan Kolom log disesuaikan sesuai 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 Kueri.

Jika Anda memiliki kueri dengan stempel waktu, pemilih rentang waktu akan dinonaktifkan. Kueri 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.

Mendapatkan dukungan

Untuk informasi tentang cara mendapatkan dukungan, lihat halaman dukungan Google Cloud Observability.