Skip to main content
Version: 6.1

Cluster Settings

Cluster settings control correlator behavior and are the same for all nodes. A configured value is replicated across the entire cluster.

Overriding Settings

By default, all parameters use their built-in values.

To specify a custom parameter value:

  1. Click Override Setting
  2. In Select Setting, select the required parameter. Its current default value is displayed next to its name
  3. Enter the parameter value
  4. Click Add to apply the value, or Cancel to close the form without changes

The parameter appears in a separate table of overridden settings. Resetting a parameter in this table restores its built-in value.

Overriding a cluster setting

When a Value Takes Effect

The Restart column in the tables below shows how a parameter takes effect:

  • no - the value is applied to the running cluster as soon as it is saved
  • yes - the value is saved and replicated, but nodes keep running with the previous value until the smrtc service is restarted on each of them

Durations are written as <integer><unit> (ms, s, m, h, d), and sizes as <integer><unit> with binary multipliers (b, kb, mb, gb, tb). Fractional values are not supported.

Event Ingestion

ParameterDescriptionDefaultRestart
ingest.queue_sizeIn-memory ingest queue capacity, in events1000000yes
ingest.warmup_modeIngestion behavior while the node warms up: block rejects events, accept admits themblockyes
ingest.dedupe_ttlHow long a forwarded event identifier is stored for duplicate suppression600sno
ingest.dedupe_max_entriesMaximum number of identifiers in the duplicate table1000000yes
ingest.event_sample_sizeNumber of event samples stored for each alias; 0 disables sampling, and the maximum is 100010no

Cluster Coordination

ParameterDescriptionDefaultRestart
cluster.heartbeatInterval between node heartbeat messages3syes
cluster.peer_timeoutTimeout after which a node is considered unavailable; must exceed cluster.heartbeat30syes
cluster.leaseOwnership lease duration used for cluster coordination30syes

Data Retention

ParameterDescriptionDefaultRestart
retention.firesFiring retention period30dno
retention.processed_sourcesHow long processed source statistics survive after the last event30dno
Important

Both retention periods must be whole multiples of a day: a value such as 36h is rejected.

Negative Filter

ParameterDescriptionDefaultRestart
negative_filter.enabledEnables the negative filtertrueyes
negative_filter.budgetFilter memory budget; at least 1mb256mbyes
negative_filter.pending_spillVolume of in-flight pending writes held in memory before they spill to disk; at least 1mb32mbyes

Time Model

ParameterDescriptionDefaultRestart
time_model.max_skew_fwdHow far into the future an event timestamp may run before it is clamped to receipt time300sno
time_model.max_lag_back_floorFloor on how far back an event timestamp may lag; the effective bound is the greater of the rule window and this value3600sno
time_model.retention_grace_floorMinimum grace added to a rule window before its correlation state is reaped30sno
time_model.retention_grace_ceilMaximum such grace; must not be below time_model.retention_grace_floor300sno

Correlation

ParameterDescriptionDefaultRestart
correlation.max_partials_per_ruleLimit on concurrent incomplete imperative chains per rule4096no
correlation.reserved_step_poolSlots reserved for advancing an existing chain instead of starting a new one512no
correlation.global_partial_ceilingNode-wide limit on incomplete chains across all rules1000000no
correlation.max_aggregation_set_per_groupLimit on the distinct values a dc or values metric tracks per group100000no

Search Anywhere Framework Connection

ParameterDescriptionDefaultRestart
smart_monitor.use_tlsUses TLS when dispatching firings to Search Anywhere Frameworktrueno
smart_monitor.tls_insecure_skip_verifySkips Search Anywhere Framework certificate verificationfalseno
smart_monitor.dispatch_concurrencyNumber of in-flight firing dispatch requests; allowed range is 4 to 1024128no
Important

smart_monitor.tls_insecure_skip_verify disables Search Anywhere Framework certificate authenticity verification.