Python テスト

互換性

サポートされている Python インタープリター:

  • Python >= 2.7 および >= 3.5

サポートされているテストフレームワーク:

  • pytest >= 3.0.0
    • Python 2 を使用する場合は pytest < 5

前提条件

Datadog Agent をインストールして、テストデータを収集します

Python トレーサーのインストール

次のコマンドを実行して、Python トレーサーをインストールします。

pip install -U ddtrace

詳細については、Python トレーサーのインストールドキュメントを参照してください。

テストのインスツルメンテーション

pytest テストのインスツルメンテーションを有効にするには、pytest の実行時に --ddtrace オプションを追加し、DD_SERVICE 環境変数でテスト対象のサービスまたはライブラリの名前を、DD_ENV 環境変数でテストが実行されている環境を指定します (たとえば、開発者ワークステーションでテストを実行する場合は local、CI プロバイダーでテストを実行する場合は ci)。

DD_SERVICE=my-python-app DD_ENV=ci pytest --ddtrace

コンフィギュレーション設定

以下は、コードか、または環境変数を使用した、トレーサーで使用できる最も重要なコンフィギュレーション設定のリストです。

ddtrace.config.service
テスト中のサービスまたはライブラリの名前。
環境変数: DD_SERVICE
デフォルト: pytest
: my-python-app
ddtrace.config.env
テストが実行されている環境の名前。
環境変数: DD_ENV
デフォルト: none
: localci

次の環境変数を使用して、Datadog Agent の場所を構成できます。

DD_TRACE_AGENT_URL
http://hostname:port の形式のトレース収集用の Datadog Agent URL。
デフォルト: http://localhost:8126

他のすべての Datadog トレーサーコンフィギュレーションオプションも使用できます。

その他の参考資料