Test Outage
On this page
Note
This feature is not available for
M0free clusters,M2, andM5clusters. To learn more, see Atlas M0 (Free Cluster), M2, and M5 Limitations.This feature is not supported on Serverless instances at this time. To learn more, see Serverless Instance Limitations.
You can use the Atlas UI and API to test an outage on your Atlas multi-region cluster and observe how your application handles an outage in one or more regions.
Test Outage Process
When you submit a request to test an outage using the Atlas UI or API, Atlas simulates an outage event. During this process, Atlas removes network connectivity to nodes in the selected regions.
Test Outage Using the Atlas UI
To perform a Test Outage in the Atlas UI:
Log in to the Atlas UI.
Click Database.
For the cluster you wish to perform outage testing, click the ... button.
Click Test Outage.
Select Regional Outage. Atlas displays a Test Outage modal with the steps Atlas takes to simulate an outage event. To learn more, see Test Outage Process.
Click Select Regions.
Select the tab corresponding to the type of outage you want to simulate:
Select Simulate Regional Outage to begin the test. Atlas notifies you when the outage occurs.
Select a tab corresponding to the type of outage you are performing:
Test Outage Using the API
You can use the Test Outage API endpoint to simulate an outage event. To learn more about the outage process, see Test Outage Process.
Verify the Outage
To verify that the outage is successful, monitor your application and ensure your read and write operations are working as expected.