Çağrı yolu (mesajlaşma, load balancer, dış çağrılar)
Bir isteğin servisler arasındaki bütün yolu: Kafka, RabbitMQ, IBM MQ, ActiveMQ, SQS, Service Bus ya da Pub/Sub üzerinden giden mesajlar, aradaki load balancer ve proxy'ler, izlenmeyen üçüncü taraf servislere yapılan çağrılar. Doğrudan OTel gönderen servislerde de Spitfire Collector'ın açtığı trace'lerde de çalışır. Menü: APM → Servisler → Mesajlaşma ve APM → Servisler → Dış çağrılar.
Mesajlaşma
Consumer mesajı okuduğunda çoğu enstrümantasyon yeni bir trace başlatır ve producer'ın span'ine bir span link koyar. Spitfire bu link'leri izler. Trace sayfasının üstündeki Bağlı trace'ler satırı önceki (Şuradan devam ediyor) ve sonraki (Şurada devam ediyor) trace'leri gösterir. Yanındaki Uçtan uca düğmesi producer → topic ya da kuyruk → consumer zincirini tek sayfada açar (en fazla 20 trace).
Mesajlaşma sayfası her topic, kuyruk ve consumer group için dakikadaki mesajı, hata oranını, gecikmeyi (p50/p95/p99) ve işleme süresini listeler. Span ayrıntısındaki Çağrı yolu bölümünde partition, offset, consumer group ve routing key görünür.
Gecikme = consumer span'inin başlangıcı − producer span'inin bitişi. Producer izlenmiyorsa Java agent'ın Kafka kayıt zamanı kullanılır. Producer en çok 6 saat geriye aranır. Eski ve yeni OTel adları birlikte okunur (messaging.destination ve messaging.destination.name gibi).
En sık karşılaşılan durum: API hızlı yanıt veriyor ama iş geç bitiyor. Sebep çoğu zaman consumer'ın geride kalmasıdır; Mesajlaşma sayfasındaki gecikme p95'i bunu ilk gösteren yerdir.
Load balancer ve proxy
- Geçiş süresi: client span'i başka bir servisin server span'ini çağırdığında aradaki fark (client süresi − server süresi) ağda, load balancer'da ya da proxy'de geçen süredir. Waterfall'da LB/proxy +… ms rozeti olarak görünür.
- Üzerinden: çağıranın istediği adres (
server.address) yanıt veren host'tan farklıysa o adres bir load balancer, Kubernetes servisi ya da gateway'dir. Topolojide çizginin üstünde üzerinden … yazar. - Proxy düğümleri: Nginx, Envoy (Istio dahil), HAProxy, Traefik, Kong, APISIX, Caddy ve API gateway'ler span gönderdiğinde topolojide proxy rozetiyle görünür.
- Yönlendirme başlıkları: servis
X-Forwarded-For,X-Real-IP,X-Request-IdveViagibi başlıkları span'e yazıyorsa (http.request.header.*) span ayrıntısı proxy zincirini gösterir. Bu başlıklar istek/yanıt yakalama ayarından bağımsız tutulur ve maskelenir.
Load balancer'ı ya da proxy'yi trace'e katmak için: Load balancer ve proxy'yi trace'e katmak.
Dış çağrılar
Hiçbir izlenen servisin yanıt vermediği client span'i dış çağrıdır: üçüncü taraf bir API, bir SaaS ya da agent'ı olmayan bir servis. Dış çağrılar sayfası bunları alan adına (ör. example.co.uk) ve host'a göre çağrı, hata oranı, p95 ve çağıran servislerle gösterir. Yollardaki sayılar ve UUID'ler tek bir yer tutucuya dönüşür; sorgu dizeleri saklanmaz. Veritabanı ve mesajlaşma çağrıları dış çağrı sayılmaz.
Neyi kim yakalar
| Kaynak | Mesajlaşma | Dış HTTP çağrısı | Bağlam taşıma |
|---|---|---|---|
| Java (OTel agent, Collector) | Kafka, RabbitMQ, JMS (IBM MQ, ActiveMQ), SQS, Pulsar; partition, offset ve kayıt zamanı | Her HTTP client | tracecontext, baggage, b3multi |
| .NET ve .NET Framework, IIS (OTel, Collector) | Service Bus, Event Hubs, Kafka (Confluent), RabbitMQ (kütüphane sürümüne göre) | HttpClient, HttpWebRequest |
tracecontext, baggage, b3multi |
| Node.js (OTel, Collector) | kafkajs, amqplib, SQS | http, fetch, undici | tracecontext, baggage, b3multi |
| Python (OTel, Collector) | kafka-python, confluent-kafka, pika, aio-pika, Celery | requests, httpx, urllib3 | tracecontext, baggage |
| PHP (OTel, Collector) | Kafka yok; AMQP kütüphaneye göre | Guzzle, cURL | tracecontext, baggage |
| Go, Rust, C++, Ruby (SDK) | Kullandığınız enstrümantasyon kütüphanesine göre | Kütüphaneye göre | SDK ayarına göre |
Spitfire Collector, trace'ini açtığı uygulamalara bu bağlam taşıma ayarlarını kendisi verir; uygulama aynı değişkeni kendisi ayarlamışsa uygulamanınki kalır.
Sık karşılaşılan sorunlar
- Bağlı trace'ler satırı görünmüyor: consumer span'inde span link yok. Producer ve consumer aynı bağlam taşıma biçimini kullanmalı (ikisinde de
tracecontext). Kafka'da mesaj başlıkları açık olmalı (Kafka 0.11 ve üstü). - Trace "saklanmamış" diyor: bağlı trace örneklemeye girmemiş, saklama süresinin dışında ya da servisi Spitfire'a göndermiyor.
- Bir servis dış çağrı olarak görünüyor: o servis span göndermiyor. Onu da bağlayın: Servisleri OTel ile bağlamak.
- Gecikme boş: producer span'i yok ve enstrümantasyon kayıt zamanı yazmıyor.