Docs Menu

Docs HomeMongoDB Atlas

Test Outage

On this page

  • Test Outage Process
  • Test Outage Using the Atlas UI
  • Test Outage Using the API
  • Verify the Outage


  • This feature is not available for M0 free clusters, M2, and M5 clusters. 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.

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.

To perform a Test Outage in the Atlas UI:

  1. Log in to the Atlas UI.

  2. Click Database.

  3. For the cluster you wish to perform outage testing, click the ... button.

  4. Click Test Outage.

  5. 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.

  6. Click Select Regions.

  7. Select the tab corresponding to the type of outage you want to simulate:

  8. Select Simulate Regional Outage to begin the test. Atlas notifies you when the outage occurs.

  9. Select a tab corresponding to the type of outage you are performing:

You can use the Test Outage API endpoint to simulate an outage event. To learn more about the outage process, see Test Outage Process.

To verify that the outage is successful, monitor your application and ensure your read and write operations are working as expected.

←  Test FailoverManage Connections with AWS Lambda →
Share Feedback
© 2023 MongoDB, Inc.


  • Careers
  • Investor Relations
  • Legal Notices
  • Privacy Notices
  • Security Information
  • Trust Center
© 2023 MongoDB, Inc.