Experimental alerting system glossary

These terms appear throughout the experimental alerting system docs. If a term is unclear while reading, check its definition here before going further.

Action policy
A configuration that controls which alert episodes invoke a workflow and how often. A single action policy can apply to one rule, several rules, or all rules in the space. To learn more, refer to Notifications and actions.
Alert episode
The complete record of one problem, from first detection to recovery, moving through states (pending, active, recovering, inactive). An episode is the grouping of rule events that share an episode.id. To learn more, refer to Alerts.
Breach
A single instance when a rule's query finds a match, which may or may not open an alert episode depending on how the rule is configured. To learn more, refer to ES|QL query.
Dispatcher
The background process that evaluates action policies against active alert episodes on a short interval (around 5 seconds), independent of the rule schedule. To learn more, refer to Reduce notification noise.
ES|QL
The query language every rule uses to search your data. To learn more, refer to the ES|QL reference.
Notification
The message or action a workflow sends (such as a Slack message, an email, or a webhook call) when an alert episode matches an action policy or a lifecycle trigger fires. To learn more, refer to How action policies are evaluated.
Rule
The definition of what to watch for in your data, how often to check, and what counts as a match. A rule runs on a schedule. Kibana writes rule events when the query finds a match. The rule's configuration determines whether those events are grouped into alert episodes. To learn more, refer to Rules.
Rule event
A record Kibana writes to .rule-events when a rule finds a match: one event per matching row, per run. Kibana never overwrites these events. Events that are part of an alert episode have type: alert and episode.* fields. Events that aren't part of an episode have type: signal and stay in .rule-events. To learn more, refer to Rule events.
Severity
A label attached to alert episodes to indicate urgency. Severity is available as a filter in action policies so critical episodes can be routed differently from low-priority ones. To learn more, refer to Configure rule severity.
Signal
A rule event with type: signal. These events stay in .rule-events and are queryable in Discover. Action policies evaluate alert episodes only, so these events never reach a policy or a workflow. To learn more, refer to Query signals and Rule mode.
Threshold
The condition a rule uses to decide when something is worth alerting on, including how many times the condition must be met before an alert episode opens or closes. To learn more, refer to Alert delay and Recovery condition.
Workflow
The automation that sends a message or runs an action (such as posting to Slack, sending an email, or calling a webhook) when an action policy or an alert episode lifecycle trigger invokes it. To learn more, refer to Connect workflows.