HiRetrieval云端功能说明
简介
应用灰度采集功能的完整实现依赖于云端平台的协同支持。云端平台同时面向应用开发者提供交互能力,支持开发者创建灰度任务、查看采集的日志文件及相关信息。系统涉及端云信息交互、云端解析端侧上传数据并进行可视化呈现、以及云端平台创建灰度任务及设备圈选等功能。
云端需实现功能简述
云端平台需实现以下核心功能:
- 对应用开发者进行鉴权。
- 支持应用开发者通过简洁的交互操作创建灰度任务,执行圈选算法以筛选符合条件的设备,并向这些设备下发任务;同时支持开发者对已创建的任务进行管理。
- 与端侧应用灰度采集模块进行信息交互。
- 将采集到的故障日志向应用开发者进行呈现。
对应用开发者鉴权
云端平台需确保应用A的开发者仅能为应用A创建灰度任务,且仅能查看应用A所采集的故障日志。应禁止应用A的开发者对应用B创建任务或查看其日志。
与应用开发者交互
云端平台应提供创建灰度任务的页面。页面中应允许开发者选择灰度任务的有效时间段及故障类型。
在开发者选定必要信息后,云端后台的圈选算法将计算得出参与该任务的设备列表,并在这些设备与服务器建立连接时向其下发灰度任务。
云端平台还应提供任务管理页面,供开发者查看已创建的任务,包括查阅任务激活期间采集的故障日志,以及任务结束后各设备的任务报告汇总。
与端侧应用灰度采集模块的信息交互
端侧与云端需建立合理的信息交互机制,以保证应用灰度采集功能的正确运行。通常可采用HTTP、WebSocket等传统通信协议。端侧的应用灰度采集模块将尝试连接云端服务器,并完成信息交互。
需实现的信息交互功能包括:
- 设备参与状态变更:指具体设备是否愿意参与应用灰度采集活动。由于灰度采集故障日志会导致设备性能下降,必须允许设备用户自主选择是否参与。云端在圈选设备时,仅会将明确参与的设备纳入候选列表。端侧需将此状态变更消息传递至云端服务器。
- 灰度任务:考虑到故障日志采集的性能开销,应用灰度采集功能应以任务粒度运行,即在特定时段针对特定故障类型开启采集。例如,云端可要求某台设备在今日 8:00 至 10:00 期间对某类资源泄漏故障开启日志采集。灰度任务通常由云端服务器下发,端侧应用灰度采集模块负责接收。
- 故障日志:在灰度任务激活期间采集到的故障日志,需打包上传至云端服务器。开发者可通过云端平台查阅已上传的故障日志,以便定位并修复问题。
- 任务报告:当灰度任务结束时,端侧将该任务激活期间发生的事件及相关统计信息汇总为任务报告,并上传至云端服务器。任务报告可包含:任务期间发生的故障数量、成功采集故障日志的次数、采集失败的错误码等内容。
将采集到的故障日志呈现给应用开发者
端侧采集的各类故障日志将上传至云端,云端平台需以适当的形式向开发者呈现这些日志,辅助其定位问题。常见实现方式包括:
- 提供页面供开发者下载故障日志。
- 提供页面供开发者查看故障日志的分析结果。此方式通常适用于具备故障智能分析能力的云端平台。
本文来自 OpenHarmony 文档贡献者,按 CC BY 4.0 整理版式与相对链接,保留正文与代码。图示请参阅原文。作者与贡献记录。
