Microsoft.Testing.Platform テレメトリ

Microsoft.Testing.Platform はテレメトリ データを収集し、そのデータは製品の改善方法を理解するのに使われます。 たとえば、この使用データは、遅い起動などの問題をデバッグし、新しい機能の優先順位を付けるのに役立ちます。 これらの分析情報は有効性が評価されていますが、任意で利用統計情報を無効にすることができます。 詳細については、プライバシー ステートメントに関するページを参照してください。

テレメトリ データの種類

Microsoft.Testing.Platform で収集される製品利用統計情報の種類は、使用状況データのみです。 この使用状況データは、テスト アプリを実行したときに、機能がどのように使われ、どこで時間がかかったかを把握するために使われます。 これを利用して、製品の改善に優先順位を付けることができます。

テレメトリ レポートを無効にする

利用統計情報を無効にするには、TESTINGPLATFORM_TELEMETRY_OPTOUT または DOTNET_CLI_TELEMETRY_OPTOUT 環境変数を 1 に設定します。

開示

実行可能ファイルを初めて実行すると、Microsoft.Testing.Platform で次のようなテキストが表示されます。 出力テキストは、実行している Microsoft.Testing.Platform のバージョンによって多少異なることがあります。 この "最初の実行" の際に、Microsoft がデータ回収に関して通知する方法が示されます。

Telemetry
---------
Microsoft.Testing.Platform collects usage data in order to help us improve your experience.
The data is collected by Microsoft and are not shared.
You can opt-out of telemetry by setting the TESTINGPLATFORM_TELEMETRY_OPTOUT
or DOTNET_CLI_TELEMETRY_OPTOUT environment variable to '1' or 'true' using your favorite shell.

Read more about Microsoft.Testing.Platform telemetry: https://aka.ms/testingplatform-telemetry

データ ポイント

製品利用統計情報機能では、ユーザー名やメール アドレスなどの個人データは収集されません。 コードはスキャンされず、リポジトリや作成者などのプロジェクト レベルのデータは抽出されません。実行可能ファイルの名前は抽出されて、ハッシュ形式で送信されます。

アプリによってアクセスまたは作成されたデータ ファイルの内容、アプリのオブジェクトによって占有されているメモリのダンプ、クリップボードの内容は抽出されません。

データは、Azure Monitor テクノロジを使用して Microsoft サーバーに安全に送信され、制限されたアクセスの下で保持され、厳格なセキュリティ コントロールの下で、安全な Azure Storage システムから公開されます。

ユーザーのプライバシー保護は Microsoft にとって重要です。 利用統計情報で機密データが収集されている、またはデータが安全でないか不適切な方法で処理されていることが疑われる場合は、microsoft/testfx GitHub リポジトリで問題を提出するか、dotnet@microsoft.com にメールを送信して調査を依頼してください。

利用統計情報の機能では次のデータ ポイントが収集されます。

バージョン	データ
すべて	.NET ランタイムのバージョン。
すべて	アプリケーション モード ("server" など)。
すべて	不合格になったテスト再試行の数。
すべて	合格したテスト再試行の数。
すべて	不合格になったテストの数。
すべて	合格したテストの数。
すべて	実行されたテストの数。
すべて	使用している拡張機能の DisplayName (ハッシュ値)。
すべて	プラットフォームのデバッグ ビルドが使用されているかどうか。
すべて	デバッガーがプロセスにアタッチされていたかどうか。
すべて	テストのフィルターが使用されたかどうか。
すべて	ホット リロードが有効になっているかどうか。
すべて	アプリケーションがクラッシュしたかどうか。
すべて	アプリケーションが NativeAOT として実行されているかどうか。
すべて	リポジトリが独自のリポジトリかどうか。 testingplatformconfig.json の telemetry:isDevelopmentRepository 設定に基づきます。
すべて	使用しているテスト フレームワークの名前 (ハッシュ値)。
すべて	実行可能ファイルの名前 (通常はプロジェクトの名前と同じです) (ハッシュ値)。
すべて	オペレーティング システム、バージョン、アーキテクチャ。
すべて	プロセスのアーキテクチャ。
すべて	ランタイム ID (RID)。 詳細については、「.NET の RID カタログ」を参照してください。
すべて	アプリケーションの終了コード。
すべて	地理的な場所を決定するために使用する 3 つのオクテットの IP アドレス。
すべて	呼び出しのタイムスタンプ、実行のさまざまなステップの開始と終了のタイムスタンプ。
すべて	プラットフォームのバージョン。
すべて	拡張機能のバージョン。
すべて	テスト アダプターのバージョン。
すべて	1 つのランナーからのイベントを関連付けるための GUID。
1.0.3	1 回のテスト実行からのイベントを関連付けるための GUID。

継続的インテグレーション検出

.NET CLI が継続的インテグレーション環境で実行されているかどうかを検出するために、.NET CLI では、一般的な CI プロバイダーで設定されるいくつかの既知の環境変数の存在と値をプローブします。

環境変数の完全な一覧と、それらの値で実行される内容の詳細を、次の表に示します。

環境変数	プロバイダー	アクション
APPVEYOR	Appveyor	ブール値を解析する。
BUILD_ID、BUILD_URL	Jenkins	すべてが存在し、null でないかどうかを確認する。
BUILD_ID、PROJECT_ID	Google Cloud Build	すべてが存在し、null でないかどうかを確認する。
CI	多数/大部分	ブール値を解析する。
CIRCLECI	Circle CI	ブール値を解析する。
CODEBUILD_BUILD_ID、AWS_REGION	Amazon Web Services CodeBuild	すべてが存在し、null でないかどうかを確認する。
GITHUB_ACTIONS	GitHub のアクション	ブール値を解析する。
JB_SPACE_API_URL	JetBrains Space	存在し、null でないかどうかを確認する。
TEAMCITY_VERSION	TeamCity	存在し、null でないかどうかを確認する。
TF_BUILD	Azure Pipelines	ブール値を解析する。
TRAVIS	Travis CI	ブール値を解析する。