From 708d7375329e0b1881205a66a68e943fc08ce016 Mon Sep 17 00:00:00 2001 From: Joe Peeples Date: Wed, 1 May 2024 14:59:38 -0400 Subject: [PATCH 1/4] Add new step to all rule types --- docs/detections/rules-ui-create.asciidoc | 64 ++++++++++++++++++++++++ 1 file changed, 64 insertions(+) diff --git a/docs/detections/rules-ui-create.asciidoc b/docs/detections/rules-ui-create.asciidoc index 16f2a712dc..650502e935 100644 --- a/docs/detections/rules-ui-create.asciidoc +++ b/docs/detections/rules-ui-create.asciidoc @@ -45,6 +45,16 @@ then select: + NOTE: If a required job isn't currently running, it will automatically start when you finish configuring and enable the rule. .. The anomaly score threshold above which alerts are created. ++ + +//// +The following step is repeated across all rule types. If you change anything +in the step or its sub-steps, apply the change to the other rule types, too. +//// +. (Optional) To associate the rule with one or more {integrations-docs}[Elastic integrations], click *Add integration* under *Related integrations*, then: +.. Select an integration from the list. +.. Enter the version of the integration you want associated with the rule, using https://semver.org[semantic versioning]. For version ranges, you must use tilde or caret syntax. For example, `~1.2.3` is from 1.2.3 to any patch version less than 1.3.0, and `^1.2.3` is from 1.2.3 to any minor and patch version less than 2.0.0. + . Click **Continue** to <>. [discrete] @@ -82,6 +92,15 @@ When you use a saved query, the *Load saved query "_query name_" dynamically on * Deselect this to load the saved query as a one-time way of populating the rule's *Custom query* field and filters. This copies the settings from the saved query to the rule, so you can then further adjust the rule's query and filters as needed. If the saved query is later changed, the rule will not inherit those changes. . (Optional, https://www.elastic.co/pricing[Platinum or higher subscription] required) Use *Suppress alerts by* to reduce the number of repeated or duplicate alerts created by the rule. Refer to <> for more information. ++ + +//// +The following step is repeated across all rule types. If you change anything +in the step or its sub-steps, apply the change to the other rule types, too. +//// +. (Optional) To associate the rule with one or more {integrations-docs}[Elastic integrations], click *Add integration* under *Related integrations*, then: +.. Select an integration from the list. +.. Enter the version of the integration you want associated with the rule, using https://semver.org[semantic versioning]. For version ranges, you must use tilde or caret syntax. For example, `~1.2.3` is from 1.2.3 to any patch version less than 1.3.0, and `^1.2.3` is from 1.2.3 to any minor and patch version less than 2.0.0. . Click **Continue** to <>. @@ -109,6 +128,15 @@ You can also leave the *Group by* field undefined. The rule then creates an aler IMPORTANT: Alerts created by threshold rules are synthetic alerts that do not resemble the source documents. The alert itself only contains data about the fields that were aggregated over (the *Group by* fields). Other fields are omitted, because they can vary across all source documents that were counted toward the threshold. Additionally, you can reference the actual count of documents that exceeded the threshold from the `kibana.alert.threshold_result.count` field. . preview:[] (Optional, https://www.elastic.co/pricing[Platinum or higher subscription] required) Select *Suppress alerts* to reduce the number of repeated or duplicate alerts created by the rule. Refer to <> for more information. ++ + +//// +The following step is repeated across all rule types. If you change anything +in the step or its sub-steps, apply the change to the other rule types, too. +//// +. (Optional) To associate the rule with one or more {integrations-docs}[Elastic integrations], click *Add integration* under *Related integrations*, then: +.. Select an integration from the list. +.. Enter the version of the integration you want associated with the rule, using https://semver.org[semantic versioning]. For version ranges, you must use tilde or caret syntax. For example, `~1.2.3` is from 1.2.3 to any patch version less than 1.3.0, and `^1.2.3` is from 1.2.3 to any minor and patch version less than 2.0.0. . Click *Continue* to <>. @@ -159,6 +187,15 @@ NOTE: For sequence events, the {security-app} generates a single alert when all + . preview:[] (Optional, https://www.elastic.co/pricing[Platinum or higher subscription] required) Use *Suppress alerts by* to reduce the number of repeated or duplicate alerts created by the rule. Refer to <> for more information. ++ + +//// +The following step is repeated across all rule types. If you change anything +in the step or its sub-steps, apply the change to the other rule types, too. +//// +. (Optional) To associate the rule with one or more {integrations-docs}[Elastic integrations], click *Add integration* under *Related integrations*, then: +.. Select an integration from the list. +.. Enter the version of the integration you want associated with the rule, using https://semver.org[semantic versioning]. For version ranges, you must use tilde or caret syntax. For example, `~1.2.3` is from 1.2.3 to any patch version less than 1.3.0, and `^1.2.3` is from 1.2.3 to any minor and patch version less than 2.0.0. . Click *Continue* to <>. @@ -213,6 +250,15 @@ in the Timeline, Timeline query values are replaced with their corresponding ale field values. + . preview:[] (Optional, https://www.elastic.co/pricing[Platinum or higher subscription] required) Select *Suppress alerts* to reduce the number of repeated or duplicate alerts created by the rule. Refer to <> for more information. ++ + +//// +The following step is repeated across all rule types. If you change anything +in the step or its sub-steps, apply the change to the other rule types, too. +//// +. (Optional) To associate the rule with one or more {integrations-docs}[Elastic integrations], click *Add integration* under *Related integrations*, then: +.. Select an integration from the list. +.. Enter the version of the integration you want associated with the rule, using https://semver.org[semantic versioning]. For version ranges, you must use tilde or caret syntax. For example, `~1.2.3` is from 1.2.3 to any patch version less than 1.3.0, and `^1.2.3` is from 1.2.3 to any minor and patch version less than 2.0.0. . Click *Continue* to <>. @@ -259,6 +305,15 @@ IMPORTANT: When checking multiple fields, each unique combination of values from For example, if a rule has an interval of 5 minutes, no additional look-back time, and a history window size of 7 days, a term will be considered new only if the time it appears within the last 7 days is also within the last 5 minutes. Configure the rule interval and additional look-back time when you <>. . preview:[] (Optional, https://www.elastic.co/pricing[Platinum or higher subscription] required) Use *Suppress alerts by* to reduce the number of repeated or duplicate alerts created by the rule. Refer to <> for more information. ++ + +//// +The following step is repeated across all rule types. If you change anything +in the step or its sub-steps, apply the change to the other rule types, too. +//// +. (Optional) To associate the rule with one or more {integrations-docs}[Elastic integrations], click *Add integration* under *Related integrations*, then: +.. Select an integration from the list. +.. Enter the version of the integration you want associated with the rule, using https://semver.org[semantic versioning]. For version ranges, you must use tilde or caret syntax. For example, `~1.2.3` is from 1.2.3 to any patch version less than 1.3.0, and `^1.2.3` is from 1.2.3 to any minor and patch version less than 2.0.0. . Click *Continue* to <>. @@ -279,6 +334,15 @@ NOTE: Refer to the sections below to learn more about <>. [float] From f2cd74be9909d6093351a5231677bd3b90cd7795 Mon Sep 17 00:00:00 2001 From: Joe Peeples Date: Fri, 3 May 2024 13:33:31 -0400 Subject: [PATCH 2/4] Mention type-ahead --- docs/detections/rules-ui-create.asciidoc | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/docs/detections/rules-ui-create.asciidoc b/docs/detections/rules-ui-create.asciidoc index 650502e935..e038a78ad4 100644 --- a/docs/detections/rules-ui-create.asciidoc +++ b/docs/detections/rules-ui-create.asciidoc @@ -52,7 +52,7 @@ The following step is repeated across all rule types. If you change anything in the step or its sub-steps, apply the change to the other rule types, too. //// . (Optional) To associate the rule with one or more {integrations-docs}[Elastic integrations], click *Add integration* under *Related integrations*, then: -.. Select an integration from the list. +.. Select an integration from the list. You can also start typing an integration's name to find it faster. .. Enter the version of the integration you want associated with the rule, using https://semver.org[semantic versioning]. For version ranges, you must use tilde or caret syntax. For example, `~1.2.3` is from 1.2.3 to any patch version less than 1.3.0, and `^1.2.3` is from 1.2.3 to any minor and patch version less than 2.0.0. . Click **Continue** to <>. @@ -99,7 +99,7 @@ The following step is repeated across all rule types. If you change anything in the step or its sub-steps, apply the change to the other rule types, too. //// . (Optional) To associate the rule with one or more {integrations-docs}[Elastic integrations], click *Add integration* under *Related integrations*, then: -.. Select an integration from the list. +.. Select an integration from the list. You can also start typing an integration's name to find it faster. .. Enter the version of the integration you want associated with the rule, using https://semver.org[semantic versioning]. For version ranges, you must use tilde or caret syntax. For example, `~1.2.3` is from 1.2.3 to any patch version less than 1.3.0, and `^1.2.3` is from 1.2.3 to any minor and patch version less than 2.0.0. . Click **Continue** to <>. @@ -135,7 +135,7 @@ The following step is repeated across all rule types. If you change anything in the step or its sub-steps, apply the change to the other rule types, too. //// . (Optional) To associate the rule with one or more {integrations-docs}[Elastic integrations], click *Add integration* under *Related integrations*, then: -.. Select an integration from the list. +.. Select an integration from the list. You can also start typing an integration's name to find it faster. .. Enter the version of the integration you want associated with the rule, using https://semver.org[semantic versioning]. For version ranges, you must use tilde or caret syntax. For example, `~1.2.3` is from 1.2.3 to any patch version less than 1.3.0, and `^1.2.3` is from 1.2.3 to any minor and patch version less than 2.0.0. . Click *Continue* to <>. @@ -194,7 +194,7 @@ The following step is repeated across all rule types. If you change anything in the step or its sub-steps, apply the change to the other rule types, too. //// . (Optional) To associate the rule with one or more {integrations-docs}[Elastic integrations], click *Add integration* under *Related integrations*, then: -.. Select an integration from the list. +.. Select an integration from the list. You can also start typing an integration's name to find it faster. .. Enter the version of the integration you want associated with the rule, using https://semver.org[semantic versioning]. For version ranges, you must use tilde or caret syntax. For example, `~1.2.3` is from 1.2.3 to any patch version less than 1.3.0, and `^1.2.3` is from 1.2.3 to any minor and patch version less than 2.0.0. . Click *Continue* to <>. @@ -257,7 +257,7 @@ The following step is repeated across all rule types. If you change anything in the step or its sub-steps, apply the change to the other rule types, too. //// . (Optional) To associate the rule with one or more {integrations-docs}[Elastic integrations], click *Add integration* under *Related integrations*, then: -.. Select an integration from the list. +.. Select an integration from the list. You can also start typing an integration's name to find it faster. .. Enter the version of the integration you want associated with the rule, using https://semver.org[semantic versioning]. For version ranges, you must use tilde or caret syntax. For example, `~1.2.3` is from 1.2.3 to any patch version less than 1.3.0, and `^1.2.3` is from 1.2.3 to any minor and patch version less than 2.0.0. . Click *Continue* to <>. @@ -312,7 +312,7 @@ The following step is repeated across all rule types. If you change anything in the step or its sub-steps, apply the change to the other rule types, too. //// . (Optional) To associate the rule with one or more {integrations-docs}[Elastic integrations], click *Add integration* under *Related integrations*, then: -.. Select an integration from the list. +.. Select an integration from the list. You can also start typing an integration's name to find it faster. .. Enter the version of the integration you want associated with the rule, using https://semver.org[semantic versioning]. For version ranges, you must use tilde or caret syntax. For example, `~1.2.3` is from 1.2.3 to any patch version less than 1.3.0, and `^1.2.3` is from 1.2.3 to any minor and patch version less than 2.0.0. . Click *Continue* to <>. @@ -340,7 +340,7 @@ The following step is repeated across all rule types. If you change anything in the step or its sub-steps, apply the change to the other rule types, too. //// . (Optional) To associate the rule with one or more {integrations-docs}[Elastic integrations], click *Add integration* under *Related integrations*, then: -.. Select an integration from the list. +.. Select an integration from the list. You can also start typing an integration's name to find it faster. .. Enter the version of the integration you want associated with the rule, using https://semver.org[semantic versioning]. For version ranges, you must use tilde or caret syntax. For example, `~1.2.3` is from 1.2.3 to any patch version less than 1.3.0, and `^1.2.3` is from 1.2.3 to any minor and patch version less than 2.0.0. . Click *Continue* to <>. From 6e047d0d97f791057ad6b1dcd63328fd5993d3fd Mon Sep 17 00:00:00 2001 From: Joe Peeples Date: Tue, 7 May 2024 10:25:23 -0400 Subject: [PATCH 3/4] Apply feedback from serverless twin PR https://github.com/elastic/staging-serverless-security-docs/pull/337 --- .../prebuilt-rules-management.asciidoc | 18 ------------ docs/detections/rules-ui-create.asciidoc | 28 +++++++++---------- docs/detections/rules-ui-manage.asciidoc | 19 +++++++++++++ 3 files changed, 33 insertions(+), 32 deletions(-) diff --git a/docs/detections/prebuilt-rules-management.asciidoc b/docs/detections/prebuilt-rules-management.asciidoc index 12a6635633..7adb34db43 100644 --- a/docs/detections/prebuilt-rules-management.asciidoc +++ b/docs/detections/prebuilt-rules-management.asciidoc @@ -116,21 +116,3 @@ image::images/prebuilt-rules-update-diff.png[Prebuilt rule comparison,75%] * Update multiple rules: Select the rules and click *Update _x_ selected rule(s)*. + TIP: Use the search bar and *Tags* filter to find the rules you want to update. For example, filter by `OS: Windows` if your environment only includes Windows endpoints. For more on tag categories, refer to <>. - -[float] -[[rule-prerequisites]] -=== Confirm rule prerequisites - -Many Elastic prebuilt rules are designed to work with specific Elastic integrations and data fields. These prerequisites are identified in the *Related integrations* and *Required fields* fields on a rule's details page (*Rules* -> *Detection rules (SIEM)*, then click a rule's name). *Related integrations* also displays each integration's installation status and includes links for installing and configuring the listed integrations. - -Additionally, the *Setup guide* section provides guidance on setting up the rule's requirements. - -[role="screenshot"] -image::images/rule-details-prerequisites.png[Rule details page with Related integrations, Required fields, and Setup guide highlighted] - -You can also check rules' related integrations in the *Installed Rules* and *Rule Monitoring* tables. Click the *integrations* badge to display the related integrations in a popup. - -[role="screenshot"] -image::images/rules-table-related-integrations.png[Rules table with related integrations popup,75%] - -TIP: You can hide the *integrations* badge in the rules tables. Go to *{kib}* -> *Stack Management* -> *Advanced Settings*, then turn off `securitySolution:showRelatedIntegrations`. diff --git a/docs/detections/rules-ui-create.asciidoc b/docs/detections/rules-ui-create.asciidoc index bf58fcf484..f58e5a21ed 100644 --- a/docs/detections/rules-ui-create.asciidoc +++ b/docs/detections/rules-ui-create.asciidoc @@ -51,8 +51,8 @@ NOTE: If a required job isn't currently running, it will automatically start whe The following step is repeated across all rule types. If you change anything in the step or its sub-steps, apply the change to the other rule types, too. //// -. (Optional) To associate the rule with one or more {integrations-docs}[Elastic integrations], click *Add integration* under *Related integrations*, then: -.. Select an integration from the list. You can also start typing an integration's name to find it faster. +. (Optional) Add *Related integrations* to associate the rule with one or more {integrations-docs}[Elastic integrations]. This indicates the rule's dependency on specific integrations and their data types, and allows users to confirm each integration's <> when viewing the rule. +.. Click *Add integration*, then select an integration from the list. You can also start typing an integration's name to find it faster. .. Enter the version of the integration you want associated with the rule, using https://semver.org[semantic versioning]. For version ranges, you must use tilde or caret syntax. For example, `~1.2.3` is from 1.2.3 to any patch version less than 1.3.0, and `^1.2.3` is from 1.2.3 to any minor and patch version less than 2.0.0. . Click **Continue** to <>. @@ -98,8 +98,8 @@ When you use a saved query, the *Load saved query "_query name_" dynamically on The following step is repeated across all rule types. If you change anything in the step or its sub-steps, apply the change to the other rule types, too. //// -. (Optional) To associate the rule with one or more {integrations-docs}[Elastic integrations], click *Add integration* under *Related integrations*, then: -.. Select an integration from the list. You can also start typing an integration's name to find it faster. +. (Optional) Add *Related integrations* to associate the rule with one or more {integrations-docs}[Elastic integrations]. This indicates the rule's dependency on specific integrations and their data types, and allows users to confirm each integration's <> when viewing the rule. +.. Click *Add integration*, then select an integration from the list. You can also start typing an integration's name to find it faster. .. Enter the version of the integration you want associated with the rule, using https://semver.org[semantic versioning]. For version ranges, you must use tilde or caret syntax. For example, `~1.2.3` is from 1.2.3 to any patch version less than 1.3.0, and `^1.2.3` is from 1.2.3 to any minor and patch version less than 2.0.0. . Click **Continue** to <>. @@ -134,8 +134,8 @@ IMPORTANT: Alerts created by threshold rules are synthetic alerts that do not re The following step is repeated across all rule types. If you change anything in the step or its sub-steps, apply the change to the other rule types, too. //// -. (Optional) To associate the rule with one or more {integrations-docs}[Elastic integrations], click *Add integration* under *Related integrations*, then: -.. Select an integration from the list. You can also start typing an integration's name to find it faster. +. (Optional) Add *Related integrations* to associate the rule with one or more {integrations-docs}[Elastic integrations]. This indicates the rule's dependency on specific integrations and their data types, and allows users to confirm each integration's <> when viewing the rule. +.. Click *Add integration*, then select an integration from the list. You can also start typing an integration's name to find it faster. .. Enter the version of the integration you want associated with the rule, using https://semver.org[semantic versioning]. For version ranges, you must use tilde or caret syntax. For example, `~1.2.3` is from 1.2.3 to any patch version less than 1.3.0, and `^1.2.3` is from 1.2.3 to any minor and patch version less than 2.0.0. . Click *Continue* to <>. @@ -193,8 +193,8 @@ NOTE: For sequence events, the {security-app} generates a single alert when all The following step is repeated across all rule types. If you change anything in the step or its sub-steps, apply the change to the other rule types, too. //// -. (Optional) To associate the rule with one or more {integrations-docs}[Elastic integrations], click *Add integration* under *Related integrations*, then: -.. Select an integration from the list. You can also start typing an integration's name to find it faster. +. (Optional) Add *Related integrations* to associate the rule with one or more {integrations-docs}[Elastic integrations]. This indicates the rule's dependency on specific integrations and their data types, and allows users to confirm each integration's <> when viewing the rule. +.. Click *Add integration*, then select an integration from the list. You can also start typing an integration's name to find it faster. .. Enter the version of the integration you want associated with the rule, using https://semver.org[semantic versioning]. For version ranges, you must use tilde or caret syntax. For example, `~1.2.3` is from 1.2.3 to any patch version less than 1.3.0, and `^1.2.3` is from 1.2.3 to any minor and patch version less than 2.0.0. . Click *Continue* to <>. @@ -256,8 +256,8 @@ field values. The following step is repeated across all rule types. If you change anything in the step or its sub-steps, apply the change to the other rule types, too. //// -. (Optional) To associate the rule with one or more {integrations-docs}[Elastic integrations], click *Add integration* under *Related integrations*, then: -.. Select an integration from the list. You can also start typing an integration's name to find it faster. +. (Optional) Add *Related integrations* to associate the rule with one or more {integrations-docs}[Elastic integrations]. This indicates the rule's dependency on specific integrations and their data types, and allows users to confirm each integration's <> when viewing the rule. +.. Click *Add integration*, then select an integration from the list. You can also start typing an integration's name to find it faster. .. Enter the version of the integration you want associated with the rule, using https://semver.org[semantic versioning]. For version ranges, you must use tilde or caret syntax. For example, `~1.2.3` is from 1.2.3 to any patch version less than 1.3.0, and `^1.2.3` is from 1.2.3 to any minor and patch version less than 2.0.0. . Click *Continue* to <>. @@ -311,8 +311,8 @@ For example, if a rule has an interval of 5 minutes, no additional look-back tim The following step is repeated across all rule types. If you change anything in the step or its sub-steps, apply the change to the other rule types, too. //// -. (Optional) To associate the rule with one or more {integrations-docs}[Elastic integrations], click *Add integration* under *Related integrations*, then: -.. Select an integration from the list. You can also start typing an integration's name to find it faster. +. (Optional) Add *Related integrations* to associate the rule with one or more {integrations-docs}[Elastic integrations]. This indicates the rule's dependency on specific integrations and their data types, and allows users to confirm each integration's <> when viewing the rule. +.. Click *Add integration*, then select an integration from the list. You can also start typing an integration's name to find it faster. .. Enter the version of the integration you want associated with the rule, using https://semver.org[semantic versioning]. For version ranges, you must use tilde or caret syntax. For example, `~1.2.3` is from 1.2.3 to any patch version less than 1.3.0, and `^1.2.3` is from 1.2.3 to any minor and patch version less than 2.0.0. . Click *Continue* to <>. @@ -337,8 +337,8 @@ TIP: Click the help icon (image:images/esql-ref-button.png[Click the ES|QL help The following step is repeated across all rule types. If you change anything in the step or its sub-steps, apply the change to the other rule types, too. //// -. (Optional) To associate the rule with one or more {integrations-docs}[Elastic integrations], click *Add integration* under *Related integrations*, then: -.. Select an integration from the list. You can also start typing an integration's name to find it faster. +. (Optional) Add *Related integrations* to associate the rule with one or more {integrations-docs}[Elastic integrations]. This indicates the rule's dependency on specific integrations and their data types, and allows users to confirm each integration's <> when viewing the rule. +.. Click *Add integration*, then select an integration from the list. You can also start typing an integration's name to find it faster. .. Enter the version of the integration you want associated with the rule, using https://semver.org[semantic versioning]. For version ranges, you must use tilde or caret syntax. For example, `~1.2.3` is from 1.2.3 to any patch version less than 1.3.0, and `^1.2.3` is from 1.2.3 to any minor and patch version less than 2.0.0. . Click *Continue* to <>. diff --git a/docs/detections/rules-ui-manage.asciidoc b/docs/detections/rules-ui-manage.asciidoc index ff1af14d36..6cf5ceca97 100644 --- a/docs/detections/rules-ui-manage.asciidoc +++ b/docs/detections/rules-ui-manage.asciidoc @@ -19,6 +19,7 @@ On the Rules page, you can: * <> * <> * <> +* <> * <> [float] @@ -159,3 +160,21 @@ NOTE: Imported rules must be in an `.ndjson` file. .. (Optional) Select *Overwrite existing connectors with conflicting action "id"* to update existing connectors if they match the `action id` value of any rule actions in the import file. Configuration data included with the actions is also overwritten. .. Click *Import rule*. .. (Optional) If a connector is missing sensitive information after the import, a warning displays and you're prompted to fix the connector. In the warning, click *Go to connector*. On the Connectors page, find the connector that needs to be updated, click *Fix*, then add the necessary details. + +[float] +[[rule-prerequisites]] +=== Confirm rule prerequisites + +Many detection rules are designed to work with specific {integrations-docs}[Elastic integrations] and data fields. These prerequisites are identified in the *Related integrations* and *Required fields* fields on a rule's details page (*Rules* -> *Detection rules (SIEM)*, then click a rule's name). *Related integrations* also displays each integration's installation status and includes links for installing and configuring the listed integrations. + +Additionally, the *Setup guide* section provides guidance on setting up the rule's requirements. + +[role="screenshot"] +image::images/rule-details-prerequisites.png[Rule details page with Related integrations, Required fields, and Setup guide highlighted] + +You can also check rules' related integrations in the *Installed Rules* and *Rule Monitoring* tables. Click the *integrations* badge to display the related integrations in a popup. + +[role="screenshot"] +image::images/rules-table-related-integrations.png[Rules table with related integrations popup,75%] + +TIP: You can hide the *integrations* badge in the rules tables. Go to *{kib}* -> *Stack Management* -> *Advanced Settings*, then turn off `securitySolution:showRelatedIntegrations`. From 731bb122819f43f008663fdf51dba6580bb00076 Mon Sep 17 00:00:00 2001 From: Joe Peeples Date: Tue, 7 May 2024 11:25:27 -0400 Subject: [PATCH 4/4] Apply changes from Ben's review --- docs/detections/rules-ui-create.asciidoc | 28 ++++++++++++------------ docs/detections/rules-ui-manage.asciidoc | 2 +- 2 files changed, 15 insertions(+), 15 deletions(-) diff --git a/docs/detections/rules-ui-create.asciidoc b/docs/detections/rules-ui-create.asciidoc index f58e5a21ed..8668ba059b 100644 --- a/docs/detections/rules-ui-create.asciidoc +++ b/docs/detections/rules-ui-create.asciidoc @@ -51,9 +51,9 @@ NOTE: If a required job isn't currently running, it will automatically start whe The following step is repeated across all rule types. If you change anything in the step or its sub-steps, apply the change to the other rule types, too. //// -. (Optional) Add *Related integrations* to associate the rule with one or more {integrations-docs}[Elastic integrations]. This indicates the rule's dependency on specific integrations and their data types, and allows users to confirm each integration's <> when viewing the rule. +. (Optional) Add *Related integrations* to associate the rule with one or more {integrations-docs}[Elastic integrations]. This indicates the rule's dependency on specific integrations and the data they generate, and allows users to confirm each integration's <> when viewing the rule. .. Click *Add integration*, then select an integration from the list. You can also start typing an integration's name to find it faster. -.. Enter the version of the integration you want associated with the rule, using https://semver.org[semantic versioning]. For version ranges, you must use tilde or caret syntax. For example, `~1.2.3` is from 1.2.3 to any patch version less than 1.3.0, and `^1.2.3` is from 1.2.3 to any minor and patch version less than 2.0.0. +.. Enter the version of the integration you want to associate with the rule, using https://semver.org[semantic versioning]. For version ranges, you must use tilde or caret syntax. For example, `~1.2.3` is from 1.2.3 to any patch version less than 1.3.0, and `^1.2.3` is from 1.2.3 to any minor and patch version less than 2.0.0. . Click **Continue** to <>. @@ -98,9 +98,9 @@ When you use a saved query, the *Load saved query "_query name_" dynamically on The following step is repeated across all rule types. If you change anything in the step or its sub-steps, apply the change to the other rule types, too. //// -. (Optional) Add *Related integrations* to associate the rule with one or more {integrations-docs}[Elastic integrations]. This indicates the rule's dependency on specific integrations and their data types, and allows users to confirm each integration's <> when viewing the rule. +. (Optional) Add *Related integrations* to associate the rule with one or more {integrations-docs}[Elastic integrations]. This indicates the rule's dependency on specific integrations and the data they generate, and allows users to confirm each integration's <> when viewing the rule. .. Click *Add integration*, then select an integration from the list. You can also start typing an integration's name to find it faster. -.. Enter the version of the integration you want associated with the rule, using https://semver.org[semantic versioning]. For version ranges, you must use tilde or caret syntax. For example, `~1.2.3` is from 1.2.3 to any patch version less than 1.3.0, and `^1.2.3` is from 1.2.3 to any minor and patch version less than 2.0.0. +.. Enter the version of the integration you want to associate with the rule, using https://semver.org[semantic versioning]. For version ranges, you must use tilde or caret syntax. For example, `~1.2.3` is from 1.2.3 to any patch version less than 1.3.0, and `^1.2.3` is from 1.2.3 to any minor and patch version less than 2.0.0. . Click **Continue** to <>. @@ -134,9 +134,9 @@ IMPORTANT: Alerts created by threshold rules are synthetic alerts that do not re The following step is repeated across all rule types. If you change anything in the step or its sub-steps, apply the change to the other rule types, too. //// -. (Optional) Add *Related integrations* to associate the rule with one or more {integrations-docs}[Elastic integrations]. This indicates the rule's dependency on specific integrations and their data types, and allows users to confirm each integration's <> when viewing the rule. +. (Optional) Add *Related integrations* to associate the rule with one or more {integrations-docs}[Elastic integrations]. This indicates the rule's dependency on specific integrations and the data they generate, and allows users to confirm each integration's <> when viewing the rule. .. Click *Add integration*, then select an integration from the list. You can also start typing an integration's name to find it faster. -.. Enter the version of the integration you want associated with the rule, using https://semver.org[semantic versioning]. For version ranges, you must use tilde or caret syntax. For example, `~1.2.3` is from 1.2.3 to any patch version less than 1.3.0, and `^1.2.3` is from 1.2.3 to any minor and patch version less than 2.0.0. +.. Enter the version of the integration you want to associate with the rule, using https://semver.org[semantic versioning]. For version ranges, you must use tilde or caret syntax. For example, `~1.2.3` is from 1.2.3 to any patch version less than 1.3.0, and `^1.2.3` is from 1.2.3 to any minor and patch version less than 2.0.0. . Click *Continue* to <>. @@ -193,9 +193,9 @@ NOTE: For sequence events, the {security-app} generates a single alert when all The following step is repeated across all rule types. If you change anything in the step or its sub-steps, apply the change to the other rule types, too. //// -. (Optional) Add *Related integrations* to associate the rule with one or more {integrations-docs}[Elastic integrations]. This indicates the rule's dependency on specific integrations and their data types, and allows users to confirm each integration's <> when viewing the rule. +. (Optional) Add *Related integrations* to associate the rule with one or more {integrations-docs}[Elastic integrations]. This indicates the rule's dependency on specific integrations and the data they generate, and allows users to confirm each integration's <> when viewing the rule. .. Click *Add integration*, then select an integration from the list. You can also start typing an integration's name to find it faster. -.. Enter the version of the integration you want associated with the rule, using https://semver.org[semantic versioning]. For version ranges, you must use tilde or caret syntax. For example, `~1.2.3` is from 1.2.3 to any patch version less than 1.3.0, and `^1.2.3` is from 1.2.3 to any minor and patch version less than 2.0.0. +.. Enter the version of the integration you want to associate with the rule, using https://semver.org[semantic versioning]. For version ranges, you must use tilde or caret syntax. For example, `~1.2.3` is from 1.2.3 to any patch version less than 1.3.0, and `^1.2.3` is from 1.2.3 to any minor and patch version less than 2.0.0. . Click *Continue* to <>. @@ -256,9 +256,9 @@ field values. The following step is repeated across all rule types. If you change anything in the step or its sub-steps, apply the change to the other rule types, too. //// -. (Optional) Add *Related integrations* to associate the rule with one or more {integrations-docs}[Elastic integrations]. This indicates the rule's dependency on specific integrations and their data types, and allows users to confirm each integration's <> when viewing the rule. +. (Optional) Add *Related integrations* to associate the rule with one or more {integrations-docs}[Elastic integrations]. This indicates the rule's dependency on specific integrations and the data they generate, and allows users to confirm each integration's <> when viewing the rule. .. Click *Add integration*, then select an integration from the list. You can also start typing an integration's name to find it faster. -.. Enter the version of the integration you want associated with the rule, using https://semver.org[semantic versioning]. For version ranges, you must use tilde or caret syntax. For example, `~1.2.3` is from 1.2.3 to any patch version less than 1.3.0, and `^1.2.3` is from 1.2.3 to any minor and patch version less than 2.0.0. +.. Enter the version of the integration you want to associate with the rule, using https://semver.org[semantic versioning]. For version ranges, you must use tilde or caret syntax. For example, `~1.2.3` is from 1.2.3 to any patch version less than 1.3.0, and `^1.2.3` is from 1.2.3 to any minor and patch version less than 2.0.0. . Click *Continue* to <>. @@ -311,9 +311,9 @@ For example, if a rule has an interval of 5 minutes, no additional look-back tim The following step is repeated across all rule types. If you change anything in the step or its sub-steps, apply the change to the other rule types, too. //// -. (Optional) Add *Related integrations* to associate the rule with one or more {integrations-docs}[Elastic integrations]. This indicates the rule's dependency on specific integrations and their data types, and allows users to confirm each integration's <> when viewing the rule. +. (Optional) Add *Related integrations* to associate the rule with one or more {integrations-docs}[Elastic integrations]. This indicates the rule's dependency on specific integrations and the data they generate, and allows users to confirm each integration's <> when viewing the rule. .. Click *Add integration*, then select an integration from the list. You can also start typing an integration's name to find it faster. -.. Enter the version of the integration you want associated with the rule, using https://semver.org[semantic versioning]. For version ranges, you must use tilde or caret syntax. For example, `~1.2.3` is from 1.2.3 to any patch version less than 1.3.0, and `^1.2.3` is from 1.2.3 to any minor and patch version less than 2.0.0. +.. Enter the version of the integration you want to associate with the rule, using https://semver.org[semantic versioning]. For version ranges, you must use tilde or caret syntax. For example, `~1.2.3` is from 1.2.3 to any patch version less than 1.3.0, and `^1.2.3` is from 1.2.3 to any minor and patch version less than 2.0.0. . Click *Continue* to <>. @@ -337,9 +337,9 @@ TIP: Click the help icon (image:images/esql-ref-button.png[Click the ES|QL help The following step is repeated across all rule types. If you change anything in the step or its sub-steps, apply the change to the other rule types, too. //// -. (Optional) Add *Related integrations* to associate the rule with one or more {integrations-docs}[Elastic integrations]. This indicates the rule's dependency on specific integrations and their data types, and allows users to confirm each integration's <> when viewing the rule. +. (Optional) Add *Related integrations* to associate the rule with one or more {integrations-docs}[Elastic integrations]. This indicates the rule's dependency on specific integrations and the data they generate, and allows users to confirm each integration's <> when viewing the rule. .. Click *Add integration*, then select an integration from the list. You can also start typing an integration's name to find it faster. -.. Enter the version of the integration you want associated with the rule, using https://semver.org[semantic versioning]. For version ranges, you must use tilde or caret syntax. For example, `~1.2.3` is from 1.2.3 to any patch version less than 1.3.0, and `^1.2.3` is from 1.2.3 to any minor and patch version less than 2.0.0. +.. Enter the version of the integration you want to associate with the rule, using https://semver.org[semantic versioning]. For version ranges, you must use tilde or caret syntax. For example, `~1.2.3` is from 1.2.3 to any patch version less than 1.3.0, and `^1.2.3` is from 1.2.3 to any minor and patch version less than 2.0.0. . Click *Continue* to <>. diff --git a/docs/detections/rules-ui-manage.asciidoc b/docs/detections/rules-ui-manage.asciidoc index 6cf5ceca97..84b31152ad 100644 --- a/docs/detections/rules-ui-manage.asciidoc +++ b/docs/detections/rules-ui-manage.asciidoc @@ -165,7 +165,7 @@ NOTE: Imported rules must be in an `.ndjson` file. [[rule-prerequisites]] === Confirm rule prerequisites -Many detection rules are designed to work with specific {integrations-docs}[Elastic integrations] and data fields. These prerequisites are identified in the *Related integrations* and *Required fields* fields on a rule's details page (*Rules* -> *Detection rules (SIEM)*, then click a rule's name). *Related integrations* also displays each integration's installation status and includes links for installing and configuring the listed integrations. +Many detection rules are designed to work with specific {integrations-docs}[Elastic integrations] and data fields. These prerequisites are identified in *Related integrations* and *Required fields* on a rule's details page (*Rules* -> *Detection rules (SIEM)*, then click a rule's name). *Related integrations* also displays each integration's installation status and includes links for installing and configuring the listed integrations. Additionally, the *Setup guide* section provides guidance on setting up the rule's requirements.