Tüm Ürünler
Search
Belge Merkezi

Application Real-Time Monitoring Service:Use Jaeger to report trace data from a Python application

Son Güncelleme:Oct 06, 2026

Python uygulamanızı Jaeger istemcisi ile donatarak izleme verilerini Managed Service for OpenTelemetry hizmetine gönderin. Bağlantıyı kurduktan sonra ARMS konsolunda uygulama topolojisini, izlemeleri, anormal ve yavaş işlemleri ile SQL analizlerini görüntüleyebilirsiniz.

Önemli

Gelişmiş özellikler ve izleme yetenekleri için uygulamanızı OpenTelemetry protokolü kullanarak Managed Service for OpenTelemetry hizmetine bağlamanızı öneririz.

Detaylı OpenTelemetry entegrasyon kılavuzlarımız ve en iyi uygulamalarımız Managed Service for OpenTelemetry hizmetini kullanmaya başlamanıza yardımcı olur. Daha fazla bilgi için bkz. Uygulama bağlama.

Çalışma mekanizması

Jaeger iki veri gönderme mimarisini destekler:

  • Jaeger aracısı olmadan: Jaeger istemcisi, izleme verilerini doğrudan Managed Service for OpenTelemetry arka ucuna gönderir.

image

  • Jaeger aracısı ile: Jaeger istemcisi, izleme verilerini yerel olarak çalışan bir Jaeger aracısına gönderir; aracı bu verileri gRPC üzerinden arka uca iletir.

image

Kısıtlamalar

  • Python Jaeger istemcisi (v1.25), izleme verilerini yalnızca Jaeger aracısı üzerinden gönderebilir; HTTP üzerinden gönderim desteklenmez. Bkz. İstemci Kitaplığı Özellikleri.

  • İstemci, aracı ile UDP üzerinden iletişim kurar ve UDP teslimat garantisi sağlamaz. Veri kaybını en aza indirmek için her ikisini de aynı ana bilgisayarda çalıştırın.

Adım 1: Jaeger aracısını başlatın

  1. Jaeger aracı görüntüsünü çekin:

       docker pull jaegertracing/jaeger-agent:1.25
  2. Jaeger aracı konteynerini başlatın: Aşağıdaki yer tutucuları Cluster Configurations sayfasındaki değerlerle değiştirin:

    Yer Tutucu Açıklama
    <endpoint> Managed Service for OpenTelemetry gRPC uç noktası
    <auth> Kimlik doğrulama belirteci
       docker run -d --name jaeger-agent \
         -p 5775:5775/udp \
         -p 6831:6831/udp \
         -p 6832:6832/udp \
         -p 5778:5778/tcp \
         jaegertracing/jaeger-agent:1.25 \
         --reporter.type=grpc \
         --reporter.grpc.host-port=<endpoint> \
         --agent.tags=<auth>
  3. Aracının çalıştığını doğrulayın: Up durumu, aracının başarıyla başlatıldığını gösterir. Konteyner çalışmıyorsa günlükleri kontrol edin:

       docker ps --filter name=jaeger-agent
       docker logs jaeger-agent

Adım 2: Python uygulamasını donatın

  1. Gerekli paketleri yükleyin. Aşağıdakileri bir requirements.txt dosyasına kaydedin ve ardından paketleri yükleyin:

       certifi==2021.5.30
       charset-normalizer==2.0.4
       idna==3.2
       jaeger-client==4.6.0
       opentracing==2.4.0
       requests==2.26.0
       six==1.16.0
       threadloop==1.0.2
       thrift==0.13.0
       tornado==6.1
       urllib3==1.26.6
       pip install -r requirements.txt
  2. Aşağıdaki kodu içeren bir Python dosyası oluşturun (örneğin, tracing_demo.py): Temel yapılandırma parametreleri:

    Parametre Değer Açıklama
    sampler.type const Her izlemeyi örnekleme alır. Üretim ortamında daha düşük bir param değeriyle probabilistic kullanın.
    sampler.param 1 const türünde 1 tüm izlemelerin örneklenmesi, 0 ise hiçbirinin örneklenmemesi anlamına gelir.
    reporting_host 127.0.0.1 Jaeger aracısının adresi. Aynı ana bilgisayarda çalıştırırken 127.0.0.1 kullanın.
    reporting_port 6831 Jaeger aracısının span'ları dinlediği UDP bağlantı noktası.
    service_name mytest3 ARMS konsolunda uygulamanızı tanımlayan ad.
       import logging
       import time
       from jaeger_client import Config
    
       def construct_span(tracer):
           with tracer.start_span('AliyunTestSpan') as span:
               span.log_kv({'event': 'test message', 'life': 42})
               print("tracer.tags: ", tracer.tags)
               with tracer.start_span('AliyunTestChildSpan', child_of=span) as child_span:
                   span.log_kv({'event': 'down below'})
               return span
    
       if __name__ == "__main__":
           log_level = logging.DEBUG
           logging.getLogger('').handlers = []
           logging.basicConfig(format='%(asctime)s %(message)s', level=log_level)
    
           config = Config(
               config={
                   'sampler': {
                       'type': 'const',  # Sample every trace. Use 'probabilistic' in production.
                       'param': 1,
                   },
                   'local_agent': {
                       # The Jaeger agent address. Keep this as 127.0.0.1 when the agent
                       # runs on the same host, which is recommended for UDP reliability.
                       'reporting_host': '127.0.0.1',
                       'reporting_port': 6831,
                   },
                   'logging': True,
               },
               service_name="mytest3",  # Replace with your application name.
               validate=True
           )
    
           # Initialize the tracer. This also sets opentracing.tracer.
           tracer = config.initialize_tracer()
    
           span = construct_span(tracer)
    
           # Allow the IOLoop to flush buffered spans before closing.
           # See: https://github.com/jaegertracing/jaeger-client-python/issues/50
           time.sleep(2)
           tracer.close()
  3. Dosyayı çalıştırın: Başarılı başlatmada hata ayıklama çıktısı, tracer yapılandırmasını gösterir ve span'ların Jaeger aracısına gönderildiğini doğrular.

       python tracing_demo.py

Konsolda izleme verilerini doğrulayın

  1. ARMS konsoluna giriş yapın. Sol gezinme bölmesinde Application Monitoring > Applications seçeneklerini seçin.

  2. Applications sayfasında üst gezinme çubuğundan bir bölge seçin ve uygulama adınıza tıklayın.

    Not

    Language sütununda image simgesi görünüyorsa uygulama Application Monitoring kullanıyor demektir. Tire (-) Managed Service for OpenTelemetry olduğunu gösterir.

  3. Application Overview bölümünde temel performans ölçümlerini ve topolojiyi kontrol edin.

    Application Overview sayfasının Overview Analysis sekmesi aşağıdaki temel ölçümleri gösterir:

    • Total Requests: Haftalık ve günlük değişimlerle birlikte istek sayısı.

    • Average Response Time: Yanıt süresi ve eğilimi.

    • Exceptions: Anormal istek sayısı.

    • Span Count: İzlemedeki toplam span sayısı.

    Bu ölçümlerin altında Services Provided ve Dependent Services alanları, istek hacmi ve ortalama yanıt süresi için trend çizgi grafikleri gösterir.

  4. Sol gezinme bölmesinde Application Details seçeneğine tıklayın. Overview sekmesi uygulama özetini gösterir.

    Application Details sayfasında varsayılan olarak Overview sekmesi görüntülenir. Bu sekme uygulama topolojisini ve üç izleme grafiğini (Requests, response time ve Exceptions) gösterir. Sol taraftaki hizmet listesi, her arayüzün yanıt süresini, istek sayısını ve hata sayısını gösterir.

  5. Uygulamanızdan gönderilen izleme verilerini görüntülemek için Traces sekmesine tıklayın.

Eksik izleme verilerini giderme

Uygulamanızı çalıştırdıktan sonra konsolda izleme verileri görünmüyorsa aşağıdakileri kontrol edin:

Sorun Eylem
Jaeger aracısı çalışmıyor docker ps --filter name=jaeger-agent komutunu çalıştırın ve durumun Up olarak göründüğünü doğrulayın. Aracı günlüklerini docker logs jaeger-agent ile kontrol edin.
Yanlış uç nokta veya belirteç <endpoint> ve <auth> değerlerinin Cluster Configurations sayfasındaki değerlerle eşleştiğini doğrulayın. Düzelttikten sonra aracıyı yeniden başlatın.
Aracı ve istemci farklı ana bilgisayarlarda Jaeger istemcisi verileri UDP üzerinden gönderir ve UDP ana bilgisayarlar arasında güvenilir değildir. Aracıyı uygulama ile aynı ana bilgisayarda çalıştırın ve reporting_host değerini 127.0.0.1 olarak ayarlayın.
Span'lar temizlenmiyor Arabelleğe alınan span'ların IOLoop tarafından temizlenmesine izin vermek için time.sleep(2) çağrısının tracer.close() öncesinde yapıldığından emin olun.
Ağ bağlantısı Ana bilgisayarın yapılandırılmış gRPC bağlantı noktasında Managed Service for OpenTelemetry uç noktasına ulaşabildiğini doğrulayın.

Yaygın Jaeger işlemleri

Aşağıdaki örnekler yaygın Jaeger izleme işlemlerini kapsar. Daha fazla ayrıntı için bkz. Başlangıç Kılavuzu.

Tracer oluşturma

from jaeger_client import Config

def init_jaeger_tracer(service_name='your-app-name'):
    config = Config(config={}, service_name=service_name)
    return config.initialize_tracer()

Span oluşturma ve tamamlama

# Start a root span (no parent).
tracer.start_span('TestSpan')

# Start a child span.
tracer.start_span('ChildSpan', child_of=span)

# Finish the span.
span.finish()

SpanContext'i hizmetler arasında yayma

# Inject: serialize the SpanContext into a carrier for downstream services.
tracer.inject(
    span_context=span.context, format=Format.TEXT_MAP, carrier=carrier
)

# Extract: deserialize the SpanContext from an incoming request.
span_ctx = tracer.extract(format=Format.TEXT_MAP, carrier={})