Reactions

From zzat
Revision as of 09:36, 21 February 2018 by Zztat (talk | contribs)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to: navigation, search

Reactions are triggered by the framework when requested by a gauge. Reactions come in two major classes: corrective and non-corrective. The effect of corrective versus non-corrective is with regards to the alert raised that triggered the reaction. A non-corrective reaction will do nothing to alter the state of the circumstance that led to the alert. A corrective reaction may attempt to rectify the situation automatically. To mark a reaction as corrective, the CORRECTIVE flag can be set on the reaction.

Please note that most of the corrective reactions require the zz$sys_helper package to be installed. The zztat installation creates several built-in default reactions as part of installation.

Default Reaction

The zztat reaction configuration allows you to define a default reaction, which by default is the SEND_EMAIL reaction. This reaction gets triggered automatically as a fallback whenever the specified reaction fails, or was throttled.

Automatic Throttling

Every reaction keeps track of its last execution time stamp and how often it ran. The framework will automatically ensure that any throttled reaction does not exceed its limited execution count. The following attributes are available to control how often a reaction executes:

Attribute Effect
max_runs_per_interval Defines the maximum number of times the reaction may fire in the specified interval.
interval Defines the interval, stores as the INTERVAL DAY TO SECOND data type to which the limit applies. Once the limit has been reached, further executions will fail and the

framework will fall back to the default reaction.

Configuring Reactions

There are many parameters available to control how zztat's reactions are behaving. The central interface to configure reactions is the zz$manage.reaction_config procedure.