CSR配置字典之EnergyMetric类
更新时间:2025/7/22
在Gitcode上查看源码📋 文档信息
项目 | 内容 |
---|---|
文档标题 | EnergyMetric类配置字典 |
版本 | v1.0 |
创建日期 | 2025-01-27 |
最后更新 | 2025-01-27 |
维护状态 | ✅ 活跃维护 |
📋 变更历史记录
文档变更记录
版本 | 发布日期 | 变更类型 | 变更内容 | 影响范围 | 维护人员 |
---|---|---|---|---|---|
v1.0 | 2025-01-27 | 初始版本 | 创建EnergyMetric类配置字典 | 全新文档 | 系统管理员 |
🎯 类概览
EnergyMetric 类
属性 | 值 |
---|---|
类名称 | EnergyMetric |
功能描述 | 整机功耗信息统计对象,提供系统功耗、风扇功耗、省电百分比等能耗指标的统计和监控 |
所属SIG组 | power |
所属组件 | 能耗统计 |
责任人 | 电源管理组 |
最后更新 | 2025-01-27 |
状态 | 🟢 正常运行 |
📊 属性定义详表
必选属性
属性名 | 类型 | 默认值 | 取值范围 | 动态关联 | 描述 | 使用场景 | 举例 | 来源 | 分类 |
---|---|---|---|---|---|---|---|---|---|
SystemPower | U32 | 0 | U32 | - | 系统总输入功率,默认0,软件刷新 | 用于告警事件配置 | 144 | 软件刷新 | 软件 |
SystemOutputPower | U32 | 0 | U32 | - | 系统总输出功率,默认0,软件刷新 | 用于告警事件配置 | 144 | 软件刷新 | 软件 |
HighPowerThresholdWatts | Double | 0 | Double | - | 电源功率过高告警阈值 (默认值,软件会进行刷新) | 用于告警事件配置 | 300.5 | 软件刷新 | 软件 |
EnergySavedPercent | U8 | 5 | U8 | - | 省电百分比 | 配置省电百分比 | 10 | 软件刷新 | 软件 |
FanTotalPowerWatts | U32 | 0 | U32 | - | 风扇总功耗 | 配置风扇功耗 | 50 | 硬件 | 硬件 |
可选属性
属性名 | 类型 | 默认值 | 取值范围 | 动态关联 | 描述 | 使用场景 | 举例 | 来源 | 分类 |
---|---|---|---|---|---|---|---|---|---|
MinPowerWatts | U32 | 0 | U32 | - | 服务器功耗下限 | 北向/redfish/v1/Chassis/ | 0 | CSR | 软件 |
MaxPowerWatts | U32 | 0 | U32 | - | 服务器功耗上限 | 北向/redfish/v1/Chassis/ | 0 | CSR | 软件 |
🔗 动态关联机制
语法规范
使用标准配置语法:
yaml
# 系统功耗配置
SystemPower: 144
SystemOutputPower: 144
HighPowerThresholdWatts: 300.5
# 节能配置
EnergySavedPercent: 10
# 风扇功耗配置
FanTotalPowerWatts: 50
# 功耗范围配置(可选)
MinPowerWatts: 0
MaxPowerWatts: 0
关联说明
- 功耗监控: SystemPower和SystemOutputPower用于系统功耗监控
- 告警配置: HighPowerThresholdWatts用于功率过高告警
- 节能统计: EnergySavedPercent用于节能效果统计
- 风扇功耗: FanTotalPowerWatts用于风扇功耗统计
📂 分类标准
硬件属性
- 定义:与硬件功耗直接相关的参数
- 特点:风扇功耗等物理功耗信息
- 示例:
FanTotalPowerWatts
软件属性
- 定义:由软件统计和管理的功耗参数
- 特点:系统功耗、告警阈值、节能统计等
- 示例:
SystemPower
,SystemOutputPower
,HighPowerThresholdWatts
,EnergySavedPercent
,MinPowerWatts
,MaxPowerWatts
📝 配置示例
基础能耗统计配置
json
{
"EnergyMetric_Basic": {
"SystemPower": 144,
"SystemOutputPower": 144,
"HighPowerThresholdWatts": 300.5,
"EnergySavedPercent": 10,
"FanTotalPowerWatts": 50
}
}
完整能耗统计配置
json
{
"EnergyMetric_Full": {
"SystemPower": 144,
"SystemOutputPower": 144,
"HighPowerThresholdWatts": 300.5,
"EnergySavedPercent": 10,
"FanTotalPowerWatts": 50,
"MinPowerWatts": 100,
"MaxPowerWatts": 1000
}
}
高功耗服务器配置
json
{
"EnergyMetric_HighPower": {
"SystemPower": 800,
"SystemOutputPower": 750,
"HighPowerThresholdWatts": 1000.0,
"EnergySavedPercent": 5,
"FanTotalPowerWatts": 120,
"MinPowerWatts": 200,
"MaxPowerWatts": 1200
}
}
节能优化配置
json
{
"EnergyMetric_EnergySaving": {
"SystemPower": 200,
"SystemOutputPower": 180,
"HighPowerThresholdWatts": 400.0,
"EnergySavedPercent": 25,
"FanTotalPowerWatts": 30,
"MinPowerWatts": 50,
"MaxPowerWatts": 500
}
}
🔧 使用指南
配置步骤
- 功耗监控配置:设置SystemPower和SystemOutputPower监控系统功耗
- 告警阈值配置:设置HighPowerThresholdWatts配置功率过高告警
- 节能统计配置:设置EnergySavedPercent统计节能效果
- 风扇功耗配置:设置FanTotalPowerWatts配置风扇功耗
- 功耗范围配置:可选设置MinPowerWatts和MaxPowerWatts
功耗监控机制
- SystemPower: 系统总输入功率,包括所有输入电源的功耗
- SystemOutputPower: 系统总输出功率,实际供给负载的功耗
- 功耗效率: 输出功率与输入功率的比值反映系统效率
告警机制
- HighPowerThresholdWatts: 功率过高告警阈值
- 告警触发: 当系统功耗超过阈值时触发告警
- 动态调整: 软件可以动态调整告警阈值
节能统计
- EnergySavedPercent: 节能百分比,反映节能效果
- 计算方式: 相对于基准功耗的节能比例
- 实时更新: 软件实时更新节能统计数据
风扇功耗管理
- FanTotalPowerWatts: 所有风扇的总功耗
- 功耗统计: 用于整机功耗统计和分析
- 调速优化: 根据风扇功耗优化调速策略
北向接口支持
- Redfish接口: MinPowerWatts和MaxPowerWatts用于Redfish接口
- 功耗范围: 提供服务器功耗的上下限信息
- 标准兼容: 符合Redfish标准的功耗管理接口
注意事项
- 数据准确性: 确保功耗数据的准确性和实时性
- 告警配置: 合理设置告警阈值,避免误报
- 节能统计: 确保节能统计的准确性和可靠性
- 功耗范围: MinPowerWatts和MaxPowerWatts应该合理设置
故障排除
功耗数据异常:
- 检查功耗传感器是否正常工作
- 确认软件刷新机制是否正常
- 验证功耗计算逻辑是否正确
告警异常:
- 检查HighPowerThresholdWatts设置是否合理
- 确认告警触发逻辑是否正确
- 验证告警通知机制是否正常
节能统计异常:
- 检查EnergySavedPercent计算是否正确
- 确认基准功耗数据是否准确
- 验证节能算法是否正常
性能优化
- 数据采集: 优化功耗数据采集频率和精度
- 告警机制: 优化告警判断和通知机制
- 节能算法: 优化节能统计和计算算法