Failover Debugging
When failover doesn't work as expected.
Failover Not Triggering
Check:
- Is failover enabled for the domain?
- Is monitoring paused?
- Is the master actually unreachable?
- Is the slave healthy?
Verify in dashboard:
- Domain settings → Failover Enabled
- Server pair → Both servers online
DNS Not Updating
Possible causes:
- Invalid Cloudflare API token
- Wrong Zone ID
- Cloudflare rate limiting
Debug:
- Check Cloudflare dashboard for DNS records
- Verify API token permissions
- Check backend logs for Cloudflare API errors
Traffic Still Going to Master
Remember: DNS propagation takes time. Check:
- Local DNS cache:
nslookup yourdomain.com - Global propagation: Use online DNS checker
- TTL settings in Cloudflare
Test Failover
Safely test without affecting master:
- Go to domain in dashboard
- Click "Test Failover"
- This updates DNS but doesn't stop master
- Click "Restore" to revert