背景
NetworkAdapter组件部分功能可测试性能力不足，提升组件的可测试性。例如：光模块的电流电压等数据极值，60分钟才会记录一条数据，影响测试效率
关联ISSUE
暂无
整体方案
新增可测试性方法，修改相关配置，提高组件可测试性
评审点
支持光模块极值采样周期设置，提升测试效率，新增可测试性资源协作接口
详细描述
方案一
资源path：/bmc/kepler/Debug/Systems/${SystemId}/NetworkAdaptersDebug
资源interface：bmc.kepler.Debug.Systems.NetworkAdapters
变化类型：新增方法 SetConfigurations、GetConfigurations
应用场景：调试接口，查询、设置组件的可测试性配置
持久化类型：不涉及
操作权限：BasicSetting
| 方法名称 | 变化类型 | 签名 | 参数说明 | 读写&权限 | 持久化 | 变化通知 | 接口说明 | 接口约束 |
|---|---|---|---|---|---|---|---|---|
| SetConfigurations | 新增方法 | 请求：ss 响应：无 | 请求：s ：CfgType 配置类型 s：CfgValue 配置信息 响应： 无 | BasicSetting | 不涉及 | 不涉及 | 调试命令：设置组件可测试性配置信息 CfgType: 取值OpticalModuleExtremeValueSampleIntervalSeconds (光模块极值采样周期 ) CfgValue:“10000” | 调试接口 |
| GetConfigurations | 新增方法 | 请求：s 响应：s | 请求：s ：CfgType 配置类型 响应： s：CfgValue 配置信息 | ReadOnly | 不涉及 | 不涉及 | 调试命令：查询组件可测试性配置信息 CfgType: 取值OpticalModuleExtremeValueSampleIntervalSeconds (光模块极值采样周期 ) CfgValue:“10000” | 调试接口 |
方案二
资源path：/bmc/kepler/Debug/Systems/${SystemId}/NetworkAdaptersDebug
资源interface：bmc.kepler.Debug.Systems.OpticalModules
变化类型：新增interface 新增方法方法 SetExtremeValueSampleIntervalSeconds、GetExtremeValueSampleIntervalSeconds
应用场景：调试接口，查询、设置光模块极值采样周期
持久化类型：不涉及
操作权限：BasicSetting
| 方法名称 | 变化类型 | 签名 | 参数说明 | 读写&权限 | 持久化 | 变化通知 | 接口说明 | 接口约束 |
|---|---|---|---|---|---|---|---|---|
| SetExtremeValueSampleIntervalSeconds | 新增方法 | 请求：q 响应：无 | 请求： Period：采样周期，单位秒 响应： 无 | BasicSetting | 不涉及 | 不涉及 | 调试命令：设置光模块极值采样周期 | 调试接口 |
| GetExtremeValueSampleIntervalSeconds | 新增方法 | 请求：无 响应：q | 请求： 无 响应： Period：采样周期，单位秒 | ReadOnly | 不涉及 | 不涉及 | 调试命令：查询光模块极值采样周期 | 调试接口 |
方案三
资源path：/bmc/kepler/Debug/Systems/${SystemId}/NetworkAdaptersDebug
新增资源interface：bmc.kepler.Debug.Systems.OpticalModules
变化类型：新增资源interface 新增方法 SetConfigurations、GetConfigurations
应用场景：调试接口，查询、设置光模块的配置信息
持久化类型：不涉及
操作权限：BasicSetting
| 方法名称 | 变化类型 | 签名 | 参数说明 | 读写&权限 | 持久化 | 变化通知 | 接口说明 | 接口约束 |
|---|---|---|---|---|---|---|---|---|
| SetConfigurations | 新增方法 | 请求：ss 响应：无 | 请求：s ：CfgType 配置类型 s：CfgValue 配置信息 响应： 无 | BasicSetting | 不涉及 | 不涉及 | 调试命令：设置组件可测试性配置信息 CfgType: 取值OpticalModuleExtremeValueSampleIntervalSeconds (光模块极值采样周期 ) CfgValue:“10000” | 调试接口 |
| GetConfigurations | 新增方法 | 请求：s 响应：s | 请求：s ：CfgType 配置类型 响应： s：CfgValue 配置信息 | ReadOnly | 不涉及 | 不涉及 | 调试命令：查询组件可测试性配置信息 CfgType: 取值OpticalModuleExtremeValueSampleIntervalSeconds (光模块极值采样周期 ) CfgValue:“10000” | 调试接口 |
评审结论
同意新增资源协作接口 bmc.kepler.Debug.Systems.OpticalModules 并新增属性用于集成测试场景下控制光模块机制日志记录周期，具体如下：
path: /bmc/kepler/Debug/Systems/${SystemId}/NetworkAdaptersDebug
变化类型：新增interface、新增属性
新增interface: bmc.kepler.Debug.Systems.OpticalModules
新增属性：
| 属性名称 | 变化类型 | 签名 | 默认值 | 取值范围 | 读写权限 | 持久化 | 变化通知 | 接口说明 |
|---|---|---|---|---|---|---|---|---|
| ExtremeValueLogIntervalSeconds | 新增属性 | q | 3600 | 15~3600 | 读写，读：ReadOnly 写：BasicSetting | 否 | 否 | 光模块极值日志记录周期 |
遗留问题
1.是否考虑做到业务功能，支持可配置
结论：当前无诉求，仅用来调试使用，提升可测试性
2.明确属性在设置时是否应该有范围限制
结论：采样周期固定为15s，日志记录周期默认为3600s，因此取值范围是15~3600