İstek kimliği (korelasyon kimliği)

İstek kimliği uçta — yük dengeleyici, ağ geçidi ya da ilk servis tarafından — üretilir ve X-Request-Id gibi bir yanıt başlığıyla döndürülür. O isteği işlerken yazılan her log satırı onu taşır; istek başka servislere dağıldığında kimlik de onunla gider, böylece tüm yol sonradan yeniden birleştirilebilir.

Nasıl çalışır

İstemciler bildirdikleri her hatayla birlikte kimliği loglamalı ve hata raporlarına eklemelidir; destek ekibi o zaman tam sunucu loglarını saniyeler içinde bulur. W3C Trace Context (traceparent başlığı) gibi dağıtık izleme standartları aynı fikri, zamanlama için üst ve alt span’ler ekleyerek resmileştirir.

Yaygın yanılgı

Bir zaman damgası ile bir uç noktanın loglarda bir isteği bulmaya yettiği sanılır. Yoğun bir sistemde saniyede binlerce aynı çağrı olur. Kimlik olmadan “10:42 civarında başarısız oldu” bir kayda bakmak değil, saatlerce arama yapmak demektir.

Burada deneyin

Canlı arka uç her yanıta bir X-Request-Id başlığı koyar ve aynı requestId’yi JSON gövdelere de ekler — açığa çıkardığı tek ayrıntının bu olduğu 500 hataları dahil.

İlgili

• HTTP 500 Internal Server Error
• HTTP başlıkları nedir

Kaynaklar

• Traces and context — OpenTelemetry

Diğer terimler

• HTTP — Her istek ve yanıtla birlikte, gövdeden ayrı olarak gönderilen ad–değer üst verisi.
• Webhook — Siz sorup durmayasınız diye, bir şey olduğunda sunucunun size gönderdiği HTTP geri çağrısı.
• HMAC imzası — Bir yükün, paylaşılan gizli anahtarı bilen birinden geldiğini ve değiştirilmediğini kanıtlayan anahtarlı özet.
• Sunucu Tarafından Gönderilen Olaylar (SSE) — Açık kalan sıradan bir HTTP yanıtı üzerinden sunucudan istemciye tek yönlü olay akışı.

Bu sayfayı İngilizce okuyun

Tüm sözlük maddeleri · Test teknikleri · 39 mock REST API’nin tamamı

Son güncelleme 16 Ekim 2026