From b00acf6eaeb3e7f889cdaa2d2e1ebae18ff23472 Mon Sep 17 00:00:00 2001 From: Nastasha Solomon Date: Fri, 15 May 2026 16:46:14 -0400 Subject: [PATCH 1/3] Apply naming guidelines to Kibana alerting pages Updates five existing pages to consistently use 'Kibana alerting' as the primary term and add anchor sentences identifying the system: - alerts.md: rename H1, add opening paragraph, add cross-reference to experimental features - alerting-getting-started.md: rename H1, update first sentence - alerting-setup.md: rename H1, add anchor sentence - create-manage-rules.md: rename H1 to include 'Kibana alerting' - view-alerts.md: rename H1 to include 'Kibana alerting', update intro Co-Authored-By: Claude Sonnet 4.6 --- explore-analyze/alerting/alerts.md | 8 +++++++- .../alerting/alerts/alerting-getting-started.md | 4 ++-- explore-analyze/alerting/alerts/alerting-setup.md | 4 ++-- explore-analyze/alerting/alerts/create-manage-rules.md | 4 ++-- explore-analyze/alerting/alerts/view-alerts.md | 4 ++-- 5 files changed, 15 insertions(+), 9 deletions(-) diff --git a/explore-analyze/alerting/alerts.md b/explore-analyze/alerting/alerts.md index ccd9c103f0..6197d19aef 100644 --- a/explore-analyze/alerting/alerts.md +++ b/explore-analyze/alerting/alerts.md @@ -10,9 +10,15 @@ products: - id: kibana - id: cloud-serverless - id: cloud-hosted +description: "Overview of Kibana alerting: rules, alerts, actions, connectors, and how they work together." --- -# Alerts +# Kibana alerting [alerts] + +Kibana alerting is the built-in alerting system in {{kib}}. It lets you define rules that check your data on a schedule, create alerts when conditions are met, and trigger actions through connectors (email, Slack, webhooks, and more). It is available on all deployments. + ## {{rules-ui}} [rules] diff --git a/explore-analyze/alerting/alerts/alerting-getting-started.md b/explore-analyze/alerting/alerts/alerting-getting-started.md index ba1b7394e7..696b45895c 100644 --- a/explore-analyze/alerting/alerts/alerting-getting-started.md +++ b/explore-analyze/alerting/alerts/alerting-getting-started.md @@ -14,9 +14,9 @@ products: - id: elastic-stack --- -# Getting started with alerting [alerting-getting-started] +# Getting started with Kibana alerting [alerting-getting-started] -Alerting enables you to define *rules*, which detect complex conditions within different {{kib}} apps and trigger actions when those conditions are met. Alerting is integrated with [**{{observability}}**](../../../solutions/observability/incident-management/alerting.md), [**Security**](detection-rules://index.md), [**Maps**](geo-alerting.md) and [**{{ml-app}}**](../../../explore-analyze/machine-learning/anomaly-detection/ml-configuring-alerts.md). It can be centrally managed from **{{stack-manage-app}}** and provides a set of built-in [connectors](../../../deploy-manage/manage-connectors.md) and [rules](rule-types.md#stack-rules) for you to use. +Kibana alerting is the built-in alerting system in {{kib}}. It enables you to define *rules*, which detect complex conditions within different {{kib}} apps and trigger actions when those conditions are met. Alerting is integrated with [**{{observability}}**](../../../solutions/observability/incident-management/alerting.md), [**Security**](detection-rules://index.md), [**Maps**](geo-alerting.md) and [**{{ml-app}}**](../../../explore-analyze/machine-learning/anomaly-detection/ml-configuring-alerts.md). It can be centrally managed from **{{stack-manage-app}}** and provides a set of built-in [connectors](../../../deploy-manage/manage-connectors.md) and [rules](rule-types.md#stack-rules) for you to use. :::{image} /explore-analyze/images/kibana-alerting-overview.png :alt: {{rules-ui}} UI diff --git a/explore-analyze/alerting/alerts/alerting-setup.md b/explore-analyze/alerting/alerts/alerting-setup.md index 6b61128b29..a0229cfb65 100644 --- a/explore-analyze/alerting/alerts/alerting-setup.md +++ b/explore-analyze/alerting/alerts/alerting-setup.md @@ -9,9 +9,9 @@ products: - id: kibana --- -# Set up [alerting-setup] +# Set up Kibana alerting [alerting-setup] -{{kib}} {{alert-features}} are automatically enabled, but might require some additional configuration. +Kibana alerting is the built-in alerting system in {{kib}}. {{alert-features}} are automatically enabled, but might require some additional configuration. ## Prerequisites [alerting-prerequisites] diff --git a/explore-analyze/alerting/alerts/create-manage-rules.md b/explore-analyze/alerting/alerts/create-manage-rules.md index 4dbf5c249b..a354b5eb85 100644 --- a/explore-analyze/alerting/alerts/create-manage-rules.md +++ b/explore-analyze/alerting/alerts/create-manage-rules.md @@ -9,9 +9,9 @@ products: - id: kibana --- -# Create and manage alerting rules with {{kib}} [create-and-manage-rules] +# Create and manage Kibana alerting rules [create-and-manage-rules] -The **{{stack-manage-app}}** > **{{rules-ui}}** UI provides a cross-app view of alerting. Different {{kib}} apps like [**{{observability}}**](../../../solutions/observability/incident-management/alerting.md), [**Security**](detection-rules://index.md), [**Maps**](geo-alerting.md) and [**{{ml-app}}**](../../machine-learning/machine-learning-in-kibana.md) can offer their own rules. +The **{{stack-manage-app}}** > **{{rules-ui}}** UI provides a cross-app view of Kibana alerting. Different {{kib}} apps like [**{{observability}}**](../../../solutions/observability/incident-management/alerting.md), [**Security**](detection-rules://index.md), [**Maps**](geo-alerting.md) and [**{{ml-app}}**](../../machine-learning/machine-learning-in-kibana.md) can offer their own rules. You can find **Rules** in **Stack Management** > **Alerts and insights** > **Rules** in {{kib}} or by using the [global search field](/explore-analyze/find-and-organize/find-apps-and-objects.md). diff --git a/explore-analyze/alerting/alerts/view-alerts.md b/explore-analyze/alerting/alerts/view-alerts.md index 83253626ec..f71a111eef 100644 --- a/explore-analyze/alerting/alerts/view-alerts.md +++ b/explore-analyze/alerting/alerts/view-alerts.md @@ -9,9 +9,9 @@ products: - id: kibana --- -# View and manage alerts in {{kib}} [view-alerts] +# View and manage Kibana alerting alerts [view-alerts] -When the conditions of a rule are met, it creates an alert. If the rule has actions, they run at the defined frequency. For example, the rule can send email notifications for each alert at a custom interval. For an introduction to the concepts of rules, alerts, and actions, refer to [Alerting](../alerts.md). +Kibana alerting creates an alert when the conditions of a rule are met. If the rule has actions, they run at the defined frequency. For example, the rule can send email notifications for each alert at a custom interval. For an introduction to the concepts of rules, alerts, and actions, refer to [Kibana alerting](../alerts.md). Manage alerts from the following places: From b5bd954b8280e3ce47e2625e2d193e77788bca6b Mon Sep 17 00:00:00 2001 From: Nastasha Solomon Date: Fri, 15 May 2026 17:12:17 -0400 Subject: [PATCH 2/3] Add alerting-v2 variables and replace phrase throughout Co-Authored-By: Claude Sonnet 4.6 --- docset.yml | 2 ++ explore-analyze/alerting/alerts.md | 2 +- 2 files changed, 3 insertions(+), 1 deletion(-) diff --git a/docset.yml b/docset.yml index 5ecf676ed5..a43cb177d5 100644 --- a/docset.yml +++ b/docset.yml @@ -123,6 +123,8 @@ subs: ls-pipelines-app: "Logstash Pipelines" maint-windows-app: "Maintenance Windows" maint-windows-cap: "Maintenance windows" + alerting-v2: "experimental alerting features" + alerting-v2-cap: "Experimental alerting features" custom-roles-app: "Custom Roles" data-source: "data view" data-sources: "data views" diff --git a/explore-analyze/alerting/alerts.md b/explore-analyze/alerting/alerts.md index 6197d19aef..738b62fda0 100644 --- a/explore-analyze/alerting/alerts.md +++ b/explore-analyze/alerting/alerts.md @@ -17,7 +17,7 @@ description: "Overview of Kibana alerting: rules, alerts, actions, connectors, a Kibana alerting is the built-in alerting system in {{kib}}. It lets you define rules that check your data on a schedule, create alerts when conditions are met, and trigger actions through connectors (email, Slack, webhooks, and more). It is available on all deployments. ## {{rules-ui}} [rules] From 0462d778a693d8f768005cb4600d89a3aa8ffc55 Mon Sep 17 00:00:00 2001 From: Nastasha Solomon Date: Wed, 27 May 2026 18:35:45 -0400 Subject: [PATCH 3/3] added variable --- explore-analyze/alerting/alerts.md | 4 ++-- explore-analyze/alerting/alerts/alerting-getting-started.md | 4 ++-- explore-analyze/alerting/alerts/alerting-setup.md | 4 ++-- explore-analyze/alerting/alerts/create-manage-rules.md | 4 ++-- explore-analyze/alerting/alerts/view-alerts.md | 4 ++-- explore-analyze/alerting/watcher/enable-watcher.md | 4 ++-- 6 files changed, 12 insertions(+), 12 deletions(-) diff --git a/explore-analyze/alerting/alerts.md b/explore-analyze/alerting/alerts.md index 738b62fda0..972d944c84 100644 --- a/explore-analyze/alerting/alerts.md +++ b/explore-analyze/alerting/alerts.md @@ -13,9 +13,9 @@ products: description: "Overview of Kibana alerting: rules, alerts, actions, connectors, and how they work together." --- -# Kibana alerting [alerts] +# {{kib}} alerting [alerts] -Kibana alerting is the built-in alerting system in {{kib}}. It lets you define rules that check your data on a schedule, create alerts when conditions are met, and trigger actions through connectors (email, Slack, webhooks, and more). It is available on all deployments. +{{kib}} alerting is the built-in alerting system in {{kib}}. It lets you define rules that check your data on a schedule, create alerts when conditions are met, and trigger actions through connectors (email, Slack, webhooks, and more). It is available on all deployments. diff --git a/explore-analyze/alerting/alerts/alerting-getting-started.md b/explore-analyze/alerting/alerts/alerting-getting-started.md index 696b45895c..d2cacfd0c8 100644 --- a/explore-analyze/alerting/alerts/alerting-getting-started.md +++ b/explore-analyze/alerting/alerts/alerting-getting-started.md @@ -14,9 +14,9 @@ products: - id: elastic-stack --- -# Getting started with Kibana alerting [alerting-getting-started] +# Getting started with {{kib}} alerting [alerting-getting-started] -Kibana alerting is the built-in alerting system in {{kib}}. It enables you to define *rules*, which detect complex conditions within different {{kib}} apps and trigger actions when those conditions are met. Alerting is integrated with [**{{observability}}**](../../../solutions/observability/incident-management/alerting.md), [**Security**](detection-rules://index.md), [**Maps**](geo-alerting.md) and [**{{ml-app}}**](../../../explore-analyze/machine-learning/anomaly-detection/ml-configuring-alerts.md). It can be centrally managed from **{{stack-manage-app}}** and provides a set of built-in [connectors](../../../deploy-manage/manage-connectors.md) and [rules](rule-types.md#stack-rules) for you to use. +{{kib}} alerting is the built-in alerting system in {{kib}}. It enables you to define *rules*, which detect complex conditions within different {{kib}} apps and trigger actions when those conditions are met. Alerting is integrated with [**{{observability}}**](../../../solutions/observability/incident-management/alerting.md), [**Security**](detection-rules://index.md), [**Maps**](geo-alerting.md) and [**{{ml-app}}**](../../../explore-analyze/machine-learning/anomaly-detection/ml-configuring-alerts.md). It can be centrally managed from **{{stack-manage-app}}** and provides a set of built-in [connectors](../../../deploy-manage/manage-connectors.md) and [rules](rule-types.md#stack-rules) for you to use. :::{image} /explore-analyze/images/kibana-alerting-overview.png :alt: {{rules-ui}} UI diff --git a/explore-analyze/alerting/alerts/alerting-setup.md b/explore-analyze/alerting/alerts/alerting-setup.md index 2c5615b8de..0d444a1b0c 100644 --- a/explore-analyze/alerting/alerts/alerting-setup.md +++ b/explore-analyze/alerting/alerts/alerting-setup.md @@ -9,9 +9,9 @@ products: - id: kibana --- -# Set up Kibana alerting [alerting-setup] +# Set up {{kib}} alerting [alerting-setup] -Kibana alerting is the built-in alerting system in {{kib}}. {{alert-features}} are automatically enabled, but might require some additional configuration. +{{kib}} alerting is the built-in alerting system in {{kib}}. {{alert-features}} are automatically enabled, but might require some additional configuration. ## Prerequisites [alerting-prerequisites] diff --git a/explore-analyze/alerting/alerts/create-manage-rules.md b/explore-analyze/alerting/alerts/create-manage-rules.md index 923c858423..4d1332a6c3 100644 --- a/explore-analyze/alerting/alerts/create-manage-rules.md +++ b/explore-analyze/alerting/alerts/create-manage-rules.md @@ -9,9 +9,9 @@ products: - id: kibana --- -# Create and manage Kibana alerting rules [create-and-manage-rules] +# Create and manage {{kib}} alerting rules [create-and-manage-rules] -The **{{stack-manage-app}}** > **{{rules-ui}}** UI provides a cross-app view of Kibana alerting. Different {{kib}} apps like [**{{observability}}**](../../../solutions/observability/incident-management/alerting.md), [**Security**](detection-rules://index.md), [**Maps**](geo-alerting.md) and [**{{ml-app}}**](../../machine-learning/machine-learning-in-kibana.md) can offer their own rules. +The **{{stack-manage-app}}** > **{{rules-ui}}** UI provides a cross-app view of {{kib}} alerting. Different {{kib}} apps like [**{{observability}}**](../../../solutions/observability/incident-management/alerting.md), [**Security**](detection-rules://index.md), [**Maps**](geo-alerting.md) and [**{{ml-app}}**](../../machine-learning/machine-learning-in-kibana.md) can offer their own rules. You can find **Rules** in **Stack Management** > **Alerts and insights** > **Rules** in {{kib}} or by using the [global search field](/explore-analyze/find-and-organize/find-apps-and-objects.md). diff --git a/explore-analyze/alerting/alerts/view-alerts.md b/explore-analyze/alerting/alerts/view-alerts.md index f71a111eef..d974d87384 100644 --- a/explore-analyze/alerting/alerts/view-alerts.md +++ b/explore-analyze/alerting/alerts/view-alerts.md @@ -9,9 +9,9 @@ products: - id: kibana --- -# View and manage Kibana alerting alerts [view-alerts] +# View and manage alerts from {{kib}} alerting rules [view-alerts] -Kibana alerting creates an alert when the conditions of a rule are met. If the rule has actions, they run at the defined frequency. For example, the rule can send email notifications for each alert at a custom interval. For an introduction to the concepts of rules, alerts, and actions, refer to [Kibana alerting](../alerts.md). +{{kib}} alerting creates an alert when the conditions of a rule are met. If the rule has actions, they run at the defined frequency. For example, the rule can send email notifications for each alert at a custom interval. For an introduction to the concepts of rules, alerts, and actions, refer to [{{kib}} alerting](../alerts.md). Manage alerts from the following places: diff --git a/explore-analyze/alerting/watcher/enable-watcher.md b/explore-analyze/alerting/watcher/enable-watcher.md index e4ca04d971..8a38a54eb4 100644 --- a/explore-analyze/alerting/watcher/enable-watcher.md +++ b/explore-analyze/alerting/watcher/enable-watcher.md @@ -10,7 +10,7 @@ products: # Enable Watcher [enable-watcher] ::::{note} -If you are looking for Kibana alerting, check [Alerting](../../../explore-analyze/alerting.md). +If you are looking for {{kib}} alerting, check [Alerting](../../../explore-analyze/alerting.md). :::: Watcher can be enabled when configuring your cluster. You can run Alerting on a separate cluster from the cluster whose data you are actually watching. @@ -23,7 +23,7 @@ To enable Watcher on a cluster, you may first need to perform one or several of * To receive default Elasticsearch Watcher alerts (cluster status, nodes changed, version mismatch), you need to have monitoring enabled to send to the Admin email address specified in Kibana. To enable this, go to **Advanced Settings > Admin email**. -To learn more about Kibana alerting and how to use it, check [Alerting and Actions](../../../explore-analyze/alerting.md). +To learn more about {{kib}} alerting and how to use it, check [Alerting and Actions](../../../explore-analyze/alerting.md). ## Send alerts by email [watcher-allowlist]