VariableALERT_MAX_THROTTLE_FIELD_VALUES_STORED
Description Maximum number of field values stored for each standard alert
Default100

This environment variable is used to set the maximum number of field values that may be stored for each legacy alert — that is to say, each legacy alert that is using field-based throttling.

If you discover that such alerts are triggered with the same field value before the throttle period has elapsed, you may want to increase the limit with this variable.

The ALERT_MAX_THROTTLE_FIELD_VALUES_STORED threshold only affects Legacy Alerts. To set the threshold for Filter Alerts and Aggregate Alerts, configure FILTER_ALERT_MAX_THROTTLE_FIELD_VALUES_STORED and AGGREGATE_ALERT_MAX_THROTTLE_FIELD_VALUES_STORED variables, respectively.

Warning

Setting too high values for this variable will cause the Global Database write throughput to get beyond what is possible to keep in sync, resulting in higher and higher ingest latency, and ultimately causing a total system outage. Many factors contribute to destabilizing the system; therefore, specifying precisely what values should be considered "too high" is not possible. Instead, analysis should be conducted on what the needed threshold value should be, and set the threshold above but close to that value. To recover from system outage, simply set back the variable to a lower value and restart.

Below is an example of how the variable might be set:

ini
ALERT_MAX_THROTTLE_FIELD_VALUES_STORED=100

This sets the limit to 100.

When an alert is triggered, LogScale will store the value of the throttle field in memory. To limit memory usage, there is a fixed limit on the number of values that LogScale stores per alert. If you select a throttle field that expects more values than this limit, your alert might trigger more frequently than indicated by the given throttle period.

Note

Related to Cluster Management, increasing the limit might also increase the memory usage of every node in the cluster.