﻿---
title: Alert states and fields reference
description: Reference for {{alerting-v2}} episode status, `.rule-events` row status, and `.alert-actions` document fields.
url: https://docs-v3-preview.elastic.dev/elastic/docs-content/pull/5528/explore-analyze/alerting/kibana-alerting-v2/alerts/alert-states-and-fields-reference-v2
products:
  - Kibana
applies_to:
  - Elastic Cloud Serverless: Preview
  - Elastic Stack: Unavailable
---

# Alert states and fields reference
Use these tables when you read alert UI state, query `.rule-events` or `.alert-actions` in Discover, or align API payloads with what operators see. For triage controls (acknowledge, snooze, resolve, tags) and how they map to storage, refer to [Alert actions](/elastic/docs-content/pull/5528/explore-analyze/alerting/kibana-alerting-v2/alerts/view-and-manage-alerts-v2#alert-actions-v2). For rule evaluation fields on `.rule-events`, refer to [Rule event and field reference](/elastic/docs-content/pull/5528/explore-analyze/alerting/kibana-alerting-v2/rules/rule-event-field-reference-v2#rule-reference-v2).

## Episode status

The `episode.status` field appears on documents with `type: alert` in `.rule-events`. It represents the current lifecycle state of the alert episode.

| Value        | Description                                                   |
|--------------|---------------------------------------------------------------|
| `inactive`   | Episode not in an active breach state in the lifecycle model. |
| `pending`    | Condition met but activation thresholds not yet satisfied.    |
| `active`     | Episode is actively breaching per rule logic.                 |
| `recovering` | Condition clearing but recovery thresholds not yet satisfied. |


## Rule event status

The `status` field appears on all documents in `.rule-events`, for both `type: signal` and `type: alert`. It reflects the outcome of a single rule evaluation row, independent of the episode lifecycle.

| Value       | Description                                                            |
|-------------|------------------------------------------------------------------------|
| `breached`  | Condition met for this evaluation row.                                 |
| `recovered` | Recovery path satisfied for this evaluation row.                       |
| `no_data`   | No-data handling produced a no-data style outcome for this evaluation. |


## Alert action document fields

When a user or the system records an action on an alert episode, Kibana writes a document to `.alert-actions`. Use this stream for triage history, operational metrics such as mean time to acknowledge (MTTA), and auditing. It does not store what your rule query returned on each run — that output is in `.rule-events`.

| Field                  | Type    | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
|------------------------|---------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| `@timestamp`           | date    | When the action was recorded.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| `episode.id`           | keyword | Target episode.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| `rule.id`              | keyword | Rule that owns the episode.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| `action.type`          | keyword | The action type, for example: - `acknowledge`: User acknowledged the alert.- `snooze`: Notifications snoozed for a period.- `tag`: Tag applied to the alert.- `fire`: Notification or escalation fired for the episode.- `unmatched`: No action policy matched the episode, so no workflow ran for it under these policies.  For the full set of action types and UI behavior, refer to [Alert actions](/elastic/docs-content/pull/5528/explore-analyze/alerting/kibana-alerting-v2/alerts/view-and-manage-alerts-v2#alert-actions-v2). |
| `episode.status_count` | long    | Count of consecutive evaluations in the current `episode.status`. Only set when `episode.status` is `pending` or `recovering`.For example, if the episode stays `pending` for three rule evaluations in a row, the value is `3`.                                                                                                                                                                                                                                                                                                        |