CSR配置字典之EnergyMetric类
更新时间:2025/7/22
在Gitcode上查看源码

📋 文档信息

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

📋 变更历史记录

文档变更记录

版本发布日期变更类型变更内容影响范围维护人员
v1.02025-01-27初始版本创建EnergyMetric类配置字典全新文档系统管理员

🎯 类概览

EnergyMetric 类

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

📊 属性定义详表

必选属性

属性名类型默认值取值范围动态关联描述使用场景举例来源分类
SystemPowerU320U32-系统总输入功率,默认0,软件刷新用于告警事件配置144软件刷新软件
SystemOutputPowerU320U32-系统总输出功率,默认0,软件刷新用于告警事件配置144软件刷新软件
HighPowerThresholdWattsDouble0Double-电源功率过高告警阈值
(默认值,软件会进行刷新)
用于告警事件配置300.5软件刷新软件
EnergySavedPercentU85U8-省电百分比配置省电百分比10软件刷新软件
FanTotalPowerWattsU320U32-风扇总功耗配置风扇功耗50硬件硬件

可选属性

属性名类型默认值取值范围动态关联描述使用场景举例来源分类
MinPowerWattsU320U32-服务器功耗下限北向/redfish/v1/Chassis/0CSR软件
MaxPowerWattsU320U32-服务器功耗上限北向/redfish/v1/Chassis/0CSR软件

🔗 动态关联机制

语法规范

使用标准配置语法:

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
  }
}

🔧 使用指南

配置步骤

  1. 功耗监控配置:设置SystemPower和SystemOutputPower监控系统功耗
  2. 告警阈值配置:设置HighPowerThresholdWatts配置功率过高告警
  3. 节能统计配置:设置EnergySavedPercent统计节能效果
  4. 风扇功耗配置:设置FanTotalPowerWatts配置风扇功耗
  5. 功耗范围配置:可选设置MinPowerWatts和MaxPowerWatts

功耗监控机制

  • SystemPower: 系统总输入功率,包括所有输入电源的功耗
  • SystemOutputPower: 系统总输出功率,实际供给负载的功耗
  • 功耗效率: 输出功率与输入功率的比值反映系统效率

告警机制

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

节能统计

  • EnergySavedPercent: 节能百分比,反映节能效果
  • 计算方式: 相对于基准功耗的节能比例
  • 实时更新: 软件实时更新节能统计数据

风扇功耗管理

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

北向接口支持

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

注意事项

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

故障排除

  1. 功耗数据异常

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

    • 检查HighPowerThresholdWatts设置是否合理
    • 确认告警触发逻辑是否正确
    • 验证告警通知机制是否正常
  3. 节能统计异常

    • 检查EnergySavedPercent计算是否正确
    • 确认基准功耗数据是否准确
    • 验证节能算法是否正常

性能优化

  • 数据采集: 优化功耗数据采集频率和精度
  • 告警机制: 优化告警判断和通知机制
  • 节能算法: 优化节能统计和计算算法

📚 相关文档