文档中心
CSR配置字典之EnergyMetric类
更新时间： 2025/07/22
在Gitcode上查看源码

📋 文档信息 ​

项目内容
文档标题EnergyMetric类配置字典
版本v1.1
创建日期2025-01-27
最后更新2026-05-12
维护状态✅ 活跃维护

📋 变更历史记录 ​

文档变更记录 ​

版本发布日期变更类型变更内容影响范围维护人员
v1.02025-01-27初始版本创建EnergyMetric类配置字典全新文档系统管理员
v1.12026-05-12补丁版本修改类概览描述信息类概览描述信息汪航

🎯 类概览 ​

EnergyMetric 类 ​

属性值
类名称EnergyMetric
功能描述整机功耗信息统计对象，提供系统功耗、风扇功耗、省电百分比等能耗指标的统计和监控
所属SIG组hardware
所属组件power_strategy
责任人能效管理组
最后更新2026-05-12
状态🟢 正常运行

📊 属性定义详表 ​

必选属性 ​

属性名类型默认值取值范围动态关联描述使用场景举例来源分类
SystemPowerU320U32-系统总输入功率，默认0，软件刷新用于告警事件配置144软件刷新软件
SystemOutputPowerU320U32-系统总输出功率，默认0，软件刷新用于告警事件配置144软件刷新软件
HighPowerThresholdWattsDouble0Double-系统功率过高告警阈值
（默认值，软件会进行刷新）		用于告警事件配置300.5软件刷新软件
FanTotalPowerWattsU320U32"<=Scanner_Fan_Pwr.Value"风扇总功耗配置风扇功耗详见动态关联CSR配置硬件

可选属性 ​

属性名类型默认值取值范围动态关联描述使用场景举例来源分类
MinPowerWattsU320U32-服务器功耗下限北向/redfish/v1/Chassis/{ChassisId}0CSR软件
MaxPowerWattsU320U32-服务器功耗上限北向/redfish/v1/Chassis/{ChassisId}0CSR软件
MaxEDPWattsU320U32-当前整机最大EDP值过滤超出EDP的功率值，避免电源拔插场景整机功耗出现异常值18800软件软件

🔗 动态关联机制 ​

语法规范 ​

使用基础语法以及 <=/xxx 和表达式语法实现动态关联：

yaml
# 系统功耗配置
SystemPower: 0
SystemOutputPower: 0
HighPowerThresholdWatts: 65535

# 风扇功耗配置
FanTotalPowerWatts: "<=Scanner_Fan_Pwr.Value"

# 功耗范围配置（可选）
MinPowerWatts: 0
MaxPowerWatts: 0
MaxEDPWatts: 18800

关联说明 ​

  • 功耗监控: SystemPower和SystemOutputPower用于系统功耗监控
  • 告警配置: HighPowerThresholdWatts用于功率过高告警
  • 风扇功耗: FanTotalPowerWatts用于风扇功耗统计

📂 分类标准 ​

硬件属性 ​

  • 定义：与硬件功耗直接相关的参数
  • 特点：风扇功耗等物理功耗信息
  • 示例：FanTotalPowerWatts

软件属性 ​

  • 定义：由软件统计和管理的功耗参数
  • 特点：系统功耗、告警阈值、节能统计等
  • 示例：SystemPower, SystemOutputPower, HighPowerThresholdWatts, MinPowerWatts, MaxPowerWatts, MaxEDPWatts

📝 配置示例 ​

基础能耗统计配置 ​

json
{
  "EnergyMetric_Basic": {
    "SystemPower": 0,
    "SystemOutputPower": 0,
    "HighPowerThresholdWatts": 65535,
    "FanTotalPowerWatts": "<=Scanner_Fan_Pwr.Value",
    "MinPowerWatts": 100,
    "MaxPowerWatts": 10000,
    "MaxEDPWatts": 13500
  }
}

🔧 使用指南 ​

配置步骤 ​

  1. 功耗监控配置：设置SystemPower和SystemOutputPower监控系统功耗
  2. 告警阈值配置：设置HighPowerThresholdWatts配置功率过高告警
  3. 风扇功耗配置：设置FanTotalPowerWatts配置风扇功耗
  4. 功耗范围配置：可选设置MinPowerWatts、MaxPowerWatts和MaxEDPWatts

功耗监控机制 ​

  • SystemPower: 系统总输入功率，包括所有输入电源的功耗
  • SystemOutputPower: 系统总输出功率，实际供给负载的功耗

告警机制 ​

  • HighPowerThresholdWatts: 功率过高告警阈值
  • 告警触发: 当系统功耗超过阈值时触发告警
  • 动态调整: 软件可以动态调整告警阈值

风扇功耗管理 ​

  • FanTotalPowerWatts: 所有风扇的总功耗
  • 功耗统计: 用于整机功耗统计和分析
  • 调速优化: 根据风扇功耗优化调速策略

北向接口支持 ​

  • Redfish接口: MinPowerWatts和MaxPowerWatts用于Redfish接口
  • 功耗范围: 提供服务器功耗的上下限信息
  • 标准兼容: 符合Redfish标准的功耗管理接口

注意事项 ​

  • 数据准确性: 确保功耗数据的准确性和实时性
  • 告警配置: 合理设置告警阈值，避免误报
  • 功耗范围: MinPowerWatts和MaxPowerWatts应该合理设置

故障排除 ​

  1. 功耗数据异常：

    • 检查功耗传感器是否正常工作
    • 确认软件刷新机制是否正常
    • 验证功耗计算逻辑是否正确

  2. 告警异常：

    • 检查HighPowerThresholdWatts设置是否合理
    • 确认告警触发逻辑是否正确
    • 验证告警通知机制是否正常
上一篇Pmu
下一篇MPCConfig