SpitfireYük Testi ve APMYenilikler

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 sudo yetkisi.
  • 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:

bash
sudo ss -ltnp | grep 4317

Tamam: çı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.

  1. Modülü kurun (nginx.org deposu tanımlı olmalı):

    bash
    sudo apt-get update && sudo apt-get install -y nginx-module-otel

    Tamam: ls /usr/lib/nginx/modules/ngx_otel_module.so dosyayı listeler.

  2. Modülü yükleyin (/etc/nginx/nginx.conf dosyasının en başına bir satır ekler):

    bash
    sudo grep -q ngx_otel_module /etc/nginx/nginx.conf || sudo sed -i '1i load_module modules/ngx_otel_module.so;' /etc/nginx/nginx.conf

    Tamam: sudo head -1 /etc/nginx/nginx.conf çıktısı load_module modules/ngx_otel_module.so;.

  3. Trace ayarını yazın (/etc/nginx/conf.d/ içindekiler http bloğuna eklenir):

    bash
    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;
    CONF

    Tamam: sudo nginx -t çıktısında syntax is ok ve test is successful.

  4. Nginx'i yeniden yükleyin:

    bash
    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'de nginx-edge düğü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.

  1. /etc/envoy/envoy.yaml dosyasında her envoy.filters.network.http_connection_manager bloğunun typed_config altına şunu ekleyin:

    yaml
              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-edge
  2. Aynı dosyada static_resources.clusters listesine şu cluster'ı ekleyin:

    yaml
      - 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 }
  3. Dosyayı doğrulayın:

    bash
    envoy --mode validate -c /etc/envoy/envoy.yaml

    Tamam: çıktının sonunda configuration '/etc/envoy/envoy.yaml' OK.

  4. Envoy'u yeniden başlatın:

    bash
    sudo systemctl restart envoy && sudo systemctl is-active envoy

    Tamam: active. Bir istekten sonra APM → Topoloji'de envoy-edge düğü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.

  1. /etc/haproxy/haproxy.cfg dosyasında her frontend bloğuna şu satırları ekleyin:

    text
        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 }

    traceparent başlığına dokunmayın: HAProxy onu olduğu gibi arkaya geçirir.

  2. Dosyayı doğrulayın:

    bash
    sudo haproxy -c -f /etc/haproxy/haproxy.cfg

    Tamam: Configuration file is valid.

  3. HAProxy'yi yeniden yükleyin:

    bash
    sudo systemctl reload haproxy && sudo systemctl is-active haproxy

    Tamam: 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:

bash
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 tracing bloğunu ve spitfire_otel cluster'ını silin, envoy --mode validate -c /etc/envoy/envoy.yaml ile 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.

İlgili sayfalar