[DOCS-12756] add alerting to test suites

content/en/synthetics/test_suites/_index.md

@@ -16,16 +16,16 @@
   text: "Get organized, actionable insights from complex test environments"
 ---
 
-
 ## Overview
 
-Synthetic Monitoring Test Suites let you organize multiple tests into a single collection for simplified management and troubleshooting. Group tests by user journey, environment, location, service, team, or any other dimension that fits your workflow. View aggregated results, identify failing components, and understand application performance across related tests, all from a unified view. 
+Synthetic Monitoring Test Suites let you organize multiple tests into a single collection for simplified management and troubleshooting. Group tests by user journey, environment, location, service, team, or any other dimension that fits your workflow. View aggregated results, identify failing components, and understand application performance across related tests, all from a unified view. Configure suite-level alerting to receive a consolidated notification when a critical portion of your tests fail, helping you respond more efficiently to issues impacting important workflows. 
 
 ## Key features
 
 - **Centralized visibility**: View all tests in a suite and their results in one place.
 - **Simplified management**: Create and run test groups instead of managing individual tests separately.
 - **Easier maintenance**: Identify which tests need updates when application changes are made.
+- **Alerting**: Configure suite-level alerting to receive notifications when critical portions of your tests fail.
 
 ## Create a test suite
 
@@ -42,11 +42,21 @@
    - **Search** by name or tag.  
    - **Filter** by test type (such as Browser, API, Private Location, or Mobile).
    - **Select** one or more tests to include.
-3. Click **Add Selected Tests** to confirm.
-4. Optionally, remove tests using the **Remove Test from Suite** icon next to each entry.
-5. Click **Save suite** when finished.
+3. Click **Add Tests** to confirm.
+4. _Optionally, remove tests using the Remove Test from Suite icon next to each entry_.
+5. Configure alerting for the suite:
+   - By default, all tests are marked as **Critical** and the alert triggers when any critical test fails. 
+
+     **Note**: Suite alerts are separate from individual test alerts. To avoid duplicate notifications, mute alerts on individual tests included in the suite.
+   - To exclude specific tests from triggering the suite-level alert, select them and mark them as **Ignored**.
+   - Adjust the alert threshold to trigger only when a specified percentage of critical tests fail.
+
+   {{< img src="synthetics/test_suites/suite_alerting.png" alt="Suite alerting creation page, with the suite alerting drop-down expanded. " style="width:80%;">}}
+
+6. Configure monitor settings (notification message, recipients, renotification) the same way you would for a single test.
+7. Click **Save suite** when finished.
 
-{{< img src="synthetics/test_suites/test_suite_creation.png" alt="Synthetic Monitoring Test Suite creation page" style="width:80%;">}}
+{{< img src="synthetics/test_suites/test_suite_creation_2.png" alt="Synthetic Monitoring Test Suite creation page" style="width:80%;">}}
 
 ## View and manage
 
@@ -61,7 +71,7 @@
 
 **Note**: Test runs appear in the suite only from the date the test was added. To view earlier results, check the individual test page. If you rename a test, previous runs remain listed under the original name. A maximum of 300 tests can be added per suite.
 
-{{< img src="synthetics/test_suites/test_suite_summary.png" alt="Synthetic Monitoring Test Suite summary page" style="width:100%;">}}
+{{< img src="synthetics/test_suites/test_suite_summary_2.png" alt="Synthetic Monitoring Test Suite summary page" style="width:100%;">}}
 
 ## Troubleshooting