Microsoft。CodeCoverage.Console テレメトリ

dotnet-coverageグローバル ツールとMicrosoft.CodeCoverage.Console.exeは、製品を改善する方法Microsoft理解するのに役立つテレメトリ データを収集します。 たとえば、この使用状況データは、新機能の優先順位付けや問題のデバッグに役立ちます。 どちらのツールも同じコマンド サーフェイスを共有するため、同じテレメトリが収集されます。

テレメトリはいつでも無効にすることができます。 データMicrosoft処理方法の詳細については、「Microsoftプライバシーに関する声明」を参照してください。

テレメトリ データの種類

コード カバレッジ ツールでは 、使用状況データのみが収集されます。 使用状況データは、使用されるコマンドと、ツールの実行時に設定されるオプションを示します。 この情報は、製品の改善Microsoft優先順位を付けるのに役立ちます。

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

テレメトリを無効にするには、 DOTNET_COVERAGE_TELEMETRY_OPTOUT 環境変数を 1 に設定します。

標準の .NET CLI オプトアウト変数DOTNET_CLI_TELEMETRY_OPTOUTが 1 に設定されている場合も、テレメトリは無効になります。 そのため、.NET SDK テレメトリをオプトアウトすると、コード カバレッジ ツールからのテレメトリも除外されます。

開示

ツールを初めて実行すると、次のようなテキストが表示されます。 この初回実行時エクスペリエンスは、データ収集について通知します。

Telemetry
---------
The code coverage tools collect usage data in order to help us improve your experience. The data is collected by Microsoft. You can opt out of telemetry by setting the DOTNET_COVERAGE_TELEMETRY_OPTOUT environment variable to '1' using your favorite shell.

This message is displayed only once. Set the DOTNET_COVERAGE_NOLOGO environment variable to '1' to suppress it in the future.

通知は 1 回だけ表示されます。 スクリプトや継続的インテグレーション (CI) などを抑制するには、 DOTNET_COVERAGE_NOLOGO 環境変数を 1 または trueに設定します。 この動作は、 DOTNET_NOLOGOを反映します。

データ ポイント

テレメトリ機能では、ユーザー名やメール アドレスなどの個人データは収集されません。 コードがスキャンされたり、リポジトリや作成者などのプロジェクト レベルのデータが抽出されたりすることはありません。

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

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

ファイル パス、ユーザー指定のセッション ID ( --session-id から)、コマンド ラインなどのユーザー データを含む値は、逐語的に送信されることはありません。 代わりに、オプションまたは引数が指定されたという事実のみが、ブール値 trueとして記録されます。

テレメトリが機密データを収集している、またはそのデータが安全でまたは不適切に処理されていると思われる場合は、microsoft/codecoverage GitHub リポジトリに問題を報告します。

テレメトリ機能は、次のデータ ポイントを収集します。

Version データ
18.10 イベントを生成したツールの名前 ( dotnet-coverage や Microsoft.CodeCoverage.Consoleなど)。
18.10 ツールのバージョン。
18.10 テレメトリ スキーマのバージョン。
18.10 オペレーティング システム、バージョン、アーキテクチャ。
18.10 プロセス アーキテクチャ。
18.10 ランタイム フレームワーク.NETします。
18.10 ランタイム識別子 (RID)。 詳細については、「.NET RID カタログを参照してください。
18.10 ツールが CI 環境で実行されているかどうか。
18.10 地理的な場所を決定するために使用される 3 オクテット IP アドレス。
18.10 呼び出しのタイムスタンプ。
18.10 1 つのツール実行からのイベントを関連付けるために使用される自動生成された関連付け ID (GUID)。 この値は、ユーザー指定のセッション ID とは異なります。
18.10 collectやmergeなど、呼び出されるコマンドの名前。
18.10 設定ファイルが提供されたかどうか。
18.10 出力パスが指定されたかどうか。
18.10 インクルード ファイルの一覧が指定されたかどうか。
18.10 connect コマンドに対してアプリケーション引数が指定されたかどうか。
18.10 ログ ファイルのパスが指定されたかどうか。
18.10 サーバー モードが有効になっているかどうか。
18.10 バックグラウンド モードが有効になっているかどうか。
18.10 マージ後に入力ファイルを削除するかどうかを指定します。
18.10 再帰マージが要求されたかどうか。
18.10 スナップショットがリセットされたかどうか。
18.10 タグ名が指定されたかどうか。
18.10 タグ識別子が指定されたかどうか。
18.10 依存関係がインストルメント化されるかどうか。
18.10 コンソール出力が無効にされたかどうか。
18.10 ロゴまたは初回実行時の通知が抑制されたかどうか。
18.10 coberturaやxmlなどの出力形式。
18.10 Debugなどのログ レベル。
18.10 タイムアウト値。

共有コンテキスト

テレメトリは Azure アプリケーション Insights を介して配信されるため、各イベントには、オペレーティング システムの説明と、1 回の実行からのイベントを関連付けるために使用されるランダムに生成された関連付け ID という標準の非ユーザー コンテキストも含まれます。 この関連付け ID は、ユーザー指定のセッション ID ではありません。 このコンテキストには、コード、アセンブリ、またはカバレッジ データの内容は含まれません。

こちらも参照ください

  • Last updated on