PythonアプリケーションにおけるOpenTelemetry

分散トレース

• OpenTelemetry for Python により、開発者は分散システムを通じて要求の経路を追跡することができます。
• トレースは、サービスに接触した日時を含む要求のシーケンスについての洞察を提供します。
• 開発者は、Python プログラムを計測して、分散トレースの個別のアクションまたは部分であるスパンを記録することができます。

メトリクスの収集

• OpenTelemetry Python は、システムの挙動やパフォーマンスに関する数値データを収集する MeterProvider をインポートします。
• 開発者は、遅延、スループット、エラー率、リソース使用量などの測定を収集するためにアプリケーションを計測できます。
• これらのメトリクスは、使用パターン、パフォーマンス傾向、システムの健全性についての洞察を提供することで、システム動作の理解を助けます。

コンテキスト伝播

• OpenTelemetry API パッケージにより、トレースやスパンコンテキストなどの分散コンテキストがサービスの境界を越えて伝播されることが保証され、コンテキスト伝播が容易になります。
• コンテキスト伝播によりテレメトリーデータがシステムを通過する際に相関付け、文脈化されるため、データの継続性と一貫性が保たれます。

計装ライブラリ

• OpenTelemetry Python は、既存の Python アプリケーションを計装するために広く使用されているフレームワーク、ライブラリ、プロトコル用の計装パッケージを提供することにより、簡単に計装できます。
• 計装ライブラリには、Web フレームワーク（Flask や Django など）、データベースクライアント（SQLAlchemy や Pymongo など）、メッセージシステム（Kafka や RabbitMQ など）に対する統合が含まれています。

エクスポートエコシステム

• OpenTelemetry Python が提供するさまざまなエクスポーターにより、開発者は異なる可観測性システムやバックエンドにテレメトリーデータをエクスポートできます。
• Jaeger、Zipkin、Prometheus、AWS X-Ray、Google Cloud Trace などの可観測性プラットフォームとの統合がエクスポーターによりサポートされています。
• 開発者は、テレメトリーデータを長期保管、分析、表示のために1つまたは複数のバックエンドに転送するためにエクスポーターを設定できます。
• OpenTelemetry Python は、収集されるテレメトリーデータの量を制御するためにさまざまなサンプリング技術をサポートしています。
• 開発者はカスタムサンプリングロジックを適用するオプションを持ち、一定割合のトレースをサンプリングするように設定するか、要求ヘッダーやルートなどの事前定義されたパラメーターに従ってサンプリングすることができます。

コンテキスト記録

• OpenTelemetry Python SDK には、テレメトリーデータに加えてコンテキストデータを記録するためのツールがあります。
• 開発者はコンテキストログを使用してログメッセージにトレースおよびスパンコンテキストを追加することで、トラブルシューティングおよびデバッグのための文脈を提供することができます。

OpenTelemetry の設定を行う

プロジェクト用に OpenTelemetry をセットアップするには、pip install opentelemetry-exporter-jaeger を使用して必要なパッケージをインストールすることから始めます。

pip install opentelemetry-exporter-jaeger

pip install opentelemetry-exporter-jaeger

その後、次のコマンドを使用して OpenTelemetry Python SDK をインストールしてください。

pip install opentelemetry-sdk

pip install opentelemetry-sdk

opentelemetry-api pip パッケージは計装のための包括的な API を提供し、アプリケーションを計装しやすくする自動計装を提供します。 別の方法として、効率的なテレメトリーデータエクスポートを保証するためにエクスポートインポート BatchSpanProcessor メソッドを使用することができます。

OpenTelemetry SDK のパラメーターを定義するには、設定ファイルを作成します。構成ファイル otel_config.py が例として役立ちます。 すべてのインポートが含まれていることを確認します。たとえば、resources としての Resource インポート、trace としての TracerProvider インポートを含め、コードの例をエラーなく設定できます。

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)

この構成ファイル内では次のことが行われます。

• Jaeger エクスポーターがローカルホスト Jaeger エージェントにトレースをエクスポートするように設定されています。
• Jaeger エクスポーターを使用して TracerProvider を作成し、それをグローバルトレーサープロバイダーとして構成します。
• Python プログラムのサービス名を提供します。

アプリケーションで OpenTelemetry を初期化する

Python プログラムに otel_config モジュールをインポートし、次の Python コード例で初期化して OpenTelemetry を開始します。

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__)

このようにすることで、OpenTelemetry 計装のために otel_config.py に記載された構成が初期化されます。

アプリケーションを計装する

OpenTelemetry を使用して Python プログラムを計装し、それによりトレースを記録します。 コードを計装するには、手動で行うか、組み込みライブラリを使用する2つのオプションがあります。 これは、いくつかの手動計装呼び出しの例です。

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 でトレースを表示する

記録されたトレースを確認および調査するには、Jaeger ユーザーインターフェースにアクセスします。 Web ブラウザで Jaeger UI (通常は http://localhost:16686 にあります) を開いて、OpenTelemetry コレクターが記録するトレースを表示するには、サービス名を選択します。

これらの手順に従うことで、アプリケーションに OpenTelemetry Python がうまく確立および構成されていることを確認しました。 今、OpenTelemetry を使用してトレースを記録し、これらを Jaeger バックエンドにエクスポートすることで、Python プログラムの挙動とパフォーマンスを確認できます。

IronPDF とは何ですか?

Iron Software の強力な .NET ライブラリ IronPDF を使用することで、開発者は .NET アプリケーション内で PDF ドキュメントを作成、編集、および表示できます。 開発者は、事前に存在する PDF ファイル、HTML テキスト、URL、画像など、さまざまなソースからプログラムを使用して PDF ドキュメントを作成することができます。 IronPDF の機能を詳しく見てみましょう。

HTML を PDF に変換する

開発者は IronPDF を使用して HTML コンテンツを簡単に PDF ファイルに変換できます。 HTML テキストを入力として使用することで、形式、画像、スタイルを備えた視覚的に豊かな PDF ドキュメントを開発者が作成できます。

URL を PDF に変換する

開発者は IronPDF を使用して URL から直接 PDF ドキュメントを生成できます。 この機能の優れた応用として、ウェブページからコンテンツをキャプチャしたり、ウェブアプリから動的に生成されたコンテンツをキャプチャすることが挙げられます。

画像を PDF に変換する

IronPDF を使用すれば、PNG、JPEG、および BMP 形式の画像を PDF ドキュメントに変換できます。 この機能は、アプリ開発者が写真から PDF ドキュメントを作成するために、たとえば写真アルバムを作成したり PDF ファイルに写真を組み込むアプリケーションに役立ちます。

IronPDF のインストール方法

Python がコンピュータにインストールされていることを確認した後、pip を使用して IronPDF をインストールします。

 pip install ironpdf

IronPDF を使用して PDF ドキュメントを生成するための OpenTelemetry

IronPDF を使用して PDF を作成する ために、OpenTelemetry の初期化の下に次のコードを追加します。

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)

このコードの一部では次のことを行います。

• OpenTelemetry トレーサーを使用して、pdf_generation という新しいスパンが開始されます。
• HTML マテリアルを PDF ドキュメントに変換するために IronPDF を使用します。
• 生成された PDF マテリアルは output.pdf というファイルに含まれています。