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

Zaman içindeki istek süreleri ve istek başına bir satırla iz gezgini

İ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:

FiltreBulur
status:errorBaşarısız olan istekler
duration:>1sBir saniyeden yavaş istekler. Ayrıca >500ms, <100ms
service:apiTek 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.

Üç servisi geçen ve şelalenin altında Okta’ya yavaş bir çağrı bulunan bir iz

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.

Hatalı span’leri kırmızı olan ve düzeltme istemini kopyalama düğmesi bulunan başarısız bir istek

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.