threshold alerting

[eastein]

Settings

• message: send (if not throttled) when entering the active state.
• end_message: send (throttling? not sure) when exiting the active state.

  Types

• Instantaneous - as soon as the ratio reaches at or above/below the threshold, the alert is triggered
• Sustained - the ratio must remain at or above/below the threshold for n seconds, configurable

Thresholding modes: above value, below value, between values.

Message Rate Throttling

• A setting in IRC stanzas (defaulting to once per minute) defines how frequently messages can be sent

  Assignment

A threshold alert will be defined to operate on 1 or camera and go to all channels.

Persisting / Error Tolerance

Restarting should not interrupt the alert state machine (including throttling) or cause it to restart. Persisting inter-run is important. Having the information time out after a short period of downtime is reasonable, but I'm not sure what those setting should be.

Error tolerance: for sustain alerts, up to N per million of the frames used to establish the activation of the alert state sustain may be "Unk%" samples. I'm not sure how unknown busydata should affect exiting the alert state.

[eastein]

Sustain alerts should not alert again until they go below threshold.

[eastein]

Need documentation for alerts.

[eastein]

Added low and high threshold instead of just low in 6257fef.

[eastein]

This needs documentation and error checking in the config and then it can be called done.