Create and run a chaos experiment by using Azure Chaos Studio

• 
  

Prerequisites

• An Azure subscription. If you don't have an Azure subscription, create an Azure free account before you begin.
• A Linux VM running an operating system in the Azure Chaos Studio version compatibility list. If you don't have a VM, follow these steps to create one.

Register the Chaos Studio resource provider

If it's your first time using Chaos Studio, you must first register the Chaos Studio resource provider before you onboard the resources and create an experiment. You must do these steps for each subscription where you use Chaos Studio:

1. Open the Azure portal.
2. Search for Subscriptions and open the subscription management page.
3. Select the subscription where you want to use Chaos Studio.
4. In the pane on the left, select Resource providers.
5. In the list of resource providers that appears, search for Microsoft.Chaos.
6. Select the Microsoft.Chaos provider and select the Register button.

Create an Azure resource supported by Chaos Studio

Create an Azure resource and ensure that it's one of the supported fault providers. Also validate if this resource is being created in the region where Chaos Studio is available. In this experiment, we choose an Azure VM, which is one of the supported fault providers for Chaos Studio.

Enable Chaos Studio on the VM you created

1. Open the Azure portal.

2. Search for Chaos Studio in the search bar.

3. Select Targets and go to the VM you created.

4. Select the checkbox next to your VM. Select Enable targets > Enable service-direct targets from the dropdown menu.

   

5. Confirm that the desired resource is listed. Select Review + Enable, then Enable.

6. A notification appears and indicates that the resource selected was successfully enabled.

   

Create an experiment

1. Select Experiments.

   

2. Select Create > New experiment.

3. Fill in the Subscription, Resource Group, and Location boxes where you want to deploy the chaos experiment. Give your experiment a name. Select Next: Experiment designer.

   

4. In the Chaos Studio experiment designer, give a friendly name to your Step and Branch. Select Add action > Add fault.

   

5. Select VM Shutdown from the dropdown list. Then fill in the Duration box with the number of minutes you want the failure to last.

   

6. Select Next: Target resources.

   

7. Select Add.

   

8. Verify that your experiment looks correct and then select Review + create > Create.

   

Give experiment permission to your VM

1. Go to your VM and select Access control (IAM).

   

2. Select Add.

   

3. Select Add role assignment.

   

4. Search for Virtual Machine Contributor and select the role. Select Next.

   

5. Select Managed identity option

6. Choose Select members and search for your experiment name. Select your experiment and choose Select.

   

7. Select Review + assign.

Run the chaos experiment

1. Open the Azure portal:

   • If you're using an @microsoft.com account, go to this website.
   • If you're using an external account, go to this website.

2. Select the checkbox next to the experiment name and select Start Experiment.

   

3. Select Yes to confirm you want to start the chaos experiment.

   

4. (Optional) Select the experiment name to see a detailed view of the execution status of the experiment.

Clean up resources

1. Select the checkbox next to the experiment name and select Delete.

   

2. Select Yes to confirm that you want to delete the experiment.

3. Search the VM that you created on the Azure portal search bar.

   

4. Select Delete to avoid being charged for the resource.