Menelusuri di Explore

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

Anda dapat menggunakan Jelajahi untuk memvisualisasikan jejak dari melacak sumber data.

Sumber data berikut didukung.

• Tempo (format konsumsi yang didukung:, Jaeger OpenTelemetry, dan Zipkin)

• Jaeger

• AWS X-Ray

• Zipkin

Untuk informasi tentang cara mengonfigurasi kueri untuk sumber data yang tercantum di atas, lihat dokumentasi untuk sumber data tertentu.

Editor kueri

Anda dapat menanyakan dan mencari data penelusuran menggunakan editor kueri sumber data.

Setiap sumber data dapat memiliki editor kueri sendiri. Editor kueri untuk sumber data Tempo sedikit berbeda dari editor kueri untuk sumber data Jaeger.

Untuk informasi tentang kueri setiap sumber data, lihat dokumentasinya.

• Tempo

• Jaeger

• AWS X-Ray

• Zipkin

Penjelasan Trace View

Bagian ini menjelaskan elemen dasbor Trace View.

Header

Header dari tampilan jejak memiliki elemen-elemen berikut:

• Judul header - Menunjukkan nama rentang root dan ID jejak.

• Penelusuran — Sorotan mencakup teks yang dicari.

• Metadata — Berbagai metadata tentang jejak.

Minimap

Menampilkan tampilan kental atau garis waktu jejak. Seret penunjuk Anda ke peta minimum untuk memperbesar rentang waktu yang lebih kecil. Zooming juga akan memperbarui timeline utama, sehingga mudah untuk melihat rentang yang lebih pendek. Melayang di atas minimap, saat diperbesar, akan menampilkan tombol Reset Selection yang mengatur ulang zoom.

Filter rentang

Menggunakan filter rentang, Anda dapat memfilter rentang Anda di penampil garis waktu jejak. Semakin banyak filter yang Anda tambahkan, semakin spesifik rentang yang difilter.

Anda dapat menambahkan satu atau beberapa filter berikut:

• Nama layanan sumber daya

• Nama rentang

• Durasi

• Tag (yang mencakup tag, tag proses, dan bidang log)

Untuk hanya menampilkan rentang yang telah Anda cocokkan, pilih sakelar Tampilkan kecocokan saja.

Garis Waktu

Menampilkan daftar bentang dalam jejak. Setiap baris rentang terdiri dari komponen-komponen ini:

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

Rincian rentang

Memilih baris rentang menunjukkan detail rentang, termasuk yang berikut ini.

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

Lacak ke log

Anda dapat menavigasi dari rentang dalam tampilan jejak langsung ke log yang relevan untuk rentang tersebut. Ini tersedia untuk sumber data Tempo, Jaeger, dan Zipkin. Lihat dokumentasi yang relevan untuk petunjuk tentang cara mengkonfigurasi setiap sumber data.

Pilih ikon dokumen untuk membuka tampilan terpisah di Jelajahi dengan sumber data yang dikonfigurasi dan kueri log yang relevan untuk rentang tersebut.

Lacak ke metrik

catatan

Fitur ini saat ini dalam versi beta

Anda dapat menavigasi formulir rentang dalam tampilan jejak langsung ke metrik yang relevan untuk rentang tersebut. Fitur ini tersedia untuk sumber data Tempo, Jaeger, dan Zipkin. Lihat dokumentasi yang relevan untuk detail tentang konfigurasi.

Lacak ke profil

Menggunakan Jejak ke profil, Anda dapat menggunakan kemampuan Grafana untuk mengkorelasikan sinyal yang berbeda dengan menambahkan fungsionalitas untuk menghubungkan antara jejak dan profil.

Grafik simpul

Anda secara opsional dapat memperluas grafik simpul untuk jejak yang ditampilkan. Bergantung pada sumber data, ini dapat menunjukkan rentang jejak sebagai node dalam grafik, atau menambahkan beberapa konteks tambahan, termasuk grafik layanan berdasarkan jejak saat ini.

Tampilan Grafik Layanan

Tampilan Grafik Layanan memvisualisasikan metrik rentang (melacak data untuk tarif, tingkat kesalahan, dan durasi (RED)) dan grafik layanan. Setelah persyaratan disiapkan, tampilan pra-konfigurasi ini segera tersedia.

Untuk informasi selengkapnya, lihat halaman sumber data Tempo. Anda juga dapat melihat halaman tampilan grafik layanan di dokumentasi Grafana Labs Tempo.

Data API

Visualisasi ini membutuhkan bentuk data tertentu yang akan dikembalikan dari sumber data agar dapat menampilkannya dengan benar.

Sumber data perlu mengembalikan data frame dan setframe.meta.preferredVisualisationType = 'trace'.

Struktur bingkai data

Bidang yang diperlukan;

Nama bidang	Jenis	Deskripsi
TraceID	string	Pengidentifikasi untuk seluruh jejak. Seharusnya hanya ada satu jejak dalam bingkai data.
SpanID	string	Pengidentifikasi untuk rentang saat ini. Orang Spanyol harus unik per jejak.
Orang tuaSpanid	string	spanId dari rentang induk untuk membuat hubungan induk anak dalam tampilan jejak. Bisa undefined untuk rentang root tanpa induk.
serviceName	string	Nama layanan rentang ini adalah bagian dari.
ServiceTags	TraceKeyValuePair[]	Daftar tag yang relevan untuk layanan ini.
startTime	number	Waktu mulai rentang dalam waktu epoch milidetik.
durasi	number	Durasi rentang dalam milidetik.

Bidang opsional:

Nama bidang	Jenis	Deskripsi
log	TraceLog[]	Daftar log yang terkait dengan rentang saat ini.
tag	TraceKeyValuePair[]	Daftar tag yang terkait dengan rentang saat ini.
peringatan	tali []	Daftar peringatan yang terkait dengan rentang saat ini.
StackTraces	tali []	Daftar jejak tumpukan yang terkait dengan rentang saat ini.
errorIconColor	string	Warna ikon kesalahan dalam rentang kasus ditandai denganerror: true.

Untuk detail tentang jenis lihat TraceSpanRow, TraceKeyValuePairdan TraceLogseterusnya GitHub.