- はじめに
- エージェント
- インテグレーション
- Watchdog
- イベント
- ダッシュボード
- モバイルアプリケーション
- インフラストラクチャー
- サーバーレス
- メトリクス
- ノートブック
- アラート設定
- APM & Continuous Profiler
- CI Visibility
- RUM & セッションリプレイ
- データベース モニタリング
- ログ管理
- セキュリティプラットフォーム
- Synthetic モニタリング
- ネットワークモニタリング
- 開発者
- API
- アカウントの管理
- データセキュリティ
- ヘルプ
対応する .NET バージョン:
対応するテストフレームワーク:
テストデータを収集するために Datadog Agent をインストールします。
以下のいずれかの方法で dd-trace
コマンドをインストールまたは更新してください。
以下のコマンドを実行して、.NET SDK を使用する。
dotnet tool update -g dd-trace
適切なバージョンをダウンロードする。
または、github のリリースページよりダウンロードする。
テストスイートをインスツルメントするには、テストコマンドの前に dd-trace ci run
を付け、テスト中のサービスまたはライブラリの名前を --dd-service
パラメーターとして指定し、テストが実行されている環境 (たとえば、 開発者ワークステーションでテストを実行する場合は local
、CI プロバイダーでテストを実行する場合は ci
) を --dd-env
パラメーターとして使用します。例:
dotnet test の使用によって
dd-trace ci run --dd-service=my-dotnet-app --dd-env=ci -- dotnet test
VSTest.Console.exe の使用によって
dd-trace ci run --dd-service=my-dotnet-app --dd-env=ci -- VSTest.Console.exe {test_assembly}.dll
すべてのテストは自動的にインスツルメントされます。
コマンドライン引数または環境変数を使用して、CLI のデフォルトコンフィギュレーションを変更できます。コンフィギュレーション設定の完全なリストについては、以下を実行してください。
dd-trace ci run --help
次のリストは、主要なコンフィギュレーション設定のデフォルト値を示しています。
--dd-service
DD_SERVICE
my-dotnet-app
--dd-env
DD_ENV
none
local
、ci
--agent-url
http://hostname:port
の形式のトレース収集用の Datadog Agent URL。DD_TRACE_AGENT_URL
http://localhost:8126
他のすべての Datadog トレーサーコンフィギュレーションオプションも使用できます。
Datadog は、テスト結果を可視化し、リポジトリ、ブランチ、コミットごとにグループ化するために Git の情報を使用します。Git のメタデータは、CI プロバイダーの環境変数や、プロジェクトパス内のローカルな .git
フォルダがあれば、そこからテストインスツルメンテーションによって自動的に収集されます。
サポートされていない CI プロバイダーでテストを実行する場合や、.git
フォルダがない場合は、環境変数を使って Git の情報を手動で設定することができます。これらの環境変数は、自動検出された情報よりも優先されます。Git の情報を提供するために、以下の環境変数を設定します。
DD_GIT_REPOSITORY_URL
git@github.com:MyCompany/MyApp.git
、https://github.com/MyCompany/MyApp.git
DD_GIT_BRANCH
develop
DD_GIT_TAG
1.0.1
DD_GIT_COMMIT_SHA
a18ebf361cc831f5535e58ec4fae04ffd98d8152
DD_GIT_COMMIT_MESSAGE
Set release number
DD_GIT_COMMIT_AUTHOR_NAME
John Smith
DD_GIT_COMMIT_AUTHOR_EMAIL
john@example.com
DD_GIT_COMMIT_AUTHOR_DATE
2021-03-12T16:00:28Z
DD_GIT_COMMIT_COMMITTER_NAME
Jane Smith
DD_GIT_COMMIT_COMMITTER_EMAIL
jane@example.com
DD_GIT_COMMIT_COMMITTER_DATE
2021-03-12T16:00:28Z
dd-trace
のバージョンに依存します。カスタムインスツルメンテーションを使用するには、dd-trace
と Datadog.Trace
の NuGet パッケージのバージョンを同期させておく必要があります。.NET アプリケーションでカスタムインスツルメンテーションを使用するには
dd-trace --version
を実行します。Datadog.Trace
NuGet パッケージをアプリケーションに追加します。Datadog.Trace.Tracer.Instance
プロパティを介してグローバルトレーサーにアクセスし、新しいスパンを作成します。カスタムインスツルメンテーションのスパンやタグの追加方法については、.NET カスタムインスツルメンテーションのドキュメントを参照してください。
Agent を使用せずにテストスイートをインスツルメントするには、以下の環境変数を構成します。
DD_CIVISIBILITY_AGENTLESS_ENABLED
(必須)false
DD_API_KEY
(必須)(empty)
そして、テストコマンドの前に dd-trace ci run
を付けます。--dd-service
パラメーターを使用して、サービスやライブラリの名前を指定します。--dd-env
パラメーターには、テストを実行する環境を指定します (開発者のワークステーションでテストを実行する場合は local
、CI プロバイダでテストを実行する場合は ci
など)。
dd-trace ci run --dd-service=my-dotnet-app --dd-env=ci -- dotnet test
また、 --api-key
パラメーターを使用して、Datadog API キーを提供することも可能です。例:
dd-trace ci run --api-key <API KEY> --dd-service=my-dotnet-app --dd-env=ci -- dotnet test
--api-key
を設定すると、自動的に Agentless モードが有効になります。
さらに、どの Datadog サイトにデータを送信するかを構成します。あなたの Datadog サイトは です。
DD_SITE
(必須)datadoghq.com
お役に立つドキュメント、リンクや記事: