Pelacakan - Amazon Managed Grafana
Menambahkan panel dengan visualisasi penelusuranMenambahkan traceQL dengan visualisasi tabel

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Pelacakan

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

Visualisasi jejak memungkinkan Anda mengikuti permintaan saat melintasi layanan di infrastruktur Anda. Visualisasi jejak menampilkan data jejak dalam diagram yang memungkinkan Anda menafsirkannya dengan mudah.

Untuk informasi lebih lanjut tentang jejak dan cara menggunakannya, lihat dokumentasi berikut:

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 lebih lanjut tentang variabel dasbor, lihat dokumentasi Variabel.

Prasyarat

Sebelum memulai, Anda memerlukan:

  • Ruang kerja Grafana yang Dikelola Amazon.

  • Sumber data Tempo 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.

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.

  2. Pilih Tambahkan visualisasi dari dasbor baru atau pilih Tambah Panel di dasbor yang ada.

  3. Pilih sumber data penelusuran yang sesuai.

  4. Di kanan atas editor panel, pilih tab Visualisasi, dan pilih Jejak.

  5. Di bawah opsi Panel, masukkan Judul untuk panel jejak Anda. Untuk informasi selengkapnya tentang editor panel, lihatKonfigurasikan opsi panel.

  6. Di editor kueri, pilih tab jenis kueri TraceQL.

  7. Masukkan ${traceId} di bidang query TraceQL untuk membuat variabel dasbor. Variabel ini digunakan sebagai query template.

  8. Pilih Terapkan di editor panel untuk menambahkan panel ke dasbor.

  9. Buka Pengaturan dasbor dan tambahkan variabel baru yang disebuttraceId, dari tipe variabel Kustom, berikan label, jika diperlukan. Pilih Terapkan untuk menambahkan variabel ke dasbor.

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

  2. Pilih sumber data jejak yang sama yang Anda gunakan di bagian sebelumnya.

  3. Di kanan atas editor panel, pilih tab Visualisasi, lalu pilih Tabel.

  4. Di editor kueri, pilih tab TraceQL.

  5. Di bawah opsi Panel, masukkan Judul untuk panel jejak Anda.

  6. Tambahkan kueri TraceQL yang sesuai untuk mencari jejak yang ingin Anda visualisasikan di dasbor. Misalnya, berikut adalah query 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.

  2. Tambahkan Judul untuk tautan data.

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

  4. 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. Sebagai contoh:

    /d/1234abcd5/my-dashboard?orgId=1&var-traceId=${__data.fields["traceID"]}

  5. Pilih Simpan untuk menyimpan tautan data.

  6. Pilih Terapkan dari editor panel untuk menerapkan panel ke dasbor.

  7. 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 timesepertiName,, Duration atau) secara otomatis mengikuti tautan data, mengisi variabel dasbor, dan kemudian menunjukkan jejak yang relevan di traceId panel jejak.