Trace

Trace adalah satu permintaan yang diikuti melalui setiap layanan yang dilewatinya. Setiap langkah adalah span: panggilan HTTP, kueri database, panggilan ke layanan lain. Trace menunjukkan ke mana permintaan lambat menghabiskan waktunya dan di mana permintaan yang gagal rusak.

Buka Observability → Trace di halaman status Anda. Setiap baris adalah satu permintaan.

Penjelajah trace dengan durasi permintaan dari waktu ke waktu dan satu baris per permintaan

Trace tiba setelah aplikasi Anda mengirimnya: centang Trace saat menyalin prompt penyiapan, atau gunakan instrumentasi otomatis.

Baca grafik

Setiap titik adalah satu permintaan, ditempatkan menurut waktu dan durasinya. Titik merah berarti gagal. Di atas grafik:

  • Trace: berapa banyak permintaan yang ditemukan pencarian.
  • Error: berapa yang gagal, dan porsinya.
  • p50, p95, p99: setengah, 95%, dan 99% permintaan lebih cepat dari nilai ini.

Seret di grafik untuk memperbesar jendela waktu.

Temukan permintaan lambat dan gagal

Gunakan kotak pencarian seperti di halaman Log. Filter berikut dibuat untuk trace:

FilterMenemukan
status:errorPermintaan yang gagal
duration:>1sPermintaan yang lebih lambat dari satu detik. Juga >500ms, <100ms
service:apiPermintaan yang ditangani satu layanan
span.name:Span dengan nama tertentu, seperti GET /v1/users
Atribut apa punSeperti http.route: atau http.response.status_code:

Teks bebas mencari di nama span. Span root aktif secara default, jadi setiap permintaan muncul sekali. Matikan untuk menampilkan setiap span secara terpisah.

Tombol unduh mengekspor daftar sebagai CSV.

Buka trace

Klik sebuah baris. Trace terbuka dengan setiap span di linimasa, bersarang di bawah span yang memanggilnya. Batang panjang menunjukkan ke mana waktu habis.

Trace yang melintasi tiga layanan, dengan panggilan lambat ke Okta di bagian bawah waterfall

Dalam contoh ini, memuat halaman butuh 842 ms. Waterfall menunjukkan alasannya: web memanggil api, api memanggil sso, dan sso menunggu Okta selama 468 ms.

  • Klik span untuk melihat atributnya, seperti rute, kode status, atau kueri database.
  • N log dari span ini membuka log yang ditulis selama span itu.
  • N log di bagian atas membuka setiap log permintaan, di semua layanan.
  • Salin ID trace menyalin ID, untuk dibagikan atau dicari dengan trace_id:.
  • Gunakan ↑ ↓ atau J K untuk pindah ke trace sebelumnya atau berikutnya, dan Esc untuk menutup.

Perbaiki permintaan yang gagal

Span yang gagal berwarna merah. Hanya error menyembunyikan span yang berhasil, agar kegagalan menonjol di trace yang panjang.

Permintaan yang gagal, dengan span error berwarna merah dan tombol untuk menyalin prompt perbaikan

Salin prompt untuk memperbaiki menyalin deskripsi permintaan yang gagal: span, error, dan atributnya. Tempelkan ke agen coding Anda di proyek aplikasi, dan agen akan punya semua yang dibutuhkan untuk menemukan penyebabnya.