Python Uygulamalarinda OpenTelemetry

Dağıtılmış İzleme

• Dağıtılmış izleme, geliştiricilerin dağıtılmış sistemler üzerinden isteklerin izlemesini sağlar; bu OpenTelemetry tarafından Python için mümkün kılınır.
• İsteklerin sırasına, tarih ve saat bilgileri dahil hizmet temasları dahil olmak üzere izler içgörü sunar.
• Geliştiriciler, Python programlarını dağıtılmış izlerin bağımsız eylemleri veya parçaları olan span'ları kaydetmek için enstrüman edebilirler.

Metrikler Toplama

• OpenTelemetry Python, sistemin davranış ve performansı hakkında sayısal veriler toplayan metrikleri MeterProvider ithal etmeyi kolaylaştırır.
• Geliştiriciler, gecikme, işlem hızı, hata oranları ve kaynak kullanımı gibi ölçümleri toplamak için uygulamalarını enstrüman edebilirler.
• Bu metrikler, kullanım alışkanlıklarına, performans eğilimlerine ve sistem sağlığına dair içgörüler sunarak sistem davranışlarını anlamaya yardımcı olur.

Bağlam Yayılımı

• Bağlam yayılımı OpenTelemetry API paketi tarafından kolaylaştırılır, bu da dağıtılmış bağlamın - iz ve span bağlamı gibi - hizmet sınırları boyunca yayılmasını sağlar.
• Bağlam yayılımı, sistem boyunca hareket eden telemetri verilerinin sürekliliğini ve tutarlılığını koruyarak telemetri verilerinin ilişkilendirilmesine ve bağlamsallaştırılmasına olanak tanır.

Enstrümantasyon Kütüphaneleri

• OpenTelemetry Python, yaygın kullanılan çerçeveler, kütüphaneler ve protokoller için enstrümantasyon paketleri sağlayarak mevcut Python uygulamalarını enstrüman etmeyi kolaylaştırır.
• Web çerçeveleri (Flask ve Django gibi), veritabanı istemcileri (SQLAlchemy ve Pymongo gibi), mesajlaşma sistemleri (Kafka ve RabbitMQ gibi) ve diğerleri için entegrasyonlar enstrümantasyon kütüphanelerinde bulunabilir.

İhracatçı Ekosistemi

• OpenTelemetry Python tarafından sağlanan farklı gözlem sistemlerine ve alt yapısına telemetri verilerini ihracat eden çeşitli ihracatçı araçları geliştiricilere sunar.
• Jaeger, Zipkin, Prometheus, AWS X-Ray, Google Cloud Trace ve diğerleri gibi gözlemlenebilirlik platformlarıyla entegrasyonları ihracatçılar destekler.
• İhracatçılar, telemetri verilerini analiz, uzun vadeli depolama ve gösterim için bir veya daha fazla altyapıya aktarmak için geliştiriciler tarafından yapılandırılabilir.
• OpenTelemetry Python, toplanan telemetri verilerinin miktarının kontrol edilmesi için değişken örnekleme tekniklerini destekler.
• Geliştiriciler, örneği belirli bir iz oranını örneklemek veya önceden tanımlanmış parametrelere (örneğin istek başlıkları veya yolları gibi) dayalı olarak custom örnekleme logiği uygulama seçeneğine sahiptir.

Bağlamsal Kayıt Tutma

• Telemetri verilerine ek olarak bağlamsal veri kaydı yapmak için OpenTelemetry Python SDK ile araçlar sunulmaktadır.
• Çözümleme ve hata ayıklama sırasında daha fazla bağlam sağlamak için log mesajlarına iz ve span bağlamı ekleyebilirsiniz.

OpenTelemetry Yapılandırmasını Kurma

Projeniz için OpenTelemetry'yi kurmak için, gerekli paketleri pip install opentelemetry-exporter-jaeger kullanarak yükleyerek başlayabilirsiniz.

pip install opentelemetry-exporter-jaeger

pip install opentelemetry-exporter-jaeger

Daha sonra, aşağıdaki komutu kullanarak OpenTelemetry Python SDK'sını yükleyin:

pip install opentelemetry-sdk

pip install opentelemetry-sdk

opentelemetry-api pip paketi, enstrümantasyon için kapsamlı bir API sağlar ve otomatik enstrümantasyon sunar, bu da uygulamalarınızı enstrümante etmeyi kolaylaştırır. Bunu yapmanın alternatif bir yolu, verimli telemetri veri ihracatını sağlamak için ihracat-ithalat BatchSpanProcessor yöntemini kullanmak olabilir.

OpenTelemetry SDK parametrelerini tanımlamak için bir yapılandırma dosyası oluşturun. Yapılandırma dosyası otel_config.py bir örnek olarak hizmet eder. Kod örneğini hatasız bir şekilde kurmak için resources ithalat Resource ve trace ithalat TracerProvider gibi tüm ithalatların mevcut olduğundan emin olun.

from opentelemetry import trace
from opentelemetry.sdk.resources import Resource
from opentelemetry.sdk.trace import TracerProvider
from opentelemetry.sdk.trace.export import BatchSpanProcessor
from opentelemetry.exporter.jaeger.thrift import JaegerExporter

# Configure Jaeger exporter
jaeger_exporter = JaegerExporter(
    agent_host_name="localhost",
    agent_port=6831,
)

# Create a TracerProvider with Jaeger exporter
tracer_provider = TracerProvider(resource=Resource.create({'service.name': 'my-python-service'}))
tracer_provider.add_span_processor(BatchSpanProcessor(jaeger_exporter))
trace.set_tracer_provider(tracer_provider)

from opentelemetry import trace
from opentelemetry.sdk.resources import Resource
from opentelemetry.sdk.trace import TracerProvider
from opentelemetry.sdk.trace.export import BatchSpanProcessor
from opentelemetry.exporter.jaeger.thrift import JaegerExporter

# Configure Jaeger exporter
jaeger_exporter = JaegerExporter(
    agent_host_name="localhost",
    agent_port=6831,
)

# Create a TracerProvider with Jaeger exporter
tracer_provider = TracerProvider(resource=Resource.create({'service.name': 'my-python-service'}))
tracer_provider.add_span_processor(BatchSpanProcessor(jaeger_exporter))
trace.set_tracer_provider(tracer_provider)

Bu yapılandırma dosyası içinde:

• Jaeger ihracatçısı, izleri bir localhost Jaeger ajanına ihracat yapacak şekilde ayarlanır.
• Jaeger ihracatçısını kullanarak bir TracerProvider oluştururuz ve bunu genel izleyici sağlayıcı olarak yapılandırırız.
• Python programımız için hizmet adını sağlıyoruz.

Uygulamanızda OpenTelemetry'yi Başlatma

Python programınıza otel_config modülünü ithal edin, ardından OpenTelemetry'yi aşağıdaki örnek Python kodu ile başlangıçta başlatın:

from opentelemetry import trace
from otel_config import tracer_provider

# Initialize OpenTelemetry
trace.get_tracer(__name__)

from opentelemetry import trace
from otel_config import tracer_provider

# Initialize OpenTelemetry
trace.get_tracer(__name__)

Bunu yaparak, otel_config.py içinde bulunan yapılandırma, OpenTelemetry enstrümantasyonu için başlatılır.

Uygulamanızı Enstrümante Etme

Python programınızı iz kaydedebilmesi için enstrümante etmek amacıyla OpenTelemetry kullanılın. Kodunuzu enstrümanize etmek için iki seçeneğiniz var: manuel veya yerleşik kütüphaneler aracılığıyla. İşte birkaç manuel enstrümantasyon çağrısının bir örneği:

from opentelemetry import trace

# Start a span
with trace.get_tracer(__name__).start_as_current_span("example_span"):
    # Your code here
    pass

from opentelemetry import trace

# Start a span
with trace.get_tracer(__name__).start_as_current_span("example_span"):
    # Your code here
    pass

Izleri Jaeger UI'de Görüntüleme

Kaydedilen izleri görmek ve incelemek için Jaeger kullanıcı arayüzüne gidin. OpenTelemetry toplayıcısının kaydettiği izleri görüntülemek için web tarayıcınızda Jaeger UI'yi açın (genellikle http://localhost:16686 adresindedir) ve hizmet adınızı seçin.

Bu talimatları izleyerek uygulamanızda OpenTelemetry Python'u başarıyla kurdunuz ve yapılandırdınız. Artık OpenTelemetry'yi kullanarak izleri kaydedip Jaeger arka planına ihraç ederek Python programınızın nasıl davrandığını ve performansını görebilirsiniz.

IronPDF nedir?

Iron Software'den güçlü .NET kütüphanesi IronPDF ile geliştiriciler, .NET uygulamaları içinde PDF belgeleri oluşturabilir, düzenleyebilir ve sunabilir. Geliştiriciler, çeşitli kaynaklardan programatik olarak PDF belgeleri oluşturmak için IronPDF'yi kullanabilirler; bunlar arasında mevcut PDF dosyaları, HTML metni, URL'ler ve resimler yer alır. IronPDF'nin özelliklerine daha yakından bakalım:

HTML'i PDF'ye Dönüştürme

Geliştiriciler, IronPDF ile HTML içeriğini kolayca PDF dosyalarına dönüştürebilirler. HTML metnini girdi olarak kullanarak, geliştiriciler formatlama, resimler ve stillerle görsel olarak zengin PDF belgeleri üretebilirler.

URL'yi PDF'ye Dönüştür

Geliştiriciler, IronPDF kullanarak URL'lerden doğrudan PDF belgeleri üretebilirler. Bu işlevsellik için mükemmel bir uygulama, web sayfalarındaki içeriği veya web uygulamalarından dinamik olarak oluşturulan içeriği yakalamaktır.

Resmi PDF'ye Dönüştürme

IronPDF ile PNG, JPEG ve BMP formatlarındaki resimler PDF belgelerine dönüştürülebilir. Bu özellik, fotoğraflardan PDF belgeleri oluşturmak isteyen uygulama geliştiricileri için faydalıdır; örneğin, resim albümleri yapmak veya fotoğrafları PDF dosyalarına eklemek gibi uygulamalar için.

IronPDF Nasıl Kurulur

Python'un bilgisayarınıza yüklü olduğundan emin olduktan sonra, IronPDF'i yüklemek için pip kullanın.

pip install ironpdf

IronPDF ile PDF Belgesi Oluşturmak İçin OpenTelemetry Kullanma

OpenTelemetry'nin başlatılmasının altında, bir PDF belgesi oluşturmak için IronPDF'yi kullanmak için aşağıdaki kodu ekleyin:

from ironpdf import ChromePdfRenderer
from opentelemetry import trace

# Generate PDF document with IronPDF
with trace.get_tracer(__name__).start_as_current_span("pdf_generation"):
    iron_pdf = ChromePdfRenderer()
    html_content = "<html><body><h1>Hello, IronPDF!</h1></body></html>"

    pdf_content = iron_pdf.render_html_as_pdf(html_content)

    # Save or send the PDF content as needed
    with open("output.pdf", "wb") as file:
        file.write(pdf_content)

from ironpdf import ChromePdfRenderer
from opentelemetry import trace

# Generate PDF document with IronPDF
with trace.get_tracer(__name__).start_as_current_span("pdf_generation"):
    iron_pdf = ChromePdfRenderer()
    html_content = "<html><body><h1>Hello, IronPDF!</h1></body></html>"

    pdf_content = iron_pdf.render_html_as_pdf(html_content)

    # Save or send the PDF content as needed
    with open("output.pdf", "wb") as file:
        file.write(pdf_content)

Bu kod pasajında:

• OpenTelemetry izleyicisini kullanarak, pdf_generation adlı yeni bir aralık başlatıyoruz.
• Bu süre zarfında, HTML materyalini PDF belgesine dönüştürmek için IronPDF'yi kullanıyoruz.
• output.pdf adlı bir dosya oluşturulan PDF materyalini içerir.