Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
Log di Jelajahi
Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 10.x.
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. Bekerja di Grafana versi 9
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. Bekerja di Grafana versi 8
Jelajahi memungkinkan Anda untuk menyelidiki log Anda di sumber data yang berbeda, termasuk:
Selama pemantauan infrastruktur dan respons insiden, Anda dapat menggali lebih dalam metrik dan log untuk menemukan penyebabnya. Jelajahi juga memungkinkan Anda untuk mengkorelasikan log dengan sinyal telemetri lain seperti metrik, jejak, atau profil, dengan melihatnya. side-by-side
Hasil kueri log ditampilkan sebagai garis log individual dan sebagai grafik yang menunjukkan volume log untuk periode waktu yang dipilih.
Volume log
Saat bekerja dengan sumber data yang mendukung volume log rentang penuh, Jelajahi secara otomatis menampilkan grafik yang menunjukkan distribusi log untuk semua kueri log yang dimasukkan. Fitur ini saat ini didukung oleh OpenSearch dan sumber data Loki.
catatan
Di Loki, volume log rentang penuh ini dirender oleh kueri metrik yang bisa mahal tergantung pada rentang waktu yang ditanyakan. Kueri ini bisa sangat menantang untuk diproses untuk instalasi Loki yang lebih kecil. Untuk mengurangi ini, Anda dapat menggunakan proxy seperti nginxX-Query-Tags dengan nilaiSource=logvolhist; header ini ditambahkan oleh Grafana ke semua kueri histogram volume log.
Jika sumber data tidak mendukung pemuatan volume log rentang penuh, model log menghitung deret waktu dengan menghitung baris log dan mengaturnya ke dalam ember berdasarkan interval waktu yang dihitung secara otomatis. Stempel waktu dari baris log pertama digunakan untuk menambatkan awal volume log dalam hasil. Akhir dari deret waktu berlabuh ke rentang To picker waktu. Dengan cara ini, Anda masih dapat menganalisis dan memvisualisasikan data log secara efisien bahkan ketika sumber data tidak menawarkan dukungan jangkauan penuh.
Log
Di bagian berikut, Anda akan menemukan penjelasan terperinci tentang cara memvisualisasikan dan berinteraksi dengan log individu di Jelajahi.
Navigasi log
Navigasi log, di sisi kanan baris log, dapat digunakan untuk dengan mudah meminta log tambahan. Anda dapat melakukan ini dengan mengklik tombol Log lama di bagian bawah navigasi. Ini sangat berguna ketika Anda mencapai batas garis dan Anda ingin melihat lebih banyak log. Setiap permintaan yang dijalankan dari navigasi kemudian ditampilkan dalam navigasi sebagai halaman terpisah. Setiap halaman menampilkan from dan to stempel waktu dari baris log masuk. Anda dapat melihat hasil sebelumnya dengan mengklik setiap halaman. Jelajahi cache lima permintaan terakhir yang dijalankan dari navigasi log, sehingga Anda tidak menjalankan kembali kueri yang sama saat mengklik halaman, menghemat waktu dan sumber daya.
Opsi visualisasi
Anda dapat menyesuaikan bagaimana log ditampilkan dan memilih kolom mana yang ditampilkan.
| Opsi | Deskripsi |
|---|---|
| Waktu | Menampilkan atau menyembunyikan kolom waktu. Ini adalah stempel waktu yang terkait dengan baris log seperti yang dilaporkan dari sumber data. |
| Label unik | Menampilkan atau menyembunyikan kolom label unik yang hanya menyertakan label yang tidak umum. Semua label umum ditampilkan di atas. |
| Bungkus garis | Setel ini ke true jika Anda ingin tampilan menggunakan pembungkus garis. Jika diatur kefalse, itu akan menghasilkan pengguliran horizontal. |
| Mempercantik JSON | Setel ini true untuk mencetak semua log JSON dengan cantik. Pengaturan ini tidak memengaruhi log dalam format apa pun selain JSON. |
| Deduplikasi | Data log bisa sangat berulang dan Explore dapat membantu dengan menyembunyikan baris log duplikat. Ada beberapa algoritma deduplikasi berbeda yang dapat Anda gunakan. Pencocokan yang tepat dilakukan di seluruh baris kecuali untuk bidang tanggal. Pencocokan angka dilakukan di telepon setelah menghapus nomor seperti durasi, alamat IP, dan sebagainya. Tanda tangan adalah deduplikasi yang paling agresif karena menghapus semua huruf dan angka dan kecocokan pada spasi putih dan tanda baca yang tersisa. |
| Menampilkan urutan hasil | Anda dapat mengubah urutan log yang diterima dari urutan menurun default (terbaru pertama) menjadi urutan naik (tertua pertama). |
Unduh baris log
Untuk mengunduh hasil log dalam salah satu txt atau json format, gunakan tombol Unduh. Fitur ini memungkinkan Anda menyimpan data log untuk analisis lebih lanjut atau membagikannya dengan orang lain dalam format yang nyaman dan dapat diakses.
Informasi meta hasil log
Di atas baris log yang diterima, Anda dapat menemukan informasi meta penting, termasuk:
-
Jumlah log yang diterima - Menunjukkan jumlah total log yang diterima untuk kueri atau rentang waktu saat ini.
-
Kesalahan - Menampilkan kemungkinan kesalahan dalam hasil log Anda.
-
Label umum - Menunjukkan label umum.
-
Total byte diproses - Merupakan ukuran kumulatif data log yang diproses dalam byte.
catatan
Ketersediaan informasi meta tertentu mungkin tergantung pada sumber data, dan sebagai hasilnya, Anda hanya dapat melihat beberapa detail ini untuk sumber data tertentu.
Melarikan diri dari baris baru
Jelajahi secara otomatis mendeteksi beberapa urutan lolos yang salah di baris log, seperti baris baru (\n,\r) atau tab (). \t Saat mendeteksi urutan seperti itu, Explore menyediakan opsi Escape baris baru.
Untuk secara otomatis memperbaiki urutan lolos yang salah yang terdeteksi oleh Explore
-
Pilih Escape baris baru untuk mengganti urutan.
-
Tinjau penggantian secara manual untuk mengkonfirmasi kebenarannya.
Jelajahi menggantikan urutan ini. Ketika melakukannya, opsi akan berubah dari baris baru Escape menjadi Remove escaping. Evaluasi perubahan karena parsing mungkin tidak akurat berdasarkan input yang diterima. Anda dapat mengembalikan penggantian dengan memilih Hapus escaping.
Tingkat log
Untuk log di mana level label ditentukan, kami menggunakan nilai label ini untuk menentukan tingkat log dan memperbarui warna setiap baris log yang sesuai. Jika log tidak memiliki label level tertentu, kami mencoba mencari tahu apakah isinya cocok dengan ekspresi yang didukung (lihat tabel berikut untuk informasi selengkapnya). Level log selalu ditentukan oleh pertandingan pertama. Dalam kasus di mana Grafana tidak dapat menyimpulkan bidang level log, itu akan divisualisasikan dengan level log yang tidak diketahui.
catatan
Jika Anda menggunakan sumber data Loki dan level merupakan bagian dari baris log Anda, Anda dapat menggunakan parser (JSON, logfmt, regex,..) untuk mengekstrak informasi level ke dalam label level yang digunakan untuk menentukan nilai level. Ini akan memungkinkan histogram untuk menunjukkan berbagai level log sebagai bilah terpisah.
Tingkat log yang didukung dan pemetaan singkatan dan ekspresi tingkat log:
| Tingkat log | Warna | Ekspresi yang didukung |
|---|---|---|
| kritis | ungu | muncul, fatal, waspada, kritik, kritis |
| kesalahan | merah | err, eror, kesalahan |
| memperingati | kuning | memperingatkan, memperingatkan |
| info | hijau | info, informasi, informasi, pemberitahuan |
| debug | biru | dbug, debug |
| jejak | biru muda | jejak |
| tidak diketahui | abu-abu | * |
Sorot kata-kata yang dicari
Saat kueri Anda menyertakan kata atau ekspresi tertentu untuk dicari, Explore akan menyorotnya di baris log untuk visibilitas yang lebih baik. Fitur penyorotan ini memudahkan untuk mengidentifikasi dan fokus pada konten yang relevan di log Anda.
catatan
Kemampuan untuk menyorot kata pencarian dapat bervariasi tergantung pada sumber data. Untuk beberapa sumber data, penyorotan kata pencarian mungkin tidak tersedia.
Tampilan detail log
Di Explore, setiap baris log memiliki bagian yang dapat diperluas yang disebut Detail log yang dapat dibuka dengan memilih baris log. Tampilan detail Log menyediakan informasi tambahan dan opsi eksplorasi dalam bentuk Bidang dan Tautan yang dilampirkan pada baris log, memungkinkan interaksi dan analisis yang lebih kuat.
Bidang
Dalam tampilan Detail log, Anda dapat memfilter bidang yang ditampilkan dengan dua cara: filter positif (untuk fokus pada bidang tertentu) dan filter negatif (untuk mengecualikan bidang tertentu). Filter ini akan memperbarui kueri terkait yang menghasilkan baris log, menambahkan ekspresi kesetaraan dan ketidaksetaraan yang sesuai. Jika sumber data memiliki dukungan, seperti halnya untuk Loki dan OpenSearch, detail log akan memeriksa apakah bidang sudah ada dalam tampilan kueri saat ini dan status aktif (hanya untuk filter positif), memungkinkan Anda untuk mengaktifkannya dari kueri, atau mengubah ekspresi filter dari positif ke negatif.
Anda dapat memilih subset bidang untuk divisualisasikan dalam daftar log alih-alih baris log lengkap dengan mengklik ikon mata. Setiap bidang memiliki ikon statistik untuk menampilkan statistik dalam kaitannya dengan semua log yang ditampilkan.
Tautan
Grafana menawarkan fungsionalitas tautan data atau korelasi, memungkinkan Anda mengonversi bagian mana pun dari pesan log menjadi tautan internal atau eksternal. Tautan ini dapat digunakan untuk menavigasi ke data terkait atau sumber daya eksternal, menyediakan cara yang mulus dan nyaman untuk mengeksplorasi informasi lebih lanjut.
Konteks log
Konteks log menampilkan baris konteks tambahan di sekitar entri log yang cocok dengan kueri penelusuran tertentu. Ini dapat membantu dalam memahami konteks entri log, dan mirip dengan -C parameter dalam grep perintah.
Anda mungkin menemukan baris panjang teks yang membuatnya sulit untuk membaca dan menganalisis konteks di sekitar setiap entri log. Di sinilah sakelar garis Bungkus bisa berguna. Dengan mengaktifkan sakelar ini, Grafana akan secara otomatis membungkus baris teks yang panjang sehingga sesuai dengan lebar penampil yang terlihat. Ini dapat membuatnya lebih mudah untuk membaca dan memahami entri log.
Tombol Buka dalam tampilan terpisah memungkinkan Anda menjalankan kueri konteks untuk entri log di layar terpisah di tampilan Jelajahi. Memilih tombol ini akan membuka panel Jelajahi baru dengan kueri konteks yang ditampilkan di samping entri log, sehingga lebih mudah untuk menganalisis dan memahami konteks sekitarnya.
Kueri konteks log juga dapat dibuka di tab browser baru dengan menekan tombol Ctrl (orCmd) sambil memilih tombol untuk membuka modal konteks. Saat dibuka di tab baru, filter yang dipilih sebelumnya juga diterapkan.
Salin baris log
Anda dapat dengan mudah menyalin konten baris log yang dipilih ke clipboard Anda dengan memilih tombol Salin baris log.
Salin tautan ke baris log
Menautkan baris log di Grafana memungkinkan Anda menavigasi dengan cepat ke entri log tertentu untuk analisis yang tepat. Dengan memilih tombol Salin shortlink untuk baris log, Anda dapat membuat dan menyalin URL pendek yang menyediakan akses langsung ke entri log yang tepat dalam rentang waktu absolut. Saat Anda membuka tautan, Grafana akan secara otomatis menggulir ke baris log yang sesuai dan menyorotnya dengan latar belakang biru, sehingga mudah untuk mengidentifikasi dan fokus pada informasi yang relevan.
catatan
Ini hanya didukung di Loki dan sumber data lain yang menyediakan id bidang.
Ekor langsung
Untuk melihat log real-time dari sumber data yang didukung, Anda dapat memanfaatkan fitur Live tailing di Jelajahi.
Untuk melihat log secara real-time dengan live tailing
-
Pilih tombol Live di toolbar Jelajahi untuk beralih ke tampilan Live tail.
-
Sementara dalam tampilan ekor langsung, log baru akan muncul dari bagian bawah layar, dan mereka akan memiliki latar belakang kontras yang memudar, memungkinkan Anda untuk dengan mudah melacak apa yang baru.
-
Jika Anda ingin menjeda tailing Langsung dan menjelajahi log sebelumnya tanpa gangguan, Anda dapat melakukannya dengan memilih tombol Jeda atau cukup menggulir tampilan log.
-
Untuk menghapus tampilan dan menghapus semua log dari tampilan, pilih tombol Hapus log. Tindakan ini akan mengatur ulang tampilan log dan memberi Anda batu tulis yang bersih untuk melanjutkan analisis log Anda.
-
Untuk melanjutkan Live tailing dan terus melihat log waktu nyata, pilih tombol Lanjutkan.
-
Jika Anda ingin keluar dari Live tailing dan kembali ke tampilan Jelajahi standar, pilih tombol Stop.
Dengan menggunakan fitur Live tailing, Anda dapat mengawasi log terbaru saat masuk, membuatnya lebih mudah untuk memantau peristiwa waktu nyata dan mendeteksi masalah dengan segera.
Log sampel
Jika sumber data yang dipilih mengimplementasikan sampel log, dan mendukung kueri log dan metrik, maka untuk kueri metrik Anda akan dapat secara otomatis melihat sampel baris log yang berkontribusi pada metrik yang divisualisasikan. Fitur ini saat ini didukung oleh sumber data Loki.
Beralih dari metrik ke log
Jika Anda berasal dari sumber data metrik yang mengimplementasikan DataSourceWithQueryExportSupport (seperti Prometheus) ke sumber data logging yang mendukung DataSourceWithQueryImportSupport (seperti Loki), maka itu akan menyimpan label dari kueri Anda yang ada di log dan menggunakannya untuk menanyakan aliran log.
Misalnya, grafana_alerting_active_alerts{job='grafana'} kueri Prometheus berikut setelah beralih ke sumber data Loki, akan berubah menjadi. {job='grafana'} Ini akan mengembalikan sepotong log dalam rentang waktu yang dipilih yang dapat digrep/teks dicari.
