在Vega工具中管理遥测
在Vega工具中管理遥测
开放Beta测试文档 作为预发布开放Beta测试的一项内容，亚马逊提供了此技术文档。随着亚马逊收到反馈并对功能进行迭代，所描述的这些功能可能会发生变化。有关最新功能的信息，请参阅发行说明。
亚马逊收集遥测数据，以提高Vega SDK开发者工具的性能、可靠性和可用性。使用数据可帮助亚马逊识别问题，确定改进的优先顺序，并提供更好的开发者体验。默认情况下，Vega SDK及其附带的工具会收集遥测数据。这包括命令使用情况、系统信息（例如操作系统和架构）和运行时错误。
“遥测”不是匿名的，因为它可能包含可用于识别您的永久标识符和应用的项目级标识符（例如app_id）。您可以按照如何选择退出遥测数据收集中所述随时选择退出。如果遥测仍处于启用状态，则无需额外提示即可在后台收集数据。有关收集的遥测数据的完整列表，请参阅从Vega SDK收集的遥测数据类型。
有关亚马逊如何使用个人信息的更多信息，请参阅亚马逊的隐私声明（仅提供英文版）。
从Vega SDK收集的遥测类型
在Vega SDK中打包的所有工具中收集了以下遥测属性：
| 属性 | 描述 |
|---|---|
| component_name | SDK工具的名称 |
| sdk_version | Vega SDK的版本 |
| component_version | 组件工具的版本 |
| metric_type | 所收集数据的类型或类别 |
| operation_name | 主操作的名称 |
| suboperation_name | 特定操作的名称 |
| metric_value | 收集的数据的价值 |
| architecture | 您的环境的CPU架构 |
| os_name | 操作系统的名称 |
| os_codename | 操作系统的代号 |
| os_version_number | 操作系统的版本号 |
| cpu_name | CPU的名称 |
| instance_id | 工具实例的唯一标识符 |
| directed_id | 您的客户ID的加密标识符 |
| machine_id | 计算机的哈希标识符 |
如何选择退出遥测数据收集
安装Vega SDK后，可以使用以下选项之一禁用遥测数据收集：
选项1： 通过修改config文件选择退出：
- 打开文件
{$KEPLER_SDK_PATH}/state/kepler-telemetry/config.json。 -
将
optIn键设置为false：{ "optIn": false }
选项2： 通过Vega Studio选择退出
您还可以通过Vega Studio禁用遥测数据收集。Vega Studio会同步config文件中的optIn标记：
- 在VS Code中，前往Code > 首选项 > 设置。
- 切换到用户子选项卡。
- 在搜索设置栏中，输入Kepler: Telemetry。
- 在Telemetry: Telemetry Level（遥测：遥测级别）面板，从下拉列表中选择Off（关闭）。
特定于工具的遥测数据收集
选择一个选项卡以查看每个工具收集的数据。
从Vega Studio收集的其他数据
| 属性 | 描述 |
|---|---|
| device_architecture | 设备架构（例如： ARM或x86） |
| device_build_version | 设备上安装的构建版本 |
| device_family | 设备的系列名称 |
| device_in_developer_mode | 表示设备是否处于开发者模式 |
| device_type | 操作所针对的设备类型 |
| error_message | 描述遇到的错误的主要消息 |
| error_name | 遇到的错误的名称或分类 |
| notification_message | 向用户显示的通知文本 |
| package_id | 分配给您的应用程序包的唯一标识符 |
| project_type | 正在构建或运行的项目类型 |
| stack_trace | 导致错误的方法调用顺序 |
| template_name | 在项目中使用的模板名称 |
注意： 您也可以选择不再使用Microsoft的VS Code遥测数据。有关说明，请参阅VS Code遥测文档（仅提供英文版）。
从Vega CLI收集的其他数据
| 属性 | 描述 |
|---|---|
| build_targets | Vega CLI构建的构建目标配置 |
| clean_build | 指明构建是否使用缓存的工件 |
| cli_variant | 正在使用的Vega CLI的类型 |
| cli_version | Vega CLI的版本号 |
| incremental_autolink | 指定构建是否为增量自动链接 |
| install_component | 通过引导程序安装的组件 |
| ntc_artifact_size | 构建工件的大小 |
| ntc_build_time | 构建工件的时间 |
| ntc_matching_file_count | 构建中生成的文件数量 |
| package_id | 应用程序包的唯一标识符 |
| package_type | 在设备上运行的程序包类型（例如：.vpkg） |
| project_type | 正在创建或管理的项目类型 |
| request_id | Vega CLI请求的唯一标识符 |
| session_id | 您的活动Vega CLI会话的唯一标识符 |
| target_device | 作为目标的设备类型（Vega虚拟设备或Fire TV Stick） |
| template | 项目的模板名称 |
从Vega性能收集的其他数据
| 属性 | 描述 |
|---|---|
| app_type | 正在使用的应用类型。 |
| device_architecture | 设备架构（例如： ARM或x86） |
| device_build_version | 设备上安装的构建版本 |
| device_family | 设备的系列名称 |
| device_in_developer_mode | 表示设备是否处于开发者模式 |
| device_type | 目标设备的类型（例如： Vega虚拟设备或Fire TV Stick） |
| device_type_id | 代表特定设备型号类型的唯一标识符 |
| error_stack | 导致错误的方法调用顺序 |
| vs_code_version | Visual Studio Code的版本号 |
| profile | 配置文件的名称 |
| kepler_sdk_version | Vega SDK的版本。 |
| launch_type | 用于启动该工具的方法（CLI或VS Code） |
| return_value | 操作返回的结果 |
| duration | 完成操作所需的时间 |
| app_id | 应用的唯一标识符 |
从Vega虚拟设备收集的其他数据
| 属性 | 描述 |
|---|---|
| image_type | 指定设备映像适用于汽车还是电视 |
从Appium Vega驱动程序收集的其他数据
| 属性 | 描述 |
|---|---|
| error_code | 测试期间生成的错误代码 |
| log | 测试期间捕获的日志消息 |
从Vega ESLint插件收集的其他数据
| 属性 | 描述 |
|---|---|
| rule_id | lint规则的标识符 |
| message_id | lint消息的标识符 |
| message | lint消息文本 |
| lint_session_id | lint会话的唯一标识符 |
| severity | lint问题的严重性级别 |
| suppressions | lint抑制的清单及其理由 |
| machine_id | 计算机的标识符 |
| app_id | 应用的唯一标识符 |
相关主题
Last updated: 2025年10月13日
