Load balancer ve proxy'yi trace'e katmak (Nginx, Envoy, HAProxy)
Nginx ve Envoy kendi span'ini yazar; HAProxy yalnız bağlamı ve istemci adresini arkadaki servise taşır. Sonuçta topolojide proxy düğümü, waterfall'da proxy'de geçen süre ve span ayrıntısında istemci zinciri görünür (Çağrı yolu). Hiçbir şey yapmasanız da Spitfire iki izlenen servis arasındaki load balancer'ı geçiş süresi ve üzerinden adresiyle gösterir; bu rehber onu proxy'nin kendi span'iyle zenginleştirir.
Ne gerekecek
- Proxy sunucusunda root ya da
sudoyetkisi. - Aynı sunucuda
127.0.0.1:4317'den OTLP gRPC dinleyen bir Collector (kurulumu). Anahtarı ve Spitfire adresini Collector taşır, proxy'nin ayarına anahtar yazılmaz.
Collector'ın dinlediğini doğrulayın:
sudo ss -ltnp | grep 4317Tamam: çıktıda 127.0.0.1:4317 ya da 0.0.0.0:4317 satırı var.
Nginx
Doğrulandı: nginx 1.27 ve nginx.org deposundaki nginx-module-otel, Ubuntu 24.04.
Modülü kurun (nginx.org deposu tanımlı olmalı):
sudo apt-get update && sudo apt-get install -y nginx-module-otelTamam:
ls /usr/lib/nginx/modules/ngx_otel_module.sodosyayı listeler.Modülü yükleyin (
/etc/nginx/nginx.confdosyasının en başına bir satır ekler):sudo grep -q ngx_otel_module /etc/nginx/nginx.conf || sudo sed -i '1i load_module modules/ngx_otel_module.so;' /etc/nginx/nginx.confTamam:
sudo head -1 /etc/nginx/nginx.confçıktısıload_module modules/ngx_otel_module.so;.Trace ayarını yazın (
/etc/nginx/conf.d/içindekilerhttpbloğuna eklenir):sudo tee /etc/nginx/conf.d/spitfire-otel.conf >/dev/null <<'CONF' otel_exporter { endpoint 127.0.0.1:4317; } otel_service_name nginx-edge; otel_trace on; otel_trace_context propagate; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; proxy_set_header X-Request-Id $request_id; CONFTamam:
sudo nginx -tçıktısındasyntax is okvetest is successful.Nginx'i yeniden yükleyin:
sudo systemctl reload nginx && curl -s -o /dev/null -w '%{http_code}\n' http://127.0.0.1/Tamam: bir HTTP durum kodu yazar (ör.
200). Bir dakika içinde APM → Topoloji'denginx-edgedüğümü proxy · nginx rozetiyle görünür.
otel_service_name değerini proxy'nin adıyla değiştirebilirsiniz. Bir location blokunda proxy_set_header kullanıyorsanız Nginx http seviyesindekileri o blokta almaz; iki proxy_set_header satırını o bloğa da ekleyin.
Envoy
Doğrulandı: Envoy 1.32, /etc/envoy/envoy.yaml ile çalışan kurulum.
/etc/envoy/envoy.yamldosyasında herenvoy.filters.network.http_connection_managerbloğununtyped_configaltına şunu ekleyin:tracing: provider: name: envoy.tracers.opentelemetry typed_config: "@type": type.googleapis.com/envoy.config.trace.v3.OpenTelemetryConfig grpc_service: envoy_grpc: cluster_name: spitfire_otel timeout: 0.25s service_name: envoy-edgeAynı dosyada
static_resources.clusterslistesine şu cluster'ı ekleyin:- name: spitfire_otel type: STATIC typed_extension_protocol_options: envoy.extensions.upstreams.http.v3.HttpProtocolOptions: "@type": type.googleapis.com/envoy.extensions.upstreams.http.v3.HttpProtocolOptions explicit_http_config: http2_protocol_options: {} load_assignment: cluster_name: spitfire_otel endpoints: - lb_endpoints: - endpoint: address: socket_address: { address: 127.0.0.1, port_value: 4317 }Dosyayı doğrulayın:
envoy --mode validate -c /etc/envoy/envoy.yamlTamam: çıktının sonunda
configuration '/etc/envoy/envoy.yaml' OK.Envoy'u yeniden başlatın:
sudo systemctl restart envoy && sudo systemctl is-active envoyTamam:
active. Bir istekten sonra APM → Topoloji'deenvoy-edgedüğümü proxy · envoy rozetiyle görünür.
Istio'da bu adımlar gerekmez: mesh'in trace sağlayıcısını aynı Collector'a yönlendirin; istio-ingressgateway düğümü proxy olarak tanınır.
HAProxy
HAProxy'nin standart paketleri span yazmaz; Spitfire onu iki servis arasındaki geçiş olarak gösterir. Bu adımlar bağlamı ve istemci adresini arkadaki servise ulaştırır.
Doğrulandı: HAProxy 2.8 ve 3.0, /etc/haproxy/haproxy.cfg.
/etc/haproxy/haproxy.cfgdosyasında herfrontendbloğuna şu satırları ekleyin:option forwardfor unique-id-format %{+X}o\ %ci:%cp_%fi:%fp_%Ts_%rt:%pid http-request set-header X-Request-Id %[unique-id] unless { req.hdr(x-request-id) -m found }traceparentbaşlığına dokunmayın: HAProxy onu olduğu gibi arkaya geçirir.Dosyayı doğrulayın:
sudo haproxy -c -f /etc/haproxy/haproxy.cfgTamam:
Configuration file is valid.HAProxy'yi yeniden yükleyin:
sudo systemctl reload haproxy && sudo systemctl is-active haproxyTamam:
active.
Başlıkları span'e yazdırın
İstemci zinciri ve istek kimliğinin span ayrıntısında görünmesi için arkadaki servis bu başlıkları span'e yazmalı. Java agent'ta uygulamanın ortamına ekleyin:
OTEL_INSTRUMENTATION_HTTP_SERVER_CAPTURE_REQUEST_HEADERS=x-forwarded-for,forwarded,x-real-ip,x-request-id,via.NET'te aynı liste OTEL_DOTNET_AUTO_TRACES_ASPNETCORE_INSTRUMENTATION_CAPTURE_REQUEST_HEADERS; Node.js ve Python'da kendi rehberlerindeki başlık ayarı. Uygulamayı yeniden başlatın.
Tamam: APM → Trace'ler'de proxy'den geçen bir isteğin server span'ini açın; Çağrı yolu bölümünde Yönlendirme başlıkları görünür.
Geri almak
- Nginx:
sudo rm /etc/nginx/conf.d/spitfire-otel.conf && sudo sed -i '/ngx_otel_module/d' /etc/nginx/nginx.conf && sudo nginx -t && sudo systemctl reload nginx - Envoy: eklediğiniz
tracingbloğunu vespitfire_otelcluster'ını silin,envoy --mode validate -c /etc/envoy/envoy.yamlile doğrulayıp yeniden başlatın. - HAProxy: eklediğiniz üç satırı silin,
sudo haproxy -c -f /etc/haproxy/haproxy.cfg && sudo systemctl reload haproxy.