【已评审】npu日志收集新增RPC方法

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

变更的必要性要以及变更兼容性的处理策略阐述清楚