Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Jejak
****
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 12.x.**
Untuk ruang kerja Grafana yang mendukung Grafana versi 10.x, lihat. [Bekerja di Grafana versi 10](using-grafana-v10.md)
Untuk ruang kerja Grafana yang mendukung Grafana versi 9.x, lihat. [Bekerja di Grafana versi 9](using-grafana-v9.md)
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)
Visualisasi jejak memungkinkan Anda mengikuti permintaan saat melintasi layanan di infrastruktur Anda. Visualisasi jejak menampilkan jejak data dalam diagram yang memungkinkan Anda menafsirkannya dengan mudah.
Untuk informasi lebih lanjut tentang jejak dan cara menggunakannya, lihat dokumentasi berikut:
+ [Menelusuri di Explore](v12-explore-tracing.md)
+ [Sumber data tempo](tempo-data-source.md)
+ [Memulai dengan Tempo di Dokumentasi](https://grafana.com/docs/tempo/latest/getting-started/) Tempo *Grafana Labs*.
## Menambahkan panel dengan visualisasi penelusuran
Setelah Anda memiliki data penelusuran yang tersedia di tumpukan Grafana Anda, Anda dapat menambahkan panel pelacakan ke dasbor Grafana Anda.
Menggunakan variabel dasbor,`traceID`, memungkinkan Anda membuat kueri untuk menampilkan jejak tertentu untuk ID jejak yang diberikan. Untuk informasi selengkapnya tentang variabel dasbor, lihat [dokumentasi Variabel](v12-dash-variables.md).
**Prasyarat**
Sebelum memulai, Anda memerlukan:
+ Ruang kerja Grafana yang Dikelola Amazon.
+ [Sumber data Tempo](tempo-data-source.md) yang terhubung ke ruang kerja Anda.
Untuk melihat dan menganalisis data jejak di dasbor, Anda perlu menambahkan visualisasi jejak ke dasbor Anda dan menentukan kueri menggunakan editor panel. Kueri menentukan data yang ditampilkan dalam visualisasi. Untuk informasi lebih lanjut tentang editor panel, lihat [dokumentasi Editor Panel](v12-panels-editor-overview.md).
Prosedur ini menggunakan variabel dasbor dan template untuk memungkinkan Anda memasukkan ID jejak yang kemudian dapat divisualisasikan. Anda akan menggunakan variabel yang disebut `traceId` dan menambahkannya sebagai kueri template.
**Untuk menambahkan kueri visualisasi jejak**
1. Di ruang kerja Anda, buat dasbor baru atau buka dasbor yang ada tempat Anda ingin menambahkan visualisasi jejak.
1. Pilih **Tambahkan visualisasi** dari dasbor baru atau pilih **Tambah Panel** di dasbor yang ada.
1. Pilih sumber data penelusuran yang sesuai.
1. **Di kanan atas editor panel, pilih tab **Visualisasi**, dan pilih Jejak.**
1. Di bawah **opsi Panel**, masukkan **Judul** untuk panel jejak Anda. Untuk informasi selengkapnya tentang editor panel, lihat[Konfigurasikan opsi panel](v12-panels-configure-panel-options.md).
1. Di editor kueri, pilih tab jenis kueri **TraceQL**.
1. Masukkan `${traceId}` di bidang query TraceQL untuk membuat variabel dasbor. Variabel ini digunakan sebagai query template.
1. Pilih **Terapkan** di editor panel untuk menambahkan panel ke dasbor.
1. Buka **Pengaturan** dasbor dan tambahkan variabel baru yang disebut`traceId`, dari tipe variabel **Kustom**, berikan label, jika diperlukan. Pilih **Terapkan** untuk menambahkan variabel ke dasbor.
1. Verifikasi bahwa panel berfungsi dengan menggunakan ID jejak yang valid untuk sumber data yang digunakan untuk panel jejak dan mengedit ID di variabel dasbor.
## Menambahkan traceQL dengan visualisasi tabel
Meskipun Anda dapat menambahkan visualisasi jejak ke dasbor, harus menambahkan ID jejak secara manual sebagai variabel dasbor tidak praktis. Lebih berguna untuk dapat menggunakan kueri TraceQL untuk mencari jenis jejak tertentu dan kemudian memilih jejak yang sesuai dari hasil yang cocok.
**Prasyarat**
Prosedur ini mengasumsikan Anda telah menyelesaikan prosedur sebelumnya.
**Untuk menambahkan traceQL dengan visualisasi tabel**
1. Di dasbor yang sama tempat Anda menambahkan visualisasi jejak, pilih **Tambahkan panel** untuk menambahkan panel visualisasi baru.
1. Pilih sumber data jejak yang sama yang Anda gunakan di bagian sebelumnya.
1. **Di kanan atas editor panel, pilih tab **Visualisasi**, lalu pilih Tabel.**
1. Di editor kueri, pilih tab **TraceQL**.
1. Di bawah **opsi Panel**, masukkan **Judul** untuk panel jejak Anda.
1. Tambahkan kueri TraceQL yang sesuai untuk mencari jejak yang ingin Anda visualisasikan di dasbor. Misalnya, berikut adalah kueri statis sederhana dari server yang disebut{{my-server}}.
```
{ .service.name = "{{my-server}}" && .http.status_code=500 }
```
Anda dapat menulis kueri TraceQL sebagai kueri template untuk memanfaatkan variabel dasbor lainnya, jika ada. Ini memungkinkan Anda membuat kueri dinamis berdasarkan variabel-variabel ini.
Ketika hasil dikembalikan dari kueri, hasilnya ditampilkan dalam tabel panel.
Hasil dalam visualisasi jejak mencakup tautan ke halaman **Jelajahi** yang membuat jejak. Anda dapat menambahkan tautan lain ke jejak di tabel yang mengisi variabel `traceId` dasbor saat dipilih, sehingga jejak divisualisasikan di dasbor yang sama.
Untuk membuat satu set link data di panel, gunakan prosedur berikut.
**Untuk menggunakan variabel untuk menambahkan tautan lain ke jejak**
1. Di menu sisi kanan, di bawah **Tautan data**, pilih **Tambahkan tautan**.
1. Tambahkan **Judul** untuk tautan data.
1. Temukan jalur ke dasbor dengan melihat di bilah alamat browser Anda saat dasbor lengkap sedang dirender. Karena ini adalah tautan ke dasbor di tumpukan Grafana yang sama, hanya jalur dasbor yang diperlukan.
Misalnya, jika jalur Anda adalah:
```
https://g-example.grafana-workspace.us-east-1.amazonaws.com{{/d/1234abcd5/my-dashboard?orgId=1}}
```
Maka jalur ke dasbor adalah:
```
/d/1234abcd5/my-dashboard?orgId=1
```
1. Di bidang **URL**, buat referensi mandiri ke dasbor yang berisi kedua panel. Referensi diri ini menggunakan nilai jejak yang dipilih dalam tabel untuk mengisi variabel dasbor. Gunakan jalur untuk dasbor dari langkah sebelumnya dan kemudian isi nilai `traceId` menggunakan hasil yang dipilih dari tabel TraceQL. ID jejak diekspos menggunakan bidang `traceID` data dalam hasil yang dikembalikan, jadi gunakan itu sebagai nilai untuk variabel dasbor. Contoh:
```
/d/1234abcd5/my-dashboard?orgId=1&var-traceId=${__data.fields["traceID"]}
```
1. Pilih **Simpan** untuk menyimpan tautan data.
1. Pilih **Terapkan** dari editor panel untuk menerapkan panel ke dasbor.
1. Simpan dasbor.
Anda sekarang harus melihat daftar jejak yang cocok dalam visualisasi tabel. **Saat memilih bidang **traceID** **atau** SpanID akan memberi Anda opsi untuk membuka halaman Jelajahi untuk memvisualisasikan jejak atau mengikuti tautan data, memilih bidang lain (`Start time`seperti`Name`,, `Duration` atau) secara otomatis mengikuti tautan data, mengisi variabel dasbor, dan kemudian menunjukkan jejak yang relevan di `traceId` panel jejak.**