遥测
Visual Studio Code 收集遥测数据，这些数据用于帮助了解如何改进产品。例如，这些使用数据有助于调试问题（如启动时间缓慢）和优先开发新功能。我们感谢这些数据提供的见解，但我们也知道并非所有人都希望发送使用数据，你可以按照禁用遥测报告中所述禁用遥测。你还可以阅读我们的隐私声明以了解更多信息。
遥测数据类型
VS Code 和此页面提及三种不同类型的遥测数据。
崩溃报告 - 崩溃报告在 VS Code 崩溃时收集诊断信息并将其发送给 Microsoft，以帮助理解崩溃发生的原因以及未来需要哪些更改来防止崩溃。
错误遥测 - 错误遥测收集有关未导致应用程序崩溃但意外发生的错误的信息。
使用情况数据 - 使用情况数据收集有关 VS Code 中功能的使用方式和性能的信息，这有助于我们优先改进未来的产品。
禁用遥测报告
通过 telemetry.telemetryLevel 用户设置，你可以通过一个设置来控制我们发送的不同类型的遥测数据。以下表格列出了在 telemetry.telemetryLevel 的每个值下发送的不同数据类型。
| 崩溃报告 | 错误遥测 | 使用情况数据 | |
|---|---|---|---|
| all | ✓ | ✓ | ✓ |
| error | ✓ | ✓ | - |
| crash | ✓ | - | - |
| off | - | - | - |
例如，如果你不想向 Microsoft 发送任何遥测数据，可以将 telemetry.telemetryLevel 用户设置为 off。这将禁用 VS Code 此后发送的所有遥测事件。请注意，在你禁用设置之前，遥测信息可能已被收集并发送。
如果您使用 JSON 编辑器进行设置，请添加以下行
"telemetry.telemetryLevel": "off"
扩展与遥测
VS Code 允许你通过安装 Microsoft 和第三方扩展来向产品添加功能。这些扩展可能会收集自己的使用情况数据，并且不受 telemetry.telemetryLevel 设置的控制。请查阅特定扩展的文档，了解其遥测报告以及是否可以禁用。
扩展作者可以参考“针对扩展作者”部分，了解在其扩展中实施遥测最佳实践的指南。
遥测事件的输出通道
要在遥测事件发送时查看它们，请从命令面板 () 运行开发者：显示遥测命令。此命令启用遥测事件的跟踪，并在输出面板中打开遥测输出通道 (⇧⌘U (Windows Ctrl+Shift+U, Linux Ctrl+K Ctrl+H))。当遥测事件发送时，输出通道会显示事件详情。
跟踪遥测事件时，事件也会记录到本地文件 telemetry.log 中，你可以使用开发者：打开日志...命令并从下拉菜单中选择遥测来查看它。
要禁用遥测事件跟踪，请重新加载 VS Code 窗口（开发者：重新加载窗口命令）。
查看所有遥测事件
如果你想查看 VS Code 可能发送的所有遥测事件，你可以在 CLI 中使用 --telemetry 标志。这将生成一个 JSON 报告，你可以在 VS Code 中查看该报告。这些报告是按构建生成的，并且不包含扩展遥测，除非扩展作者在其根构建目录中添加了 telemetry.json 文件。
例如，运行 code --telemetry > telemetry.json && code telemetry.json 将在当前工作目录中创建一个 telemetry.json 文件，然后将其在 VS Code 中打开。由于遥测报告的长度，你无法像这样管道输出：code --telemetry | code -。
以下部分详细说明了用于对遥测进行分类的事件元数据、其目的以及任何特殊处理。
事件分类
classification 字段描述了数据的类型。
SystemMetaData- 由 VS Code 生成的不可识别个人身份的值。CallstackOrException- 程序执行失败导致的错误。这些错误包含已清除用户路径的堆栈跟踪。PublicNonPersonalData- 用户生成的可公开获得的数据，例如已发布的扩展 ID。EndUserPseudonymizedInformation- 用于识别唯一用户但无法识别用户身份的哈希值。例如，哈希过的 Mac 地址。
事件目的
purpose 字段描述了收集数据的原因。
PerformanceAndHealth- 确保 VS Code 产品和服务的健康与快速。FeatureInsight- 了解功能使用情况以及何处继续投入开发。BusinessInsight- 做出与 VS Code、Microsoft 和 GitHub 业务相关的决策。
事件终结点
endpoint 字段描述了数据发送到的数据处理器。这通常适用于需要额外清洗和安全措施以保护用户隐私的特殊数据。
GoogleAnalyticsId- 在我们的网站上用于 Google Analytics 和跟踪页面浏览量。这些数据的处理方式比我们通常的数据更敏感。MacAddressHash- 用于识别 VS Code 用户。此值在客户端哈希一次，然后在管道侧再次哈希，以使其无法识别特定用户。在Web 版 VS Code 中，为此情况生成 UUID。none- 数据不需要任何特殊处理。
GDPR 和 VS Code
除了支持《通用数据保护条例》(GDPR) 之外，VS Code 团队非常重视隐私。这既包括 Microsoft 作为一家公司，也特指 VS Code 团队内部。
为了确保符合 GDPR，我们对 VS Code 进行了多项更新，其中包括：
- 通过在产品中为所有现有和新用户放置通知，使其更容易选择退出遥测数据收集。
- 审查和分类我们发送的遥测数据（记录在我们的开源代码库中）。
- 确保对我们收集的任何数据（例如崩溃转储）都有有效的数据保留策略。
简而言之，我们努力为所有用户做正确的事，因为这些实践适用于所有地区，而不仅仅是欧洲。
我们预计人们会问的一个问题是查看我们收集的数据。但是，我们没有可靠的方法来做到这一点，因为 VS Code 没有可以唯一标识用户的“登录”体验。我们确实发送有助于我们近似单个用户以进行诊断的信息（这基于桌面上网络适配器 NIC 的哈希值和网络上随机分配的 UUID），但这不能保证是唯一的。例如，虚拟机 (VM) 通常会轮换 NIC ID 或从池中分配。这种技术足以帮助我们解决问题，但它不足以可靠地“提供你的数据”。
随着我们对 GDPR 和用户期望的深入了解，我们预计我们的方法也会不断发展。我们非常感谢用户发送给我们的数据，因为它非常有价值，并且由于这些数据，VS Code 对每个人来说都是一个更好的产品。再次强调，如果你担心隐私问题，我们提供了禁用遥测发送的功能，具体如禁用遥测报告中所述。
你可以在Visual Studio 系列关于 GDPR 的数据主体请求中找到有关 Visual Studio 系列如何处理 GDPR 的更多信息。
管理在线服务
除了崩溃报告和遥测之外，VS Code 还将在线服务用于各种其他目的，例如下载产品更新、查找、安装和更新扩展、设置同步，或在设置编辑器中提供自然语言搜索。你可以选择开启/关闭使用这些服务的功能。
请注意，关闭这些功能并不会使 VS Code 进入离线模式。例如，如果你在扩展视图中搜索扩展，VS Code 仍然会搜索在线的 VS Code Marketplace。这些设置确保 VS Code 不会在你未请求的情况下与在线服务进行通信。
从文件 > 首选项 > 设置中，键入标签 @tag:usesOnlineServices。这将显示所有控制在线服务使用情况的设置，你可以单独将其开启或关闭。
注意：VS Code 扩展也可能使用在线服务，并且可能不提供配置这些在线服务使用情况的设置，或者它们可能未注册其设置以便在搜索
@tag:usesOnlineServices时显示。请查阅特定扩展的文档，了解其在线服务的使用情况。
VS Code 使用的非 Microsoft 在线服务
内置的VS Code npm 支持扩展会将请求发送到 https://registry.npmjs.org 和 https://registry.bower.io。
内置的TypeScript 和 JavaScript 语言特性扩展会查询 https://registry.npmjs.org 上的 @types 域。
当你使用开发者：切换开发者工具或开发者：打开 Webview 开发者工具时，VS Code 可能会与 Google 服务器通信，以获取启动开发者工具所需的数据。
扩展建议
VS Code 根据你的文件类型、工作区和环境提供扩展建议。文件类型建议是预计算的或动态的。工作区和环境建议始终是预计算的。
如果你想了解为何推荐某个扩展，请打开该扩展的详细信息页面。你可以在页面标题中找到推荐原因。
预计算建议
VS Code 收集有关哪些扩展为哪些文件类型和哪些工作区/文件夹激活的遥测数据。通过计算每个文件夹 Git 远程的哈希值来识别特定文件夹。
我们使用此信息预计算匿名建议。预计算建议是说明在何种条件下应推荐扩展的指令。例如，当我们看到两个扩展 A 和 B 之间存在有趣的关联时，一条指令可能是：如果用户已安装扩展 A 但未安装扩展 B，则推荐扩展 B。
一些预计算建议作为产品的一部分发布，而其他预计算建议则在运行时从 Microsoft 在线服务获取。VS Code 独立评估和执行预计算建议，而不会向任何在线服务发送任何用户信息。
动态建议
当你打开 VS Code 没有预计算建议的文件类型时，它会向扩展市场请求声明支持此文件类型的扩展。如果查询返回了你未安装的扩展，VS Code 将提供通知。
针对扩展作者
请阅读扩展指南遥测文档。
后续步骤
- 集中管理遥测日志级别 - 了解如何为组织设置遥测日志级别。
- Visual Studio Code 常见问题 - 查阅常见问题以了解更多信息。
- 用户和工作区设置 - 阅读有关自定义 VS Code 的可用选项。
- 键盘快捷方式 - 你可以轻松修改常用键盘快捷方式。