Mikroservislerde dağıtık izlemeyi (OpenTelemetry) nasıl kurarım?

Kısa cevap: Custom bir şema icat etmeyin; W3C Trace Context (traceparent/tracestate) üzerinde standartlaşın ki PHP ve Go birbirini sorunsuz anlasın.

Kısa cevap

Sizin asıl derdiniz “800ms nerede” — ve bunu görebilmek için trace’in servisler ve kuyruklar arasında kopmadan taşınması gerekiyor. Go tarafındaki HTTP mekaniğini, yani context’in istekle birlikte nasıl taşındığını Go’da HTTP servisi yazmak yazısında anlatmıştım.

Neden

1. Standart başlık, iki dilin ortak paydasıdır. W3C Trace Context standart olduğu için Laravel ve Go aynı traceparent’ı ortak okur. Kendi trace_id başlığınızı uydurursanız her yeni servis için bir çeviri katmanı borçlanırsınız.

2. Zincir en çok kuyruk hop’unda kopar. Takımların unuttuğu parça budur: HTTP tarafını doğru kurup mesaj yayınlarken context’i taşımazsanız asenkron sıçramalar APM’de orphan trace olarak görünür. Aynı kuyruğun kendi dayanıklılık tarafını log hattına buffer koyma sorusunda ayrıca tartışmıştım.

3. Head-only sampling tam da aradığınız trace’i atar. 800ms’lik outlier’ı görmek istiyorsanız kararı isteğin başında vermek yanlış yerdir.

Ne yapmalı

1. W3C Trace Context’i standart yapın. Gateway’de kök span’i başlatın; her servis gelen HTTP header’ından context’i extract etsin, giden çağrılara inject etsin.

2. Kuyruklarda aynı traceparent’ı mesajla taşıyın. Mesajı publish ederken traceparent’ı bir mesaj header’ı/attribute olarak ekleyin, worker’da yeniden extract edin.

3. Her servise OTel SDK koyun, OTLP ile gönderin. Servis → OTLP → bir Collector → Jaeger/Tempo. Collector’ı araya almak, export’u uygulamadan ayırır ve backend değiştirmeyi kolaylaştırır.

4. Sampling’i akıllı seçin. parent-based ile bir trace’in tüm span’leri aynı kaderi paylaşsın; üstüne tail sampling ekleyin ki yavaş trace’ler kesin tutulsun.

5. trace_id’yi elle örmeyin. Kendi elinizle header okuma/yazma kodu yazmayın; SDK’nın context propagation’ı bunu zaten taşır. Elle yapınca bir yerde unutursunuz ve trace o noktada kopar.

Sonuç: Ben olsam W3C Trace Context + OTel SDK + Collector + Tempo/Jaeger kurar, propagation’ı SDK’ya bırakır, kuyruk hop’unda traceparent’ı mesaj header’ına koymayı asla atlamazdım. Mimari muhakemeyi neden böyle kurduğunuzu sade.dev’de anlatıyorum. 800ms’i ancak kopmamış bir trace gösterir.