Skip to main content

Documentation Index

Fetch the complete documentation index at: https://astronomer-preview.mintlify.app/llms.txt

Use this file to discover all available pages before exploring further.

​
Trigger failover

Failover is also supported using the Astro API.
Running, scheduled, and event-triggered tasks may be impacted during the failover window. Tasks may fail and require a retry.
1
Open the cluster details page
2
In the Astro UI, go to Organization Settings > Clusters and select your primary cluster. In the Disaster Recovery section, confirm the status badge shows Active: [region] (primary).
3
Initiate failover
4
Click the actions menu (⋯) in the Disaster Recovery section and select Failover to Secondary. Follow the prompts to confirm.
5
The secondary cluster is promoted to active, and all Deployments and data become available in the secondary cluster.
6
Validate Deployments
7
After failover completes, check the health and status of your Deployments — especially mission-critical ones. Validate that your Dags and tasks are running as expected and retry any failures if necessary.

​
Trigger failback

After the primary region recovers, you can fail back to the original primary cluster.
Failback is also supported using the Astro API.
Running, scheduled, and event-triggered tasks may be impacted during the failback window. Tasks may fail and require a retry.
1
Open the cluster details page
2
In the Astro UI, go to Organization Settings > Clusters and select your original primary cluster. The Region field shows [region] (Failed over to [secondary region]), confirming the cluster has failed over.
3
Initiate failback
4
Click the actions menu (⋯) in the Disaster Recovery section and select Failback to Primary. Follow the prompts to confirm.

​
Universal Metrics Export in DR pairs

If you have Universal Metrics Export (UME) configured, the same UME configuration applies to both the primary and secondary clusters. Metrics exported from each cluster include a cloud_region attribute so you can distinguish data from each cluster in your metrics system. After failover, update your UME settings if needed to reflect the new active cluster.