İzler
Bir iz, dokunduğu her servis boyunca takip edilen tek bir istektir. Her adım bir span’dir: bir HTTP çağrısı, bir veritabanı sorgusu, başka bir servise yapılan çağrı. İzler, yavaş bir isteğin zamanını nerede harcadığını ve başarısız bir isteğin nerede bozulduğunu gösterir.
Durum sayfanızda Observability → İzler bölümünü açın. Her satır bir istektir.

İzler, uygulamanız göndermeye başladığında gelir: kurulum istemini kopyalarken İzler seçeneğini işaretleyin veya otomatik enstrümantasyon kullanın.
Grafiği okuyun
Her nokta bir istektir; ne zaman olduğuna ve ne kadar sürdüğüne göre yerleştirilir. Kırmızı noktalar başarısız olmuştur. Grafiğin üstünde:
- İzler: aramanın bulduğu istek sayısı.
- Hatalar: kaç tanesinin başarısız olduğu ve oranı.
- p50, p95, p99: isteklerin yarısı, %95’i ve %99’u bu değerden hızlıydı.
Bir zaman aralığına yakınlaşmak için grafikte sürükleyin.
Yavaş ve başarısız istekleri bulun
Arama kutusunu Loglar sayfasındaki gibi kullanın. Bu filtreler izler için yapılmıştır:
| Filtre | Bulur |
|---|---|
status:error | Başarısız olan istekler |
duration:>1s | Bir saniyeden yavaş istekler. Ayrıca >500ms, <100ms |
service:api | Tek bir servisin işlediği istekler |
span.name: | Belirli bir ada sahip span’ler, örneğin GET /v1/users |
| Herhangi bir öznitelik | Örneğin http.route: veya http.response.status_code: |
Serbest metin span adlarında arar. Kök span'ler varsayılan olarak açıktır, böylece her istek bir kez görünür. Her span’i ayrı listelemek için kapatın.
İndirme düğmesi listeyi CSV olarak dışa aktarır.
Bir izi açın
Bir satıra tıklayın. İz, her span bir zaman çizelgesinde ve onu çağıran span’in altına girintili olarak açılır. Uzun çubuklar zamanın nereye gittiğini gösterir.

Bu örnekte bir sayfa yüklemesi 842 ms sürüyor. Şelale nedenini gösteriyor: web, api servisini çağırıyor, api, sso servisini çağırıyor ve sso, Okta’yı 468 ms bekliyor.
- Rota, durum kodu veya veritabanı sorgusu gibi özniteliklerini görmek için bir span’e tıklayın.
- Bu span'den N log, o span sırasında yazılan logları açar.
- Üstteki N log, isteğin tüm servislerdeki her logunu açar.
- İz ID'sini kopyala kimliği kopyalar; paylaşmak veya
trace_id:ile aramak için. - Önceki veya sonraki ize geçmek için ↑ ↓ veya J K, kapatmak için Esc kullanın.
Başarısız bir isteği düzeltin
Başarısız span’ler kırmızıdır. Yalnızca hatalar çalışan span’leri gizler, böylece hata uzun bir izde öne çıkar.

Düzeltme istemini kopyala başarısız isteğin bir açıklamasını kopyalar: span’ler, hataları ve öznitelikleri. Bunu uygulamanızın projesinde kodlama ajanınıza yapıştırın; nedeni bulmak için ihtiyacı olan her şeye sahip olur.