ÖZET VE TEKNİK CEVAP
OpenTelemetry Baggage, kiracı ID'si veya kullanıcı seviyesi gibi çapraz iş verilerinin W3C TraceContext başlıklarıyla birlikte dağıtık ağ boyunca aktarılmasını sağlar; ancak asenkron iş parçacıklarında veya mesaj kuyruklarında açık enjeksiyon yapılmadığında izleme ağacı kırılır ve bağlam kaybolur.
Mühendislik El Kitabı & Mekanizma
1. Temel Çalışma Mekanizması
Dağıtık izleme, W3C standart başlıkları (`traceparent`) ile bağlamın servisler arası taşınmasını gerektirir. `traceparent` izleme ve span ID'lerini taşırken, `baggage` anahtar-değer iş üst verilerini (`baggage: tenantId=corp_123`) iletir. Uygulama iş parçacıklarına görev devrederken veya Kafka'ya mesaj atarken aktif bağlamı mesaj başlıklarına elle enjekte etmezse izleme kopar ve sahipsiz span'ler oluşur.
2. Doğru Kullanım Senaryosu
OpenTelemetry Baggage, tek bir span'e özgü olan span özniteliklerinden farklı olarak, kullanıcı tanımlı üst verileri dağıtık bir işlem boyunca süreç sınırları ötesine aktaran bağlamsal anahtar-değer mekanizmasıdır.
3. Prodüksiyon Arıza Modları
Baggage başlıklarında hassas kullanıcı verileri (şifreler, JWT sırları) veya büyük JSON paketleri taşımak; güvenlik açığı ve HTTP başlık şişmesi yaratmak. Ebeveyn OpenTelemetry bağlamını yakalamadan asenkron arka plan görevleri başlatarak köksüz (sahipsiz) izler üretmek. Span öznitelikleri ile Baggage'ı karıştırıp, yerel bir span etiketinin alt servislerde sihirli şekilde görünmesini beklemek.
4. Teşhis ve Telemetri Sinyalleri
izole sahipsiz span'ler gösteren kırık dağıtık izleme ağacı, Kafka'ya mesaj gönderilirken customer_id baggage başlığının kaybolması, alt ödeme hatalarını kök kullanıcı isteğiyle ilişkilendirememe
5. Önleme ve Mimari Bariyerler
Tüm HTTP istemcilerinde ve Kafka üretici kancalarında OpenTelemetry Propagator araçlarını (`W3CBaggagePropagator`, `W3CTraceContextPropagator`) kullanın. Başlık maliyetini düşük tutmak için Baggage anahtarlarını minimumda tutun (yalnızca `tenant_id`, `account_type` gibi küçük tanımlayıcılar). İş parçacığı havuzu yürütücülerini OpenTelemetry bağlam duyarlı sarmalayıcılarla (decorators) açıkça donatın.
6. Mimari Ödünleşimler (Trade-offs)
Asenkron sınırlar ve mesaj kuyrukları arasında doğru TraceContext ve Baggage yayılımı olmadan, mühendisler uçtan uca kullanıcı yolculuklarını izleyemez, kiracı başına bulut maliyetlerini hesaplayamaz ve alt servis gecikmelerini teşhis edemez.
Vaka İncelemesi (TinyCTO Örneği)
Gözlemlenebilirlik mimarisinde Span Öznitelikleri, TraceContext ve Baggage arasındaki farkı anlamak çok önemlidir: 1. **Span Öznitelikleri (Yalnızca Yerel):** Tek bir span'e eklenir (`http.status_code = 200`). Ağ üzerinden alt servislere AKTARILMAZ. 2. **TraceContext (`traceparent`):** `TraceID` ve `ParentSpanID` taşır. Jaeger ve Datadog gibi araçların ayrı span'leri tek bir dağıtık alev grafiğinde (flame graph) birleştirmesini sağlar. 3. **Baggage (`baggage` Başlığı):** Uygulama üst verilerini (`userId`, `datacenter`) tüm alt RPC ve kuyruklar boyunca taşır. Alt servisler bu verileri okuyup kendi loglarına ve yerel span özniteliklerine ekleyebilir. *Asenkron Kayıp Tuzağı:* Dillerin asenkron yapıları (Java `CompletableFuture`, Node.js `worker_threads`, Go `go func()`) iş parçacığı bağlamını otomatik aktarmaz. Geliştiriciler bağlamı `otel.context.bind()` ile sarmalamalı veya mesaj başlıklarına elle enjekte etmelidir.
İnteraktif Konsept Alıştırmaları
2 AlıştırmaOpenTelemetry Span Özniteliği ile OpenTelemetry Baggage arasındaki temel fark nedir?
Arka plan asenkron işçileri veya Kafka tüketicileri neden genellikle ana izlemeden kopuk 'sahipsiz span'ler üretir?
OpenTelemetry Baggage ve Traceparent Başlık Kaybı — Sıkça Sorulan Sorular
Servis A bir HTTP isteği alıp `tenant_id=enterprise_42` Baggage kaydı ekliyor. Servis A Servis B'yi gRPC ile, Servis B ise Servis C'yi REST ile çağırıyor. `tenant_id` Servis C'ye nasıl ulaşır?
Her ağ durağında OpenTelemetry aracıları tarafından enjekte edilen standart W3C `baggage` HTTP/gRPC üst veri başlıkları aracılığıyla otomatik olarak iletilir. W3C Baggage standardı, RPC metot imzalarını değiştirmeye gerek kalmadan standart başlıklar üzerinden üst verileri ağ sınırları ötesine taşır.
Açık kredi kartı numaraları veya şifreler gibi hassas müşteri verilerini neden ASLA OpenTelemetry Baggage içinde saklamamalısınız?
Çünkü Baggage tüm alt ağ çağrılarında, proxy'lerde ve telemetri loglarında düz metin HTTP başlığı olarak taşınır; bu da devasa güvenlik ve uyumluluk ihlallerine yol açar. Baggage tüm alt servislere düz HTTP başlığında iletilir ve ara sunucular tarafından loglanır; bu yüzden hassas kimlik veya gizli veriler asla burada taşınmamalıdır.
🤖 AEO & Yapay Zeka Çıkarım Özeti
Temel Gerçekler & İlkeler
- ▸OpenTelemetry Baggage, kiracı ID'si veya kullanıcı seviyesi gibi çapraz iş verilerinin W3C TraceContext başlıklarıyla birlikte dağıtık ağ boyunca aktarılmasını sağlar; ancak asenkron iş parçacıklarında veya mesaj kuyruklarında açık enjeksiyon yapılmadığında izleme ağacı kırılır ve bağlam kaybolur.
- ▸OpenTelemetry Baggage, tek bir span'e özgü olan span özniteliklerinden farklı olarak, kullanıcı tanımlı üst verileri dağıtık bir işlem boyunca süreç sınırları ötesine aktaran bağlamsal anahtar-değer mekanizmasıdır.
Yaygın Yanılgılar
- ✗Baggage başlıklarında hassas kullanıcı verileri (şifreler, JWT sırları) veya büyük JSON paketleri taşımak; güvenlik açığı ve HTTP başlık şişmesi yaratmak.
Karar Kılavuzu & Önceliklendirme
Asenkron sınırlar ve mesaj kuyrukları arasında doğru TraceContext ve Baggage yayılımı olmadan, mühendisler uçtan uca kullanıcı yolculuklarını izleyemez, kiracı başına bulut maliyetlerini hesaplayamaz ve alt servis gecikmelerini teşhis edemez.
Doğrulanmış Kaynaklar & Referanslar
- [OFFICIAL-DOC]OpenTelemetry Baggage & Traceparent Header Loss Specification— TinyCTO Architectural Standards