Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Rule Engine

The Rule Engine loads RuleSets and RuleModifiers, compiles CEL conditions, and evaluates runtime events.

The User Guide Rules page is the rule authoring surface. This page explains how that surface maps to the implementation.

Flow

flowchart LR
    SRC["Rule sources<br/>baseline / local / manager"]
    RESOLVE["RuleSet / RuleModifier resolution"]
    COMPILE["CEL compile"]
    EVAL["EvaluationState"]
    EVENT["Runtime EventRecord"]
    LOGS["Detection / runtime event logs"]

    SRC --> RESOLVE --> COMPILE --> EVAL
    EVENT --> EVAL --> LOGS

Responsibilities

AreaResponsibility
SchemaYAML schema validation for RuleSet / RuleModifier
ResolutionResolve rule sources with modifiers
CELBuild activations per event type and compile conditions / correlations
EvaluationEvaluate runtime events against rules and apply actions / tags / max alerts
CorrelationMulti-signal detection with rule.<rule_id>.total_count

CEL boundary

The CEL environment exposes only the surface needed for rule authoring. Regex, index access, arithmetic, and similar features are not allowed. This keeps detection rules readable and runtime evaluation predictable.

The source of truth for event-type fields is the User Guide Event types and CEL conditions pages.