Jelajahi

Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 8.x.

Untuk ruang kerja Grafana yang mendukung Grafana versi 10.x, lihat. Bekerja di Grafana versi 10

Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. Bekerja di Grafana versi 9

Di ruang kerja Grafana, UI dasbor menyediakan alat untuk membangun dasbor untuk visualisasi. Jelajahi semua opsi dasbor dan panel sehingga Anda dapat fokus pada kueri. Ulangi sampai Anda memiliki kueri yang berfungsi, lalu rencanakan dan buat dasbor.

Untuk pemantauan infrastruktur dan respons insiden, Anda tidak perlu lagi beralih ke alat lain untuk men-debug apa yang salah. Anda dapat menggunakan Jelajahi untuk menggali lebih dalam metrik dan log Anda untuk menemukan penyebabnya.

Jelajahi membuatnya lebih mudah untuk melihat data Anda tanpa membuat dasbor. Jika sumber data Anda mendukung data grafik dan tabel, Jelajahi menampilkan hasilnya baik sebagai grafik maupun sebagai tabel. Ini membantu Anda melihat tren dalam data dan detail lebih lanjut pada saat yang bersamaan.

Mulai menjelajah

catatan

Secara default, pengguna dengan peran Penampil tidak dapat mengedit dan tidak memiliki akses ke Jelajahi.

Ikon Jelajahi di menu sebelah kiri membuka tab Jelajahi kosong.

Untuk memulai dengan kueri yang ada di panel, pilih opsi Jelajahi dari menu Panel. Ini membuka tab Jelajahi yang berisi kueri dari panel. Anda kemudian dapat mengubah atau mengulangi kueri di luar dasbor Anda.

Pilih sumber data Anda dari daftar dropdown di kiri atas. Prometheus memiliki implementasi Explore khusus. Sumber data lainnya menggunakan editor kueri standar mereka.

Di bidang kueri, Anda dapat menulis kueri dan menjelajahi data Anda. Ada tiga tombol di samping bidang kueri, tombol bening (X), tombol tambahkan kueri (+) dan tombol hapus kueri (-). Seperti pada editor kueri panel, Anda dapat menambah dan menghapus beberapa kueri.

Memisahkan dan membandingkan

Fitur split view adalah cara untuk membandingkan grafik dan tabel side-by-side atau untuk melihat data terkait bersama-sama pada satu halaman. Pilih Split untuk menduplikasi kueri saat ini dan membagi halaman menjadi dua side-by-side kueri. Anda memiliki opsi untuk memilih sumber data yang berbeda untuk kueri baru. Ini memberi Anda kesempatan untuk membandingkan kueri yang sama untuk dua server yang berbeda atau untuk membandingkan lingkungan pementasan dengan lingkungan produksi.

Dalam tampilan terpisah, pemilih waktu untuk kedua panel dapat ditautkan (jika Anda mengubah satu, yang lain juga akan diubah) dengan memilih salah satu tombol sinkronisasi waktu yang dilampirkan ke pemilih waktu. Menautkan pemilih waktu membantu menjaga waktu mulai dan akhir kueri tampilan terpisah tetap sinkron, sehingga Anda melihat interval waktu yang sama di kedua panel terpisah.

Anda dapat menutup kueri yang baru dibuat dengan memilih Close Split.

Berbagi tautan yang dipersingkat

Gunakan kemampuan Share shortened link untuk membuat URL format /goto/:uid yang lebih kecil dan lebih sederhana daripada berbagi URL yang lebih panjang yang berisi parameter kueri kompleks. Anda dapat membuat tautan singkat dengan memilih opsi Bagikan di bilah alat Jelajahi. Setiap tautan singkat yang tidak pernah digunakan akan dihapus secara otomatis setelah 7 hari.

Riwayat kueri

Riwayat kueri adalah daftar kueri yang telah Anda gunakan di Jelajahi. Riwayat bersifat lokal untuk browser Anda dan tidak dibagikan. Untuk membuka dan berinteraksi dengan riwayat Anda, pilih Riwayat kueri di Jelajahi.

Melihat riwayat kueri

Dalam riwayat kueri, Anda dapat melakukan hal berikut:

• Jalankan kueri.

• Buat atau edit komentar.

• Salin kueri ke clipboard.

• Salin tautan singkat dengan kueri ke clipboard.

• Bintangi kueri.

Mengelola kueri favorit

Semua kueri yang telah dibintangi di tab Riwayat kueri ditampilkan di tab Berbintang. Anda dapat mengakses kueri favorit Anda lebih cepat dan menggunakan kembali kueri tersebut tanpa mengetik ulang dari kueri tersebut.

Urutkan riwayat kueri

Secara default, riwayat kueri menunjukkan kueri terbaru kepada Anda. Anda dapat mengurutkan riwayat Anda berdasarkan tanggal atau dengan nama sumber data dalam urutan naik atau turun.

Di sisi kanan riwayat kueri, dalam daftar dropdown, pilih salah satu opsi berikut: bidang.

• Terbaru pertama

• Tertua pertama

• Sumber data A-Z

• Sumber data Z-A

catatan

Jika Anda berada dalam tampilan terpisah, mode penyortiran hanya berlaku untuk panel aktif.

Filter riwayat kueri

Pada tab Query history dan Starred, Anda dapat memfilter riwayat kueri berdasarkan nama sumber data.

1. Pilih Filter kueri untuk sumber data tertentu.

2. Pilih sumber data yang ingin Anda gunakan untuk memfilter riwayat Anda. Anda dapat memilih beberapa sumber data.

Pada tab Query history, Anda dapat menggunakan slider vertikal untuk memfilter kueri berdasarkan tanggal:

• Seret pegangan bawah untuk menyesuaikan tanggal mulai.

• Seret pegangan atas untuk menyesuaikan tanggal akhir.

catatan

Jika Anda berada dalam tampilan terpisah, filter hanya diterapkan ke panel aktif.

Mencari di riwayat kueri

Anda dapat mencari di riwayat Anda di seluruh kueri dan komentar Anda. Pencarian dimungkinkan untuk kueri di tab Query history dan Starred.

1. Pilih bidang Permintaan pencarian.

2. Di bidang pencarian, masukkan istilah pencarian Anda.

Pengaturan riwayat kueri

Anda dapat menyesuaikan riwayat kueri di tab Pengaturan. Tabel berikut mencantumkan opsi yang tersedia.

Pengaturan	Nilai default
Tentukan berapa lama Grafana akan menyimpan riwayat kueri Anda.	1 minggu
Ubah tab aktif default.	Tab riwayat kueri
Tampilkan kueri hanya untuk sumber data yang saat ini aktif di Jelajahi.	True
Hapus riwayat kueri.	(Pilih Hapus riwayat kueri untuk menghapus semua kueri yang disimpan secara permanen.)

catatan

Pengaturan riwayat kueri bersifat global, dan diterapkan ke kedua panel dalam mode terpisah.

Fitur khusus Prometheus

Versi pertama Jelajahi menampilkan pengalaman kueri khusus untuk Prometheus. Saat Anda menjalankan kueri, Grafana sebenarnya menjalankan dua kueri: kueri Prometheus normal untuk grafik dan Kueri Instan untuk tabel. Kueri Instan mengembalikan nilai terakhir untuk setiap deret waktu, yang menunjukkan ringkasan data yang baik yang ditunjukkan dalam grafik.

Penjelajah metrik

Di sisi kiri bidang kueri, pilih Metrik untuk membuka Metric Explorer. Ini menunjukkan menu hierarkis dengan metrik yang dikelompokkan berdasarkan awalan mereka. Misalnya, semua metrik Alertmanager dikelompokkan di bawah awalan. alertmanager Ini adalah titik awal yang baik untuk menjelajahi metrik mana yang tersedia.

Bidang kueri

Bidang Kueri mendukung penyelesaian otomatis untuk nama metrik, fungsi, dan sebagian besar bekerja dengan cara yang sama seperti editor kueri Prometheus standar. Tekan Enter untuk menjalankan kueri.

Menu Autocomplete dapat diakses dengan menekan Ctrl+Space. Menu Pelengkapan Otomatis berisi bagian Riwayat baru dengan daftar kueri yang baru saja dijalankan.

Saran dapat muncul di bawah bidang Kueri. Pilih saran untuk memperbarui kueri Anda dengan perubahan yang disarankan.

• Untuk penghitung (metrik yang meningkat secara monoton), fungsi laju disarankan.

• Untuk ember, fungsi histogram disarankan.

• Untuk merekam aturan, mungkin untuk memperluas aturan.

Filter tabel

Pilih tombol Filter di kolom label panel tabel untuk menambahkan filter ke ekspresi kueri. Anda dapat menambahkan filter untuk beberapa kueri juga. Filter ditambahkan untuk semua kueri.

Integrasi log

Anda juga dapat menggunakan Jelajahi untuk menyelidiki log Anda dengan sumber data berikut:

• InfluxDB

• Elasticsearch

Visualisasi log

Hasil kueri log ditampilkan sebagai histogram dalam grafik, dan log individu ditampilkan di bawah ini. Jika sumber data tidak mengirim data histogram untuk rentang waktu yang diminta, model log menghitung deret waktu berdasarkan jumlah baris log yang diselimuti oleh interval waktu yang dihitung secara otomatis. Awal histogram kemudian ditambatkan oleh stempel waktu baris log pertama dari hasilnya. Akhir dari deret waktu berlabuh ke rentang To picker waktu.

Tingkat log

Untuk log di mana label level ditentukan, Grafana menggunakan nilai label untuk menentukan level log dan memperbarui warna yang sesuai. Jika log tidak memiliki label level yang ditentukan, Grafana mem-parsing log untuk mengetahui apakah kontennya cocok dengan ekspresi yang didukung. Level log selalu ditentukan oleh pertandingan pertama. Jika Grafana tidak dapat menentukan level log, itu akan divisualisasikan dengan level log yang tidak diketahui. Tabel berikut mencantumkan tingkat log dan pemetaan singkatan dan ekspresi tingkat log.

Ekspresi yang didukung	Tingkat log	Warna
muncul	kritis	ungu
mematikan	kritis	ungu
pemberitahuan	kritis	ungu
kritikan	kritis	ungu
kritis	kritis	ungu
keliru	kesalahan	merah
eror	kesalahan	merah
kesalahan	kesalahan	merah
menegur	memperingati	kuning
memperingati	memperingati	kuning
info	info	hijau
informasi	info	hijau
melihat	info	hijau
dbug	debug	biru
debug	debug	biru
jejak	jejak	biru muda
*	tidak diketahui	abu-abu

Opsi visualisasi

Anda dapat menyesuaikan bagaimana log ditampilkan dan memilih kolom mana yang ditampilkan.

Waktu

Opsi ini menunjukkan atau menyembunyikan kolom waktu. Ini adalah stempel waktu yang dikaitkan dengan baris log seperti yang dilaporkan dari sumber data.

Label unik

Opsi ini menampilkan atau menyembunyikan kolom label unik, yang hanya mencakup label yang tidak umum. Semua label umum ditampilkan di atas.

Bungkus garis

Untuk menggunakan pembungkus baris di layar, atur ini ke True. Menyetel opsi ini ke Hasil False dalam pengguliran horizontal.

Deduping

Data log bisa sangat berulang. Jelajahi dapat membantu dengan menyembunyikan baris log duplikat. Anda dapat memilih dari algoritma deduplikasi yang berbeda:

• Tepat - Pencocokan yang tepat dilakukan di seluruh baris kecuali untuk bidang tanggal.

• Angka — Pertandingan dilakukan di telepon setelah menghapus nomor seperti durasi, alamat IP, dan sebagainya.

• Tanda tangan — Deduping yang paling agresif, ini menghapus semua huruf dan angka. Pertandingan dilakukan pada spasi dan tanda baca yang tersisa.

Balik urutan hasil

Anda dapat mengubah urutan log yang diterima dari urutan menurun default (terbaru pertama) menjadi urutan naik (tertua pertama).

Label dan bidang yang terdeteksi

Setiap baris log memiliki area yang dapat diperpanjang dengan label dan bidang yang terdeteksi, untuk interaksi yang lebih kuat. Untuk semua label, Anda dapat memfilter (filter positif) dan menyaring (filter negatif) label yang dipilih. Setiap bidang atau label juga memiliki ikon statistik untuk menampilkan statistik satu kali dalam kaitannya dengan semua log yang ditampilkan.

Alihkan bidang yang terdeteksi

Jika log Anda terstruktur di JSON atau logfmt, Anda dapat menampilkan atau menyembunyikan bidang yang terdeteksi. Perluas garis log, lalu pilih ikon mata untuk menampilkan atau menyembunyikan bidang.

{{< docs-imagebox img=” /img/docs/explore/parsed-fields-7-2.gif "max-width="800px” caption="Mengalihkan bidang yang terdeteksi di Jelajahi” >}}

Integrasi penelusuran

Anda dapat memvisualisasikan jejak dari melacak sumber data di Jelajahi. Sumber data yang saat ini didukung:

• Connect ke sumber data Jaeger

• Connect ke sumber data Tempo

• Connect ke sumber AWS X-Ray data

• Connect ke sumber data Zipkin

Untuk informasi tentang penggunaan editor kueri, lihat dokumentasi untuk sumber data tertentu.

Header

Header mencakup item-item berikut:

• Judul header, yang menunjukkan nama rentang root dan ID jejak

• Penelusuran, yang menyoroti rentang yang berisi teks yang dicari

• Metadata tentang jejak

Minimap

Minimap menunjukkan tampilan kental atau garis waktu jejak. Seret mouse Anda ke minimap untuk memperbesar ke rentang waktu yang lebih kecil. Zooming juga akan memperbarui timeline utama, sehingga mudah untuk melihat rentang yang lebih pendek. Jika Anda berhenti di minimap, saat diperbesar, Anda dapat melihat tombol Reset Selection, yang mengatur ulang zoom.

Garis Waktu

Garis waktu menunjukkan daftar bentang dalam jejak. Setiap baris rentang terdiri dari komponen-komponen berikut:

• Perluas tombol anak: Memperluas atau menciutkan semua rentang anak dari rentang yang dipilih

• Nama layanan: Nama layanan yang mencatat rentang

• Nama operasi: Nama operasi yang diwakili oleh rentang ini

• Bilah durasi rentang: Representasi visual dari durasi operasi dalam jejak

Memilih di mana saja pada baris rentang menunjukkan detail rentang.

Rincian rentang

Rincian rentang mencakup item-item berikut:

• Nama operasi

• Metadata rentang

• Tag (tag apa pun yang terkait dengan rentang ini)

• Metadata proses (metadata tentang proses yang mencatat rentang ini)

• Log: Daftar log yang dicatat oleh rentang ini dan nilai kunci terkait. Dalam kasus Zipkin log bagian menunjukkan anotasi Zipkin.

Menavigasi antara Jelajahi dan dasbor

Untuk membantu mempercepat alur kerja yang melibatkan peralihan secara teratur dari Explore ke dasbor dan sebaliknya, kami telah menambahkan kemampuan untuk kembali ke dasbor asal setelah menavigasi ke Explore dari menu tarik-turun panel.

Setelah Anda menavigasi ke Explore, Anda akan melihat tombol “Kembali” di toolbar Jelajahi.

Cukup memilih tombol akan mengembalikan Anda ke dasbor asal, atau, jika Anda ingin membawa perubahan yang Anda buat di Jelajahi kembali ke dasbor, cukup pilih panah di sebelah tombol untuk menampilkan item menu “Kembali ke panel dengan perubahan”.

Inspektur kueri

Untuk membantu men-debug kueri, Explore memungkinkan Anda untuk menyelidiki permintaan dan tanggapan kueri, serta statistik kueri, melalui inspektur Query. Fungsionalitas ini mirip dengan tab inspektur panel Stats dan tab Query. Lihat informasi yang lebih lengkap di Periksa kinerja kueri dan Lihat permintaan mentah dan respons terhadap sumber data.