Dell iDRAC Telemetry Reference Guide

Properties of Triggers

Triggers have properties like DiscreteTriggerCondition, DiscreteTriggers, EventTriggers, MetricProperties, MetricType, and TriggerActions. These properties define conditions and actions for triggers.

The following are the properties of Triggers:

• MetricType – This determines the type of the trigger (discrete, or numeric) and corresponding specifications (EventTriggers, DiscreteTriggers, or NumericThresholds). The specifications and type must match and not be mixed.
  • Omitted (not present) - Fired only on events listed in EventTriggers
  • Numeric – The trigger is for numeric sensor. Uses Numeric Thresholds to fire the trigger
  • Discrete – trigger is fired when a metric value is exactly equal to a specified value or change of value detected.
• DiscreteTriggerCondition
  • Specified - A discrete trigger condition is met when the metric value becomes one of the values that the DiscreteTriggers property lists.
  • Changed - A discrete trigger condition is met whenever the metric value changes.
• DiscreteTriggers - This property shall contain a list of values to which to compare a metric reading. This property shall be present when the DiscreteTriggerCondition property is Specified.
  • DwellTime - This property shall contain the amount of time that a trigger event persists before the MetricAction is performed. The fractional seconds are ignored.
  • Value - This property shall contain the value discrete metric that constitutes a trigger event. The DwellTime shall be measured from this point in time.
  • Severity – ignored
  • Name – ignored
• EventTriggers – Array of message IDs to trigger on. If any event is raised with this message id, this trigger is fired
• Links/MetricReportDefinitions – List of all the Reports that are generated when this trigger fires.
• MetricProperties – See Metric Report Definitions (MRD) and Metric Report
• Wildcards – See Metric Report Definitions (MRD)
• MetricIds – This shall contain an array of MetricIds whose numeric or discrete value is used to evaluate the threshold crossing or discrete trigger condition. It is a many-to-many relation between MetricIds and numeric threshold “Reading”s or discrete trigger “Value”s. Note: Only either MetricIds or MetricProperties with optional Wildcards is supported, not both.
• NumericThresholds
  • LowerCritical/LowerWarning/UpperCritical/UpperWarning
    • Activation
      • Decreasing – Trigger when the metric value starts higher than, then falls below the specified Reading and remains below for the specified DwellTime
      • Either – Fire the trigger any time the value crosses from above to below or below to above the Reading for DwellTime duration.
      • Increasing – fire the trigger when the metric value starts lower than, then rises above the specified Reading and remains above for the specified DwellTime.
    • DwellTime - This property shall indicate the duration the sensor value must violate the threshold before the threshold is activated. The fractional seconds are ignored.
    • Reading - The numeric value for comparison
• TriggerActions
  • RedfishMetricReport - This value indicates that when a trigger condition is met, the service shall force the metric reports managed by the MetricReportDefinitions specified by the MetricReportDefinitions property to be updated, regardless of the MetricReportDefinitionType property value. The actions specified in the ReportActions property of each MetricReportDefinition shall be performed.
• Name – The name of the trigger.