8.6.4. Counter Handler Module¶
The counter event handler module is used to count certain events. You can define arbitrary counter names and each occurrence of an event will modify the counter in the counter table according to the selected action.
These counters can be used to graph time series of failed authentication, assigned tokens, user numbers or any other data with any condition over time.
18.104.22.168. Possible Actions¶
This action increases the counter in the database table
If the counter does not exists, it will be created and increased.
This action decreases the counter in the database table
If the counter does not exists, it will be created and decreased.
This action will not decrease the counter beyond zero unless the option allow_negative_values is enabled.
This action resets the counter in the database table
22.214.171.124. Possible Options¶
This is the name of the counter in the database. You can have as many counters in as many event handlers as you like.
- Only available for the
decrease_counteraction. Allows the counter to become negative. If set
False(default) decreasing stops at
zero. .. note:: Since the option
allow_negative_valuesis an attribute of the counter event handler action (and not the counter itself in the database) it is possible to define multiple event handler accessing the same counter. Thus if a negative counter is accessed by an event handler with the option
allow_negative_valuesset to true, the counter will be reset to