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

Interface SIG Interface评审
1

背景

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

关联ISSUE

[需求]: 支持MemoryMetrics接口

整体方案

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

评审点

评审点1：

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

1.支持新增属性 BandwidthPercent；

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

评审点2：

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

1.支持新增属性

MemorySummary

详细描述

场景1：URI：/redfish/v1/Systems/{ComputerSystemId}/MemorySummary/MemoryMetrics
变化类型：新增URI
操作类型：GET
应用场景：获取内存整体指标资源信息

详细描述：

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

RspBody响应体示例：

{
  "@odata.context": "/redfish/v1/$metadata#MemoryMetrics.v1_7_3.MemoryMetrics",
  "@odata.id": "redfish/v1/Systems/1/MemorySummary/MemoryMetrics",
  "@odata.type": "#MemoryMetrics.v1_7_3.MemoryMetrics",
  "Name": "Memory Metrics",
  "Id": "Memory Metrics",
  "BandwidthPercent":10
}

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

详细描述：

属性 类型 权限 说明
MemorySummary{ object
Metrics{ object
@odata.id string 只读，读权限：ReadOnly 内存整体指标资源的访问路径
}
}

详细描述

RspBody响应体示例：

    "MemorySummary": {
        "TotalSystemMemoryGiB": 61.99,
        "Status": {
            "Oem": {
                "openUBMC": {
                    "Severity": "Informational"
                }
            },
            "HealthRollup": "OK"
        },
        "Metrics": {
            "@odata.id": "/redfish/v1/Systems/1/MemorySummary/MemoryMetrics"
        }
    },

评审结论

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

详细描述：

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

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

详细描述：

属性 类型 权限 说明
MemorySummary{ object
Metrics{ object
@odata.id string 只读，读权限：ReadOnly 内存整体指标资源的访问路径
}
}

遗留问题

无

2

应用场景应该是获取内存整体指标资源信息

3

应用场景已修改

4

当前已支持/redfish/v1/Systems/:systemid/Memory/:memoryid/MemoryMetrics资源，要明确下：

1、可直接在上诉资源中增加BandwidthPercent属性，可达到类似效果。 – 建议

2、若一定要实现/redfish/v1/Systems/{ComputerSystemId}/MemorySummary/MemoryMetrics资源，则在ComputerSystem资源中要实现MemorySummary属性，并在该属性下实现Metrics属性，连接到此资源。

5

这个URI不一样，已经实现的是指单根内存，这个帖子要加的是内存整体

6

新增资源不能是孤立的，资源连接还是要的

7

/redfish/v1/Systems/:systemid/Memory/:memoryid/MemoryMetrics下实现的是单个的内存带宽利用率，条件不符合 。第二个问题新增的链接已添加

8

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