dotnetup テレメトリ

Note

dotnetup はパブリック プレビュー段階です。 その機能と動作は、一般公開前に変更される可能性があります。

dotnetupには、使用状況データを収集し、dotnetupコマンドの実行時にMicrosoftに送信するテレメトリ機能が含まれています。 使用状況データには、 dotnetup クラッシュ時の例外情報が含まれます。 .NET チームは、このデータを使用して、ユーザーがツールをどのように使用しているかを理解し、問題を解決します。

オプトアウトする方法

テレメトリは既定でオンになっています。 オプトアウトするには、DOTNET_CLI_TELEMETRY_OPTOUT 環境変数を 1 または true に設定してください。

これは、.NET SDK と CLI のテレメトリをオフにする同じ変数です。 詳細については、.NET SDK と .NET CLI テレメトリに関するページを参照してください。

初回実行時の通知

dotnetupを初めて実行すると、次のメッセージが表示されます。

dotnetup collects usage data to help improve your experience. You can opt out by setting the DOTNET_CLI_TELEMETRY_OPTOUT environment variable to '1'. Learn more: https://aka.ms/dotnetup-telemetry

テレメトリをオフにせずにこの通知を非表示にするには、 DOTNET_NOLOGO 環境変数を 1 または trueに設定します。

データ ポイント

テレメトリ機能では、ユーザー名やメール アドレスなどの個人データは収集されません。 コードをスキャンせず、また、プロジェクト レベルのデータを抽出しません。 dotnetupは、Azure Monitor テクノロジを使用してMicrosoft サーバーに安全にデータを送信します。

dotnetup は、次のデータを収集します。

  • 呼び出しのタイムスタンプ。
  • install、update、listなど、実行するコマンド。
  • dotnetupバージョンとコミット SHA。
  • オペレーティング システムとアーキテクチャ。
  • dotnetupが継続的インテグレーション (CI) 環境で実行されるかどうか。
  • dotnetupが GitHub Copilot などの LLM エージェント上で実行されるかどうか。
  • 終了コード、または成功または失敗の状態。
  • エラーの場合: エラーの種類、エラー カテゴリ、ファイル パスのないサニタイズされたエラーの詳細、例外メッセージのないスタック トレース。

クラッシュ例外製品利用統計情報

dotnetup がクラッシュすると、例外の名前と、dotnetup コードのスタック トレースが収集されます。 ユーザー入力を含めることができるため、例外メッセージは含まれません。 このアプローチは、.NET SDK が使用するアプローチと同じです。 詳細については、「クラッシュ例外テレメトリ」を参照してください。

CI および LLM エージェントの検出

dotnetupでは、.NET SDK と同じ CI 環境検出と LLM エージェント検出が使用されます。 確認する環境変数の一覧については、「 継続的インテグレーション検出 と LLM 検出」を参照してください。

Variable 説明
DOTNET_CLI_TELEMETRY_OPTOUT 1またはtrueに設定すると、テレメトリをオフにします。
DOTNET_NOLOGO 1またはtrueに設定すると、最初の実行通知を非表示にします。 テレメトリはオンのままです。
DOTNET_CLI_TELEMETRY_STORAGE_PATH データをアップロードする前に、 dotnetup がテレメトリをローカルに格納するディレクトリを変更します。
DOTNET_CLI_TELEMETRY_SHUTDOWN_TIMEOUT_MS CI 環境では、dotnetup が終了する前にテレメトリ送信を待機する最大時間(ミリ秒)を変更します。 既定値は 20,000 です。

プライバシー

テレメトリによって機密データが収集されたと思われる場合、または Microsoft がデータを安全でない方法または不適切に扱っていると思われる場合は、dotnet/sdk リポジトリに問題を報告してください。

詳細については、「 Microsoft プライバシーに関する声明」を参照してください。

参照