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-eventswhen 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 havetype: alertandepisode.*fields. Events that aren't part of an episode havetype: signaland 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-eventsand 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.