ISSUE链接(必填,此议题关联的issue):
https://gitcode.com/openUBMC/mdb_interface/issues/17
背景(必填,文字描述议题背景,如需求来源、问题场景):
支持带外收集NPU带内device关键运行日志,新增4种日志类型。
目前npu日志收集RPC方法默认收集黑匣子类别的6种日志,需要扩展支持收集设备运行类别的4种新的日志。
为了兼容之前的北向接口配置,不修改之前的RPC方法,新增RPC方法适配新的北向接口。
决策点(必填,一句话描述待决策点):
新增RPC方法DumpLog,处理新增的日志收集的北向接口。
对应资源path是/bmc/kepler/Systems/:SystemId/Processors/NPU/:ID,对应资源interface是bmc.kepler.Systems.Processor.NPU。
详细描述(必填,描述待评审接口的详细内容):
资源path: /bmc/kepler/Systems/:SystemId/Processors/NPU/:ID
资源interface: bmc.kepler.Systems.Processor.NPU
变化类型:新增方法
应用场景:web或redfish接口触发npu运行日志收集
持久化类型: 不持久化
操作权限:DiagnoseMgmt
详细描述:
| 方法名称 | 变化类型 | 签名 | 读写&权限 | 持久化 | 变化通知 | 接口说明 | 接口约束 |
|---|---|---|---|---|---|---|---|
| DumpLog | 新增方法 | 请求:ass 响应:u |
DiagnoseMgmt | NA | NA | 请求: LogType:日志类型,字符串数组类型。 OutputFilePath:导出文件路径,字符串类型。 响应: TaskId:任务ID,数字类型U32。 |
请求: LogType:日志类型,支持的日志类型包括Blackbox、Device。 OutputFilePath:操作路径 1、本地导出:“/tmp/文件路径” 2、远程导出:“文件传输协议://用户名:密码@ip地址/目录/文件名” 文件传输协议包括五种:sftp、https、nfs、cifs、scp。 响应: TaskId:任务ID。 |
LogType参数说明:
| 取值 | 说明 |
|---|---|
| Blackbox | 表示黑匣子日志,含有6种日志 |
| Device | 表示设备关键运行日志,含有4种日志 |
评审结论
1、同意新增RPC方法DumpLog:
- 资源树路径:
/bmc/kepler/Systems/:SystemId/Processors/NPU/:ID - 资源树接口:
bmc.kepler.Systems.Processor.NPU - 操作权限:DiagnoseMgmt
- 请求签名:ass
- 请求参数:LogType, OutputFilePath
- 响应签名:u
- 响应参数:TaskId