CSR配置字典之Triggers类 ​

📋 文档信息 ​

📋 变更历史记录 ​

🎯 类概览 ​

📊 属性定义详表 ​

必选属性 ​

可选属性 ​

🔗 动态关联机制 ​

语法规范 ​

# 触发器配置
Id: "CPUUsageTriggers"
Name: "Triggers for CPU Usage"
Description: "Triggers for CPU Usage"
MetricType: "Numeric"
MetricIds: ["CPUUsage"]
TriggerActions: ["RedfishEvent"]
TriggerEnabled: true
# 阈值配置
UpperCriticalActivation: "Increasing"
UpperCriticalReading: 90
UpperWarningActivation: "Increasing"
UpperWarningReading: 75

关联说明 ​

• Id: 唯一标识触发器
• MetricIds: 关联到MetricDefinition的Id
• MetricReportDefinitions: 通过Links属性关联到MetricReportDefinition，要求对应的Triggers资源定义时TriggerActions属性取值必须包括RedfishMetricReport
• TriggerActions: 触发后执行的动作，RedfishEvent：发送Redfish事件给订阅者，RedfishMetricReport：强制更新指定的指标报告
• NumericThresholds: 数值型阈值配置，包含UpperCritical、UpperWarning、LowerCritical、LowerWarning四个阈值对象，每个阈值包含Reading（阈值读数）、Activation（激活方式）、DwellTime（迟滞时间）属性

📂 分类标准 ​

硬件属性 ​

• 定义：当前版本无硬件属性
• 特点：所有属性都是软件管理相关
• 示例：无

软件属性 ​

• 定义：由软件管理和维护的触发器配置参数
• 特点：阈值管理、触发动作、告警控制等
• 示例：所有属性都是软件属性

📝 配置示例 ​

CPU使用率告警配置 ​

{
"Triggers_SystemPowerTriggers": {
    "Id": "SystemPowerTriggers",
    "TriggerEnabled": false,
    "MetricReportDefinitions": ["SystemPowerReport"],
    "Description": "Triggers for System Power",
    "MetricIds": ["SystemPower"],
    "UpperWarningActivation": "Increasing",
    "UpperWarningDwellTime": "PT0S",
    "UpperWarningReading": 65535,
    "MetricType": "Numeric",
    "Name": "Triggers for System Power",
    "TriggerActions": ["RedfishMetricReport", "RedfishEvent"]
  }
}

🔧 使用指南 ​

配置步骤 ​

1. 设置基本信息：配置Id、Name、Description
2. 关联指标：配置MetricIds关联到MetricDefinition
3. 设置动作：配置TriggerActions（RedfishEvent或RedfishMetricReport）
4. 设置使能：配置TriggerEnabled
5. 配置阈值：配置上下限的警告和严重阈值（Reading值）
6. 配置触发方式：配置Activation方式（Increasing、Decreasing、Either、Disabled）
7. 配置迟滞：配置DwellTime防止频繁触发
8. 关联报告定义：如需生成报告，配置Links.MetricReportDefinitions

触发方式说明 ​

时间间隔格式 ​

间隔格式符合ISO 8601持续时间格式：

• PT0S - 0秒
• PT30S - 30秒
• PT1M - 1分钟
• PT1H - 1小时

使用场景 ​

• 性能告警：CPU、内存使用率告警
• 温度告警：设备温度异常告警
• 功耗告警：功耗异常告警
• 资源告警：磁盘空间、网络流量告警

注意事项 ​

• 迟滞时间：适当设置DwellTime避免频繁触发
• 触发动作：根据需求选择合适的TriggerActions
• 阈值设置：阈值应根据实际业务需求设置
• 指标关联：确保MetricIds引用的MetricDefinition存在
• 使能控制：通过TriggerEnabled控制触发器状态

故障排除 ​

1. 触发器未触发：

   • 检查TriggerEnabled是否为true
   • 确认MetricIds引用的指标是否有数据
   • 验证阈值设置是否合理

2. 频繁触发：

   • 检查DwellTime设置
   • 调整Activation方式 -验证阈值边界

3. 动作未执行：

   • 检查TriggerActions配置
   • 确认MetricReportDefinitions引用 -验证事件订阅状态