Python アプリケーションのトレース

Docs > APM > Datadog へのトレースの送信 > Add the Datadog Tracing Library > Python アプリケーションのトレース

互換性要件

最新の Python トレーサーは、CPython バージョン 2.7 と 3.5-3.11 に対応しています。

Datadog の Python バージョンとフレームワークのサポート一覧 (レガシーバージョンとメンテナンスバージョンを含む) については、互換性要件ページをご覧ください。

はじめに

作業を始める前に、Agent のインストールと構成が済んでいることを確認してください。

インスツルメンテーション方法の選択

Datadog Agent をデプロイまたはインストールして構成したら、次はアプリケーションをインスツルメンテーションします。アプリが動作するインフラストラクチャー、書かれている言語、必要な構成のレベルに応じて、以下の方法でこれを行うことができます。

サポートされるデプロイシナリオと言語については、次のページを参照してください。

インスツルメンテーションライブラリをローカル挿入する (Agent で)。
Datadog UI からインスツルメンテーションライブラリを挿入する (ベータ版)、または
トレーサーをインストールするセクションで説明したように、アプリケーションに直接トレーシングライブラリを追加する。互換性情報を参照してください。

アプリケーションをインスツルメントする

Kubernetes アプリケーションからトレースを収集する場合、以下の説明の代わりに、Cluster Agent Admission Controller を使用してアプリケーションにトレーシングライブラリを挿入することができます。手順については、Admission Controller を使用したライブラリの挿入をお読みください。

Agent をインストールしたら、Python で記述されたアプリケーションのトレースを開始するには、Datadog トレーシングライブラリ ddtrace を、pip を使用してインストールします。

pip install ddtrace

注: このコマンドは pip バージョン 18.0.0 以上が必要です。Ubuntu、Debian、またはその他のパッケージマネージャーをお使いの場合は、以下のコマンドで pip バージョンを更新してください。

pip install --upgrade pip

Python アプリケーションをインスツルメントするには、記載されている ddtrace-run コマンドを使用します。これを使用するには、Python エントリーポイントコマンドを ddtrace-run でプレフィックスします。

たとえば、アプリケーションが python app.py で始まる場合、次のようになります。

ddtrace-run python app.py

セットアップが完了し、アプリケーションでトレーサーを実行したら、ddtrace-run --info を実行して、構成が期待通りに動作しているかどうかを確認することができます。このコマンドの出力は、実行中にコード内で行われた構成の変更を反映しないことに注意してください。

構成

必要に応じて、統合サービスタグ付けの設定など、アプリケーションパフォーマンスのテレメトリーデータを送信するためのトレースライブラリーを構成します。詳しくは、ライブラリの構成を参照してください。

トレース用の接続は、コードで構成することも可能です。

from ddtrace import tracer

# ネットワークソケット
tracer.configure(
    https=False,
    hostname="custom-hostname",
    port="1234",
)

# Unix ドメインソケットの構成
tracer.configure(
    uds_path="/var/run/datadog/apm.socket",
)

統計用の接続は、コードで構成することも可能です。

from ddtrace import tracer

# ネットワークソケット
tracer.configure(
  dogstatsd_url="udp://localhost:8125",
)

# Unix ドメインソケットの構成
tracer.configure(
  dogstatsd_url="unix:///var/run/datadog/dsd.socket",
)