大网数据广告活动
OpenHarmony 设备与应用开发

应用灰度采集介绍

· 52CE 我爱测

从版本26.0.0开始,系统支持应用灰度采集功能,本功能在运维态使用,用于采集故障日志。功能需端云配合,应用开发者在端侧应用中集成此功能后,在云端平台(OS开发者参考HiRetrieval云端功能说明自行提供适配)完成注册认证等操作后,可以在云端启用具体故障类别的灰度任务。

应用灰度采集介绍

简介

从版本26.0.0开始,系统支持应用灰度采集功能,本功能在运维态使用,用于采集故障日志。功能需端云配合,应用开发者在端侧应用中集成此功能后,在云端平台(OS开发者参考HiRetrieval云端功能说明自行提供适配)完成注册认证等操作后,可以在云端启用具体故障类别的灰度任务。

云端平台根据任务类别,采用特定算法在所有参与灰度活动的设备中,圈选出一部分设备执行灰度任务。

当被圈选的设备发生对应故障后,系统可以精准采集故障日志并上报到云端平台,供开发者查阅,方便开发者解决问题。

说明:

此功能会在采集故障日志时降低性能表现并增加功耗。

基本概念

灰度采集:云端平台在创建灰度任务时,选取部分设备打开故障日志的采集和上传。这些日志通常包括重载日志,采集和上传有额外的开销,不适宜在所有设备上开启,通过选取少量设备开启的方式实现故障定位和性能功耗的折中。在Performance Analysis Kit的上下文中,有时也简称灰度。

灰度任务:灰度任务是灰度采集的单次实现载体。一次灰度任务规定了在特定的时间段内,针对特定故障类型,在某些被选取设备上开启故障日志采集和上传。灰度任务的发布需要开发者在云端平台进行操作,经过圈选算法后选中部分设备执行。开发者可以在云端查看某次任务的状态,所采集到的故障日志等信息,辅助故障定位。

实现原理

整体架构

[图示请参阅官方原文]

集成步骤

  1. 应用开发者在云端平台注册账户,并通过应用开发者的认证。
  2. 应用开发者在端侧的应用开发中集成应用灰度能力,并做适当的初始化使得应用能力功能开始运行。
  3. 应用开发者在云端平台登录账号以后,在平台发起灰度任务。通过填写任务时间,故障类型等信息,执行圈选算法,最终圈定参与此次任务的设备。随后任务会从云端下发到这些设备。
  4. 上述圈选设备在收到任务以后,在任务激活时间内如果该应用处于运行状态,并且发生了对应的故障,设备会抓取各项故障日志(包括一些正常商用版本不会采集的重载日志)并上传到云端。在任务结束时,还会发送一份任务报告至云端。
  5. 应用开发者可以在云端平台查看和下载上报的故障日志和任务报告,也可以查看平台智能分析的故障根因,以更好的分析定位问题。

约束与限制

应用隐私声明中需要包含个人数据处理说明。

本文来自 OpenHarmony 文档贡献者,按 CC BY 4.0 整理版式与相对链接,保留正文与代码。图示请参阅原文。作者与贡献记录。

资料来源与适用范围

资料来源
OpenHarmony 文档贡献者
适用范围
master 文档快照(2026-11-16)
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-16
授权说明
CC BY 4.0

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

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