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.
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.
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.
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
-
Jaeger aracı görüntüsünü çekin:
docker pull jaegertracing/jaeger-agent:1.25 -
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> -
Aracının çalıştığını doğrulayın:
Updurumu, 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-agentdocker logs jaeger-agent
Adım 2: Python uygulamasını donatın
-
Gerekli paketleri yükleyin. Aşağıdakileri bir
requirements.txtdosyası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.6pip install -r requirements.txt -
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.typeconstHer izlemeyi örnekleme alır. Üretim ortamında daha düşük bir paramdeğeriyleprobabilistickullanın.sampler.param1consttüründe1tüm izlemelerin örneklenmesi,0ise hiçbirinin örneklenmemesi anlamına gelir.reporting_host127.0.0.1Jaeger aracısının adresi. Aynı ana bilgisayarda çalıştırırken 127.0.0.1kullanın.reporting_port6831Jaeger aracısının span'ları dinlediği UDP bağlantı noktası. service_namemytest3ARMS 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() -
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
ARMS konsoluna giriş yapın. Sol gezinme bölmesinde Application Monitoring > Applications seçeneklerini seçin.
-
Applications sayfasında üst gezinme çubuğundan bir bölge seçin ve uygulama adınıza tıklayın.
NotLanguage sütununda
simgesi görünüyorsa uygulama Application Monitoring kullanıyor demektir. Tire (-) Managed Service for OpenTelemetry olduğunu gösterir. -
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.
-
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.
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={})