Python Uygulamalarinda OpenTelemetry

Dağıtılmış İzleme

• OpenTelemetry Python için, geliştiricilerin dağıtılmış sistemler boyunca isteklerin yolunu takip etmesine olanak tanıyan dağıtılmış izleme yapabilir.
• İzler, taleplerin sırasını, hizmet temaslarının tarih ve saatlerini içeren bilgilendirici bir içgörü sunar.
• Python programları, geliştiricilerin dağıtık bir izleme parçası olan belirli işlemler veya parçaların izlerini kaydetmeleri için enstrümanize edilebilir.

Metrix Toplama

• OpenTelemetry Python, sistemin davranış ve performansına ilişkin sayısal verileri toplayan metriklerin içe aktarımını kolaylaştırır MeterProvider.
• Geliştiriciler, gecikme, throughput, hata oranları ve kaynak kullanımı gibi ölçümleri toplamak için uygulamalarını enstrümanize edebilirler.
• Bu metrikler, kullanım desenleri, performans eğilimleri ve sistem sağlığı hakkında içgörüler sunarak sistem davranışlarını anlamada yardımcı olur.

Bağlam Aktarımı

• OpenTelemetry API paketi, iz ve eylem bağlamı gibi dağıtılmış bağlamın hizmet sınırları arasında aktarılmasını kolaylaştırır.
• Bağlam aktarımı sayesinde, telemetri verileri sistemden geçerken ilişkilendirilebilir ve bağlamlandırılabilir, bu da verilerin sürekliliğini ve tutarlılığını korur.

Enstrümantasyon Kütüphaneleri

• OpenTelemetry Python, yaygın olarak kullanılan framework, kütüphane ve protokoller için enstrümantasyon paketleri sağlayarak mevcut Python uygulamalarını enstrümanize etmeyi basitleştirir.
• Web framework entegrasyonları (Flask ve Django gibi), veri tabanı istemcileri (SQLAlchemy ve Pymongo gibi), mesajlaşma sistemleri (Kafka ve RabbitMQ gibi) ve daha fazlası enstrümantasyon kütüphanelerinde bulunabilir.

Veri İhracatçıları Ekosistemi

• OpenTelemetry Python tarafından sağlanan bir dizi ihracatçı, geliştiricilerin telemetri verilerini farklı gözlemlenebilirlik sistemlerine ve backendlere ihraç etmelerine olanak tanır.
• Jaeger, Zipkin, Prometheus, AWS X-Ray, Google Cloud Trace ve daha fazlası gibi gözlemlenebilirlik platformlarına entegrasyonlar ihracatçılar tarafından desteklenir.
• Geliştiriciler, telemetri verilerini uzun vadeli depolama, analiz ve gösterim için bir veya daha fazla backend'e taşımak için ihracatçıları ayarlayabilirler.
• OpenTelemetry Python, toplanan telemetri veri miktarını düzenlemek için değişken örnekleme tekniklerini destekler.
• Geliştiriciler, özel örnekleme mantığı uygulama, örnekle bir izi belirli bir yüzde dahilinde örnekleme veya belirli parametrelere göre (istek başlıkları veya rotalar gibi) örnekleme yapma seçeneğine sahiptir.

Bağlamsal Kaydetme

• OpenTelemetry Python SDK, telemetri verilerine ek olarak bağlamsal veriyi kaydetmek için mevcut araçlar sunar.
• Geliştiriciler, daha fazla hata ayıklama ve sorun giderme bağlamı sağlamak adına iz ve eylem bağlamı eklemek için bağlamsal günlüğe ekleme işlemlerini gerçekleştirebilirler.

OpenTelemetry Yapılandırmasını ayarlayın

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

pip install opentelemetry-exporter-jaeger

pip install opentelemetry-exporter-jaeger

Daha sonrasında, OpenTelemetry Python SDK'sını aşağıdaki komut kullanarak kurun:

pip install opentelemetry-sdk

pip install opentelemetry-sdk

opentelemetry-api pip paketi, kapsamlı bir enstrümantasyon API'si sağlar ve uygulamalarınızı enstrümante etmeyi kolaylaştıran otomatik enstrümantasyon sunar. Bunu yapmanın alternatif bir yolu, verimli telemetri verisi 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 olarak kurmak için resources import Resource ve trace import 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 yerel Jaeger ajanına ihraç etmek için yapılandırılmıştır.
• Jaeger ihracatçısını kullanarak, bir TracerProvider oluşturuyoruz ve bunu küresel izleyici sağlayıcı olarak yapılandırıyoruz.
• Python programımız için hizmet adını sağlamaktayız.

Uygulamanızda OpenTelemetry'i Başlatın

otel_config modülünü Python programınıza ithal edin, ardından OpenTelemetry'yi aşağıdaki Python kodu örneğiyle 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ümantize Edin

Python programınızı izleri kaydedebilecek şekilde enstrümantize etmek için OpenTelemetry kullanın. Kodunuzu enstrümantize etmek için iki seçeneğiniz var: manuel olarak veya yerleşik kütüphaneler aracılığıyla. Bu, bir kaç manuel enstrümantasyon çağrısının gösterimidir:

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

Jaeger UI'de İzlemeleri Görüntüleme

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

Bu talimatları takip ederek uygulamanızda OpenTelemetry Python'u başarınızla kurmuş ve yapılandırmış oldunuz. Artık OpenTelemetry kullanarak Python programınızın nasıl davrandığını ve performansını görmek için izleri kaydedebilir ve onları Jaeger backend'ine ihraç edebilirsiniz.

IronPDF Nedir?

Iron Software'nin güçlü .NET kütüphanesi olan IronPDF ile geliştiriciler, .NET uygulamaları içinde PDF belgeleri oluşturabilir, düzenleyebilir ve sunabilirler. Geliştiriciler, IronPDF kullanarak önceden mevcut PDF dosyalarından, HTML metninden, URL'lerinden ve görsellerden programatik olarak PDF belgeleri oluşturabilirler. Haydi IronPDF'nin özelliklerini daha yakından inceleyelim:

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

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

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

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

Görüntüyü PDF'ye Dönüştürme

IronPDF ile, PNG, JPEG ve BMP formatlarındaki görüntüler PDF belgelerine dönüştürülebilir. Bu özellik, fotoğraf albümleri oluşturma veya PDF dosyalarına fotoğraflar ekleme gibi şeyler için uygulama geliştiricilere yardımcı olarak fotoğraflardan PDF belgeleri oluşturma imkanı tanır.

IronPDF Nasıl Kurulur

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

pip install ironpdf

OpenTelemetry Kullanarak IronPDF ile PDF Belgesi Oluşturma

IronPDF ile bir PDF belgesi oluşturmak için, OpenTelemetry'ın başlangıç kodunun altına 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 bölümünde:

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