【已评审】新增标准资源ProcessorMetrics

Interface SIG Interface评审
1

背景

当前redfish标准接口存在缺失，需要评审新增redfish标准接口

关联ISSUE

[需求]: 支持ProcessorMetrics接口

整体方案

1.基于资源协作接口属性补齐redfish接口ProcessorMetrics资源

评审点

评审点1：

URI：/redfish/v1/Systems/{ComputerSystemId}/ProcessorSummary/ProcessorMetrics

1.支持新增属性 BandwidthPercent；

2.支持新增属性 @odata.context、@odata.id、@odata.type、Name、Id；

评审点2：

URI：/redfish/v1/Systems/{ComputerSystemId}

1.支持新增属性

ProcessorSummary

详细描述

场景一：URI：/redfish/v1/Systems/{ComputerSystemId}/ProcessorSummary/ProcessorMetrics
变化类型：新增URI
操作类型：GET
应用场景：获取处理器整体指标资源信息

详细描述：

一级属性 类型 取值范围 权限 说明
BandwidthPercent integer 0-100 ReadOnly 所有处理器的CPU利用率
Name string ReadOnly 处理器整体指标资源名称
Id string ReadOnly 处理器整体指标资源ID
@odata.id string ReadOnly 处理器整体指标资源的访问路径
@odata.type string ReadOnly 处理器整体指标资源的类型
@odata.context string ReadOnly 处理器整体指标资源的OData描述信息

RspBody响应体示例：

  {
   "@odata.context": "/redfish/v1/$metadata#ProcessorMetrics.v1_6_4.ProcessorMetrics",
   "@odata.id": "redfish/v1/Systems/1/ProcessorSummary/ProcessorMetrics",
   "@odata.type": "#ProcessorMetrics.v1_6_4.ProcessorMetrics",
   "Name": "Processor Metrics",
   "Id": "Processor Metrics",
   "BandwidthPercent":1
}

场景2：URI：/redfish/v1/Systems/{ComputerSystemId}
变化类型：新增属性
操作类型：GET
应用场景：链接新建资源

详细描述：

属性 类型 权限 说明
ProcessorSummary{
Metrics{
@odata.id string ReadOnly 链接处理器整体指标资源的访问路径
}
}

RspBody响应体示例：

   "ProcessorSummary": {
        "Count": 2,
        "Model": "Kunpeng 920 5250Z",
        "Status": {
            "Oem": {
                "openUBMC": {
                    "Severity": "Informational"
                }
            },
            "HealthRollup": "OK"
        },
        "Metrics": {
            "@odata.id": "/redfish/v1/Systems/1/ProcessorSummary/ProcessorMetrics"
        }
    },

评审结论

1、同意新增标准资源ProcessorMetrics及属性，具体如下：
URI：/redfish/v1/Systems/{ComputerSystemId}/ProcessorSummary/ProcessorMetrics
变化类型：新增URI
操作类型：GET
应用场景：获取处理器整体指标资源信息
属性：@odata.context、@odata.id、@odata.type、Name、Id、BandwidthPercent

属性 类型 取值范围 权限 说明
BandwidthPercent integer 0-100 ReadOnly 所有处理器的CPU利用率
Name string ReadOnly 处理器整体指标资源名称
Id string ReadOnly 处理器整体指标资源ID
@odata.id string ReadOnly 处理器整体指标资源的访问路径
@odata.type string ReadOnly 处理器整体指标资源的类型
@odata.context string ReadOnly 处理器整体指标资源的OData描述信息

2、同意ComputerSystem资源新增标准属性Metrics，链接处理器整体指标资源， 具体如下：
URI：/redfish/v1/Systems/{ComputerSystemId}
变化类型：新增属性
操作类型：GET
应用场景：链接下层资源

一级属性 类型 权限 说明
ProcessorSummary{ object
Metrics{ object
@odata.id string ReadOnly 链接处理器整体指标资源的访问路径
}
}

遗留问题

无

2

1、BandwidthPercent类型是数字，示例有问题
2、应用场景应该是获取处理器整体指标资源信息

3

示例上传时出现了点问题 postman是int 示例已经修改

image
image553×236 25.6 KB

应用场景已修改

4

/redfish/v1/Systems/{ComputerSystemId}/ProcessorSummary/ProcessorMetrics，实现此资源：

1、system资源的ProcessorSummary属性下，要实现Metrics属性，该属性链接到此资源。

5

已添加属性链接该资源

6

内容没问题了，格式可以参考这个议题： 【已评审】支持redfish标准资源（处理器度量数据、内存度量数据、PCIe设备）新增属性

7

标题改成【已评审】并补充结论