大网数据广告活动
.NET 与 C# 开发

.NET Core SDK 遥测

· 52CE 我爱测

了解可收集使用情况信息以供分析的 .NET Core SDK 遥测功能、收集哪些数据,以及如何禁用遥测。

.NET Core SDK 包括可收集使用情况信息的遥测功能。 请务必让 .NET 团队了解到工具使用情况,以便我们对其做出改进。 有关详细信息,请参阅从 .NET Core SDK 遥测中所了解到的内容。

数据为匿名收集,并以汇总形式发布,以供 Microsoft 和社区根据 Creative Commons Attribution 许可证使用。

范围

dotnet 命令用于启动应用程序和 .NET Core CLI。 dotnet 命令本身不收集遥测数据。 dotnet 命令运行的 .NET Core CLI 命令收集遥测数据。

使用 dotnet 命令本身且没有附加任何命令时,不会启用 遥测:

  • dotnet
  • dotnet [path-to-app]

使用 .NET Core CLI 命令时,就会启用 遥测,如:

  • dotnet build
  • dotnet pack
  • dotnet restore
  • dotnet run

如何选择退出

.NET Core SDK 遥测功能默认处于启用状态。 通过将 DOTNET_CLI_TELEMETRY_OPTOUT 环境变量设置为 1 或 true,可以选择退出遥测功能。

数据点

此功能收集以下数据:

  • 调用时间戳†
  • 调用的命令(例如,“build”)†
  • 用于确定地理位置的三个八进制数 IP 地址†
  • 命令的 ExitCode
  • 测试运行程序(对于测试项目)
  • 操作系统和版本†
  • “运行时”节点中是否有运行时 ID
  • .NET Core SDK 版本†

†此指标已发布。

自 .NET Core SDK 2.0 SDK 起,收集以下新数据点:

  • dotnet 命令参数和选项:仅收集已知参数和选项(非任意字符串)。
  • SDK 是否在容器中运行。
  • 目标框架。
  • 经过哈希处理的 MAC 地址:计算机的加密 (SHA256) 匿名的唯一 ID。 此指标未发布。
  • 经过哈希处理的当前工作目录。

此功能不收集用户名或电子邮件地址等个人数据。 也不会扫描代码,亦不会提取项目级敏感数据,如名称、存储库或作者。 数据通过 Microsoft Azure Application Insights 技术安全地发送到 Microsoft 服务器,提供对保留数据的受限访问权限,并在严格的安全控制下从安全 Azure 存储系统发布。

.NET 团队需要知道工具使用情况及其是否在正常运行,而不是使用这些工具生成的内容。 如果怀疑遥测在收集敏感数据,或认为我们处理数据的方式不安全或不恰当,请在 dotnet/cli 存储库中记录问题以供调查。

已发布的数据

数据每季度发布一次,并在 .NET Core SDK 使用情况数据中列出。 数据文件列如下:

  • 时间戳
  • Occurrences†
  • 命令
  • Geography‡
  • OSFamily
  • RuntimeID
  • OSVersion
  • SDKVersion

†Occurrences 列显示相应命令当天用于该行指标的总次数。

‡通常情况下,Geography 列显示国家/地区名称。 在某些情况下,此列中会显示南极洲,要么是因为研究人员在南极洲使用 .NET Core,要么是因为位置数据不正确。

示例

时间戳 Occurrences 命令 Geography OSFamily RuntimeID OSVersion SDKVersion
4/16/2017 0:00 8 运行 Uganda Darwin osx.10.12-x64 10.12 1.0.1

数据集

其他数据集使用标准的 URL 格式进行发布。 请将 <YEAR> 替换为相应年份,并将 <QUARTER> 替换为相应季度(使用 1、2、3 或 4)。 文件采用制表符分隔值 (TSV ) 格式。

https://dotnetcli.blob.core.windows.net/usagedata/dotnet-cli-usage-<YEAR>-q<QUARTER>.tsv

许可证

.NET Core 的 Microsoft 分发由 Microsoft 软件许可条款:Microsoft .NET 库许可。 有关数据收集和处理的详细信息,请参阅标题为“数据”的部分。

.NET NuGet 包使用相同许可证,但不启用遥测(见范围)。

公开

首次运行其中一个 .NET Core CLI 命令(例如,dotnet restore)时,.NET Core SDK 工具显示以下文本。 文本可能会因运行的 SDK 版本而略有不同。 此“首次运行”体验是 Microsoft 通知用户有关数据收集信息的方式。

Welcome to .NET Core!
---------------------
Learn more about .NET Core: https://aka.ms/dotnet-docs
Use 'dotnet --help' to see available commands or visit: https://aka.ms/dotnet-cli-docs

Telemetry
---------
The .NET Core tools collect usage data in order to help us improve your experience.
The data is anonymous and doesn't include command-line arguments.
The data is collected by Microsoft and shared with the community.
You can opt-out of telemetry by setting the DOTNET_CLI_TELEMETRY_OPTOUT environment variable to '1' or 'true' using your favorite shell.

Read more about .NET Core CLI Tools telemetry: https://aka.ms/dotnet-cli-telemetry

请参阅

历史资料。此文对应 2019-08-18 的中文文档快照,适用产品版本和命令行为以原文为准。

来源与署名:Microsoft 和文档贡献者(原始作者元数据 richlander)。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站将 Markdown 转为 HTML,规范化链接,移除外部媒体和导航标记。

资料来源与适用范围

资料来源
Microsoft / .NET 中文文档历史快照
适用范围
历史中文快照 2019-08-18;详见原文产品版本;文档日期 06/20/2018
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-16
授权说明
CC BY 4.0(文档)/ MIT(示例代码)

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。