Merge pull request #252719 from vikramrajumsft/main

Target selection concept doc

Author: Jak-MS

articles/chaos-studio/TOC.yml

@@ -38,6 +38,8 @@
     href: chaos-studio-faults-actions.md
   - name: Targets and capabilities
     href: chaos-studio-targets-capabilities.md
+  - name: Target selection
+    href: chaos-studio-target-selection.md
   - name: Permissions and security
     href: chaos-studio-permissions-security.md
   - name: Private networking

articles/chaos-studio/chaos-studio-target-selection.md

@@ -0,0 +1,33 @@
+---
+title: Target selection in Azure Chaos Studio Preview
+description: Understand two different ways to select experiment targets in Azure Chaos Studio Preview.
+author: prasha-microsoft
+ms.author: prashabora
+ms.service: chaos-studio
+ms.topic: conceptual
+ms.date: 09/25/2023
+ms.custom: template-concept, ignite-fall-2021, devx-track-arm-template
+---
+
+# Target selection in Azure Chaos Studio Preview
+
+Every chaos experiment is made up of a different combination of faults and targets, building up to a unique outage scenario to test your system's resilience against. You may want to select a fixed set of targets for your chaos experiment, or provide a rule in which all matching fault-onboarded resources are included as targets in your experiment. Chaos Studio enables you to do both by providing both manual and query-based target selection.
+
+## List-based manual target selection
+
+List-based manual target selection allows you to select a fixed set of onboarded targets for a particular fault in your chaos experiment. Depending on the selected fault, you may select one or more onboarded resources to target. The aforementioned resources are added to the experiment upon creation time. In order to modify the list, you must navigate to the experiment's page and add or remove fault targets manually. An example of manual target selection is shown below.
+
+[ ![Screenshot that shows the list-based manual target selection option in the Azure portal.](images/manual-target-selection.png) ](images/manual-target-selection.png#lightbox)
+
+## Query-based dynamic target selection
+
+Query-based dynamic target selection allows you to input a KQL query that will select all onboarded targets that match the query result set. Using your query, you may filter targets based on common Azure resource parameters including type, region, name, and more. Upon experiment creation time, only the query itself will be added to your chaos experiment. 
+
+The inputted query will run and add onboarded targets that match its result set upon experiment execution time. Thus, any resources onboarded to Chaos Studio after experiment creation time that match the query result set upon experiment execution time will be targeted by your experiment. You may preview your query's result set when adding it to your experiment, but be aware that it may not match the result set at experiment execution time. An example of a possible dynamic target query is shown below.
+
+[ ![Screenshot that shows the query-based dynamic target selection option in the Azure portal.](images/dynamic-target-selection-preview.png) ](images/dynamic-target-selection-preview.png#lightbox)
+
+## Next steps
+Now that you understand both ways to select targets within a chaos experiment, you're ready to:
+
+- [Create and run your first experiment](chaos-studio-tutorial-service-direct-portal.md)