Dokumen ini menyajikan ringkasan tentang Logs Explorer di Konsol Google Cloud, yang dapat Anda gunakan untuk mengambil, melihat, dan menganalisis entri log yang disimpan dalam bucket log. Melihat dan menganalisis masing-masing 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 menjalankan operasi agregat 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 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 artikel Ringkasan Analisis log.
Sebelum memulai
Untuk mendapatkan izin yang Anda perlukan guna melihat entri log, minta administrator untuk memberi Anda peran IAM berikut:
-
Untuk melihat entri log di bucket
_Required
dan entri dalam tampilan_Default
di bucket_Default
: Logs Viewer (roles/logging.viewer
) di project Anda. -
Untuk melihat entri log dalam bucket
_Required
dan_Default
: Private Logs Viewer (roles/logging.privateLogViewer
) di project Anda. -
Untuk melihat entri log yang disimpan dalam tampilan log di bucket log:
Logs View Accessor (
roles/logging.viewAccessor
) pada project yang berisi bucket yang ditentukan pengguna. Untuk informasi tentang cara memberikan akses hanya ke tampilan log tertentu, lihat Memberikan akses ke tampilan log. -
Untuk melihat 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.
Mulai
Untuk mulai menggunakan Logs Explorer, lakukan langkah berikut:
-
Di panel navigasi konsol Google Cloud, pilih Logging, lalu pilih Logs Explorer:
Pilih project, folder, atau organisasi 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 menampilkan entri log, mengurai dan menganalisisnya, serta menentukan parameter kueri.
Logs Explorer berisi bagian berikut, yang dijelaskan di halaman ini:
Toolbar Tindakan
Dengan menggunakan fitur toolbar Action, Anda dapat melakukan hal berikut:
- Sempurnakan cakupan: Mengonfigurasi entri log mana yang diambil dari bucket log untuk ditampilkan. Kueri yang Anda tulis akan memfilter entri log yang diambil. Untuk informasi selengkapnya, 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
Saat Anda membuka halaman Logs Explorer, halaman ini akan mengambil entri log
yang melewati sink resource yang telah dipilih, dan
Anda memiliki izin untuk melihatnya.
Untuk semua resource, entri log yang diambil mencakup entri yang berasal dari resource. Untuk project Google Cloud, entri log yang diambil juga mencakup entri yang dirutekan ke project.
Jika Anda memasukkan kueri, Logs Explorer hanya akan menampilkan entri log yang diambil dan juga cocok dengan kueri.
Misalnya, penambahan kueri severity>=ERROR
akan menghasilkan
tampilan yang hanya mencantumkan entri log tersebut dengan tingkat keparahan minimal
ERROR
.
Untuk sesi saat ini, Anda dapat mengonfigurasi entri log yang diambil Logs Explorer. Misalnya, saat memecahkan masalah, Anda mungkin ingin memeriksa entri log yang disertakan dalam tampilan log atau yang berasal dari project Google Cloud tertentu.
Untuk mengonfigurasi entri log yang diambil oleh halaman Logs Explorer, lakukan langkah berikut:
Di toolbar Tindakan, pilih Pertajam cakupan.
Pilih cara halaman Logs Explorer untuk mengambil entri log:
Untuk mengambil entri log yang diteruskan melalui sink resource yang Anda pilih, pilih Scope by current project.
Untuk semua resource, entri log yang diambil mencakup entri yang berasal dari resource. Untuk project Google Cloud, entri log yang diambil juga mencakup entri yang dirutekan ke project.
Untuk mengambil entri log menurut tampilan log, pilih Scope by storage, lalu pilih satu atau beberapa tampilan log.
Untuk folder dan organisasi, menu tampilan log mencakup semua tampilan log yang menyimpan entri log yang berasal dari resource tersebut.
Untuk project Google Cloud, menu tampilan log mencakup semua tampilan log di bucket log dalam project yang dipilih. Untuk memilih tampilan log di bucket log yang disimpan di project Google Cloud lainnya, klik add_circle Import project, pilih project Google Cloud, lalu pilih tampilan log.
Klik Terapkan.
Panel Query
Gunakan fitur panel Query untuk melakukan hal berikut:
Tab Query: Bangun dan saring kueri menggunakan fitur berikut:
Pemilih rentang waktu: Menentukan rentang waktu untuk entri 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. Ketika kueri tidak diberikan, Logging menampilkan setiap entri log saat disimpan.
Untuk menghentikan streaming, klik Stop streaming, atau scroll dalam panel Query results.
Toolbar Hasil
Dari toolbar Hasil, Anda memiliki opsi berikut:
- toggle_off 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.
- toggle_off Histogram: Menampilkan atau menyembunyikan panel Histogram dari tata letak halaman Logs Explorer Anda. Untuk mengetahui informasi selengkapnya, lihat bagian Histogram dalam dokumen ini.
- manage_search 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.
- add_chart Buat metrik: Menyiapkan metrik berbasis log.
- add_alert Buat pemberitahuan: Siapkan 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 buat 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 manage_search Analyze results.
Tombol Analisis hasil manage_search hanya dapat dilihat jika cakupan yang Anda pilih berisi bucket log yang telah diupgrade untuk menggunakan Log Analytics. Misalnya, jika Anda memilih Scope by storage scope menggunakan tombol Refine scope, tombol manage_search Analyze results akan ditampilkan saat setidaknya satu bucket dalam cakupan penyimpanan diupgrade untuk menggunakan Log Analytics. Untuk mengetahui informasi selengkapnya, lihat bagian Mengupgrade bucket log untuk menggunakan Log Analytics.
Hal berikut terjadi saat Anda mengklik manage_search 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 tentang cara menggunakan SQL untuk menulis kueri, 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 resource
Jika Anda menggunakan BindPlane untuk menulis log hybrid cloud dan lokal, lalu pilih jenis resource Generic Node.
Tingkat keparahan
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:
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:
Di panel Query results, luaskan entri log dengan mengklik chevron_right Expand.
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
danprotoPayload.startTime
. - Kolom dengan kardinalitas tinggi; misalnya,
insertId
danprotoPayload.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
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.
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.
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.
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 chevron_right Panah maju untuk menggeser linimasa ke waktu berikutnya. Klik chevron_left Panah mundur untuk menggeser linimasa ke waktu sebelumnya.
Memperbesar dan memperkecil: Klik zoom_out Zoom-out untuk memperluas data yang ditampilkan di linimasa. Klik zoom_in 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.
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:
Tahan kursor ke batang di linimasa histogram. Akan muncul panel yang berisi informasi ringkasan tentang data log untuk rentang waktu yang ditentukan.
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:
Arahkan kursor ke batang di linimasa Histogram. Akan muncul panel yang berisi informasi ringkasan tentang data log untuk rentang waktu yang ditentukan.
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 arrow_drop_down 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 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 toggle_off 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 toggle_off 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:
Klik tombol edit Edit di kolom Ringkasan untuk membuka menu pengeditan.
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 menjadijsonPayload."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 toggle_off 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.
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 :
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:
Di panel Query results, pada entri log, klik chevron_right Expand.
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:
Di panel Query results, pada entri log, klik chevron_right Expand.
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:
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 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 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:
Pada entri log, klik chevron_right 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:
Di panel Query results, pada entri log, klik chevron_right Expand.
Klik nilai kolom dalam entri log, seperti
compute.googleapis.com
, yang merupakanserviceName
.Anda akan melihat menu berikut:
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:
- Tahan kursor ke entri log yang ingin Anda sematkan.
- Klik Pasang push_pin Pin.
Setelah Anda menyematkan entri log, latar belakangnya akan digelapkan, dan ikon Pin push_pin akan ditampilkan. Ikon pin
juga muncul di panel Histogram berdasarkan
timestamp
entri log
yang disematkan:
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:
Klik arrow_drop_down Panah bawah di samping log yang disematkan untuk meluaskan menu penyematan.
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
berupak8s_node
. Jika Anda memilih Same resource.type, kueri akan dijalankan ulang untuk menampilkan semua entri log denganresource.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 push_pin 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.
Jika entri log hanya berisi kolom trace
, hanya ikon trace yang muncul.
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 keTrue
. Untuk informasi selengkapnya tentang pengambilan sampel, lihat Frekuensi sampling.
Menyalin link ke entri log
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.
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:
Klik save_alt Download di toolbar untuk panel Query results.
Pada dialog Download logs, pilih format CSV atau JSON, lalu klik Download.
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 save_alt 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:
-
Di panel navigasi Konsol Google Cloud, pilih Compute Engine, lalu pilih VM instances:
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.
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.