RCF streaming
Enrichment and detection setting (global). This setting applies to every sensor. For conventions, abbreviations, and the other sections, see the Administration configuration reference.
Where: Administration → Configuration → Enrichment and detection settings → RCF streaming
Control the machine learning (ML) anomaly detection stream. The Random Cut Forest (RCF) engine scores traffic for anomalies.
Setting | What it does | Default | Allowed values | Notes |
|---|---|---|---|---|
Enabled | Enable this service. | On | on/off | — |
Whitelist Enabled | Enable whitelist checks. | On | on/off | — |
Directions | Traffic directions to build per-(sensor,direction,protocol) RCF models for. Includes UNKNOWN so events whose endpoint locality cannot be resolved are still modeled rather than dropped by the early direction filter. |
|
| Restart needed |
Flow | Flow RCF profile. This is a group of settings. See the sub-settings below. | (see the sub-settings) | group of settings | Restart needed |
Http | HTTP RCF profile. This is a group of settings. See the sub-settings below. | (see the sub-settings) | group of settings | Restart needed |
DNS | DNS RCF profile. This is a group of settings. See the sub-settings below. | (see the sub-settings) | group of settings | Restart needed |
TLS | TLS RCF profile. This is a group of settings. See the sub-settings below. | (see the sub-settings) | group of settings | Restart needed |
Critical Score | Anomaly score at or above which a detection is mapped to CRITICAL severity (SeverityLevel.CRITICAL). On the canonical score scale (see the class docstring) the observed maximum is ~7, so this tier is deliberately reserved for extreme outliers. |
| number; 1 to 10000 | — |
High Score | Anomaly score at or above which a detection is mapped to HIGH severity (below critical_score). |
| number; 1 to 10000 | — |
Medium Score | Anomaly score at or above which a detection is mapped to MEDIUM severity (below high_score); scores below this map to LOW. Must sit at or above the per-protocol anomaly_threshold values, or no alert can ever be LOW. |
| number; 1 to 10000 | — |
Max Models | Hard cap on total live RCF models (sensors x directions x protocols) for memory safety. |
| number; 1 to 1000000 | — |
RCF streaming: RCFProtocolProfile sub-settings
Per-protocol RCF config contract. The top-level num_trees/shingle_size/tree_size/anomaly_threshold fields are the active (operator-facing default) tunables and are the MEDIUM sensitivity tier. The flat low_* and high_* fields carry the LOW and HIGH tiers so the streaming service can look up the parameters for any sensitivity preset entirely from the ontology with no hardcoded fallback.
Setting | What it does | Default | Allowed values | Notes |
|---|---|---|---|---|
Enabled | Enable RCF for this protocol. | On | on/off | — |
Sensitivity | Sensitivity preset for this protocol. |
|
| — |
Num Trees | Number of trees in the RCF forest for this protocol. |
| number; 5 to 100 | — |
Shingle Size | Shingle size (sequence length) for this protocol. |
| number; 1 to 16 | — |
Tree Size | Maximum samples per tree for this protocol. |
| number; 32 to 1024 | — |
Training Min Samples | Min data points this protocol's model must ingest before it exits training and begins alerting; 0 disables the gate (model alerts as soon as the forest window fills). |
| number; 0 to 100000000 | — |
Anomaly Threshold | Anomaly score cutoff for this protocol, on the native-backend score scale where ~1.0 is the expected score for in-distribution traffic (see RCFStreamingServiceConfig for the measured per-protocol distributions). A value drawn from a different backend's scale will silently never fire. |
| number; 0.5 to 100.0 | — |
Low Num Trees | Number of trees in the RCF forest when this protocol runs at LOW sensitivity. |
| number; 5 to 100 | — |
Low Shingle Size | Shingle size (sequence length) when this protocol runs at LOW sensitivity. |
| number; 1 to 16 | — |
Low Tree Size | Maximum samples per tree when this protocol runs at LOW sensitivity. |
| number; 32 to 1024 | — |
Low Anomaly Threshold | Anomaly score cutoff when this protocol runs at LOW sensitivity (native-backend scale; LOW sensitivity means FEWER alerts, so this sits ABOVE anomaly_threshold). |
| number; 0.5 to 100.0 | — |
High Num Trees | Number of trees in the RCF forest when this protocol runs at HIGH sensitivity. |
| number; 5 to 100 | — |
High Shingle Size | Shingle size (sequence length) when this protocol runs at HIGH sensitivity. |
| number; 1 to 16 | — |
High Tree Size | Maximum samples per tree when this protocol runs at HIGH sensitivity. |
| number; 32 to 1024 | — |
High Anomaly Threshold | Anomaly score cutoff when this protocol runs at HIGH sensitivity (native-backend scale; HIGH sensitivity means MORE alerts, so this sits BELOW anomaly_threshold). |
| number; 0.5 to 100.0 | — |
Related: ML anomaly detections
Back to the Administration configuration reference.