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）环境中运行。 - 是否由 LLM 智能体（例如 GitHub Copilot）运行
dotnetup。 - 退出代码或成功或失败状态。
- 对于失败：错误类型、错误类别、已去除文件路径的错误详细信息，以及不含异常消息的堆栈跟踪。
故障异常遥测
如果 dotnetup 崩溃，它将收集异常的名称和 dotnetup 代码的堆栈跟踪。 它不包括异常消息，因为它们可以包含用户输入。 此方法与 .NET SDK 使用的方法相同。 有关详细信息，请参阅故障异常遥测。
CI 和 LLM 代理检测
dotnetup使用与 .NET SDK 相同的 CI 环境检测和 LLM 代理检测。 有关它检查的环境变量的列表，请参阅 持续集成检测 和 LLM 检测。
相关环境变量
| Variable | 说明 |
|---|---|
DOTNET_CLI_TELEMETRY_OPTOUT |
设置为true或1时关闭遥测。 |
DOTNET_NOLOGO |
当设置为 true 或 1 时，隐藏首次运行通知。 遥测保持开启状态。 |
DOTNET_CLI_TELEMETRY_STORAGE_PATH |
更改 dotnetup 在上传数据之前在本地存储遥测数据的目录。 |
DOTNET_CLI_TELEMETRY_SHUTDOWN_TIMEOUT_MS |
在 CI 环境中，更改 dotnetup 在退出前等待发送遥测数据的最长时间（以毫秒为单位）。 默认值为 20,000。 |
隐私
如果你认为遥测会收集敏感数据，或者 Microsoft 处理数据时不安全或不恰当，请在dotnet/sdk 存储库中提交问题。
有关详细信息，请参阅 Microsoft隐私声明。
