Skip to content

Latest commit

 

History

History
123 lines (113 loc) · 3.75 KB

method.md

File metadata and controls

123 lines (113 loc) · 3.75 KB

method

Description

The method to use in monitoring a fan's functional state. One method can be configured per fan and each supported method requires its own set of attributes to be provided.

Attribute Value(s)

Methods:

"timebased"

Uses timers for determining when a fan's sensor should be marked nonfunctional or functional after its been in that state for that continuous amount of time. Separate timers are used to transition a fan from functional to nonfunctional(allowed_out_of_range_time) and nonfunctional to functional(functional_delay).

  • allowed_out_of_range_time - Time(in seconds) that each fan sensor is allowed to be calculated out of range of a current target before being marked nonfunctional.
  • functional_delay - Optional, default = 0
    • Time(in seconds) that each fan sensor must be calculated within range of a current target before being marked functional.
"method": "timebased",
"allowed_out_of_range_time": 30,
"functional_delay": 5

Note: Since this method is the default, simply providing allowed_out_of_range_time and functional_delay attributes will result in this method being used.

  • This is equivalent to above: 
    "allowed_out_of_range_time": 30,
"functional_delay": 5

"count"

An up/down counter for determining when a fan's sensor should be marked nonfunctional based on a threshold or functional when the counter = 0. Each fan sensor update where its feedback speed is calculated out of range of the current target increments the counter by 1. Once the counter reaches the threshold, the fan is marked nonfunctional. However, at any point the sensor's feedback speed is within range, the counter is decremented by 1. Therefore the fan's sensor(s) do not have to continuously be in a faulted state to be marked nonfunctional and instead is deemed nonfunctional once it accumulates the threshold number of times deemed out of range. The same is true for a nonfunctional fan sensor to become functional, where the counter must accumulate enough times deemed within range to decrement the counter to 0. This checking occurs at an interval dictated by the count_interval field.

  • threshold - Number of total times a fan sensor must be calculated out of range before being marked nonfunctional.

  • count_interval - The interval, in seconds, to check the feedback speed and increment/decrement the counter. Defaults to 1s if not present.

"method": "count",
"count_interval": 5,
"sensors": [
  {
    "threshold": 30
  }
]

Example


{
  "fans": [
    {
      "inventory": "/system/chassis/motherboard/fan0",
      "allowed_out_of_range_time": 30,
      "functional_delay": 5,
      "deviation": 15,
      "num_sensors_nonfunc_for_fan_nonfunc": 1,
      "monitor_start_delay": 30,
      "fan_missing_error_delay": 20,
      "nonfunc_rotor_error_delay": 0,
      "sensors": [
        {
          "name": "fan0_0",
          "has_target": true
        },
        {
          "name": "fan0_1",
          "has_target": false,
          "factor": 1.45,
          "offset": -909
        }
      ]
    },
    {
      "inventory": "/system/chassis/motherboard/fan1",
      "method": "count",
      "count_interval": 1,
      "deviation": 15,
      "num_sensors_nonfunc_for_fan_nonfunc": 1,
      "monitor_start_delay": 30,
      "fan_missing_error_delay": 20,
      "nonfunc_rotor_error_delay": 0,
      "sensors": [
        {
          "name": "fan0_0",
          "has_target": true,
          "threshold": 30
        },
        {
          "name": "fan0_1",
          "has_target": false,
          "factor": 1.45,
          "offset": -909,
          "threshold": 30
        }
      ]
    }
  ]
}