Incident Library
Applied filters SymptomFailover failureClear allEvery case under the filters, with no sentence; newest first.
Suggested filters Search, and the values found in your words appear here.

Graph

  • Root cause
  • Component
  • Symptom
  • Contributing factor
  • Case

Cases16 cases

16 to 16 of 16

  1. Symptoms

    From 12:47 AM PDT on 21 April 2011, a subset of Amazon EBS volumes in one Availability Zone of the US East Region could no longer serve reads or writes, and EC2 instances that tried to use them got stuck as well. AWS called these "stuck" volumes. EBS API calls across the whole US East Region also returned high error rates and latencies during two periods on the first day.

    Trigger

    During a routine network change to upgrade the capacity of the primary EBS network in one Availability Zone, traffic was to be shifted off one of the redundant routers. The shift was executed incorrectly and sent the traffic onto the lower-capacity replication network instead of the other primary router, which could not carry it.

    Root cause
    Component
    Contributing factor
    Remediation
    • Rolled back the incorrect traffic shift, which restored network connectivity
    • Disabled all new Create Volume requests in the affected Availability Zone at 2:40 AM PDT
    • Disabled all communication between the degraded EBS cluster and the EBS control plane from 8:20 AM PDT
    • Stopped EBS servers in the degraded cluster from futilely contacting other servers for free space
    • Changed the EBS control plane so new EBS-backed instance launches stopped failing
    • Moved spare server capacity physically from across the US East Region into the degraded cluster
    • Adjusted the negotiation throttles so the new servers could join without flooding the old ones
    • Built a separate EBS control plane partitioned to the affected zone and finer-grained throttles, then processed the backlog
    • Restored the remaining volumes from S3 snapshots taken early in the event
    • Restored volumes on failed machines that had no snapshot after forensic work
    • Intervened by hand on the RDS multi-AZ instances that did not fail over automatically
    Action items
    • Audit the change process and add automation to prevent the traffic shift mistake
    • Change capacity planning and alarming to keep the extra safety capacity needed for large recovery events
    • Change the retry logic in EBS nodes to back off harder and reconnect to previous replicas instead of searching for new nodes
    • Test and deploy the fix for the race condition that crashed EBS nodes
    • Fix the RDS bug that kept multi-AZ instances from failing over automatically
    • Improve the EBS control plane timeout logic to prevent thread exhaustion when one zone's cluster is slow
    • Make the EBS control plane aware of Availability Zones so it sheds load when over capacity
    • Move more EBS control plane functions into per-cluster services that run in the same zone as the cluster
    • Offer multiple Availability Zones to Amazon VPC customers
    • Provide better tools for building multi-AZ applications that survive the loss of a zone
    • Host free webinars and publish whitepapers on fault-tolerant architecture
    • Build the fine-grained control and throttling used in recovery into the EBS nodes and automate the recovery models
    • Look at changes that keep volumes working while a cluster is degraded, including the ability to take a snapshot of a stuck volume
    • Send more frequent and detailed customer updates and staff developer support more widely during events
    • Develop tools that show through the APIs whether instances are impaired
    Lessons

    AWS writes that with more spare capacity the cluster would have absorbed the re-mirroring requests without a storm, and that it now understands how much capacity large recovery events need. The event also showed that the EBS control plane let a failure in one Availability Zone affect the others, so more work is needed to make zones behave as if completely independent. AWS adds that some customers had critical components in a single zone, and that multi-AZ deployments need to become easier to design and run.

Check your cluster for this

These 16 cases involve Database and Database failover manager. kubegap audits a Kubernetes cluster for gaps like these, read-only, from Claude Code or Codex; its checks cite public reports like the ones in this library.

By root cause9

Software defect4 cases

  1. IL-0310 An Aurora PostgreSQL failover to an upsized reader reversed twice and backend writes failed in read-only transactions
  2. IL-0241 A database shard could not elect a new primary, and the Stripe API failed most requests in two periods on one day
    Stripe2019
  3. IL-0388 A Google Cloud live migration took a Discord Redis primary offline, and the failover broke API instances and then guilds
  4. IL-0303 GitHub's MySQL master failed over to a node with a cold buffer pool during a schema migration and GitHub.com went down
    GitHub2012

Capacity exhaustion3 cases

  1. IL-0544 Wasabi's database cache stopped responding when its queueing service filled up, and S3 failed in all regions
    Wasabi2024
  2. IL-0302 Peak load on GitHub's mysql1 MySQL cluster maxed out its database proxy's connections and stopped writes in March 2022
    GitHub2022
  3. IL-0320 Postmark's primary MySQL disk filled but MySQL kept running, so MySQL-MMM never failed over and sending was delayed

Configuration change1 case

Organisation
  1. IL-0367 Azure Storage in Central US rejected VM disk I/O, taking down VMs and the SQL Database and Cosmos DB services on them

Cloud provider outage2 cases

Organisation
  1. IL-0291 GitLab.com's redis-sidekiq Sentinel could not elect a primary after a GCP host error, so Sidekiq was down for 30 minutes
    GitLab2023
  2. IL-0588 AppOptics metrics APIs returned 5xx as Kafka partitions stayed leaderless after an AWS power event hit their ZooKeeper

Hardware failure2 cases

  1. IL-0289 A failing SSD made updown.io's primary MongoDB about 200 times slower, no failover happened and the site went down
  2. IL-0219 GoCardless's API and Dashboard failed every request for 1 hour 50 minutes when Pacemaker did not promote a replica

DNS or network fault1 case

Organisation
  1. IL-0210 GitHub's MySQL clusters failed over to the US West Coast and the site served slow, stale, inconsistent data for 24 hours
    GitHub2018

unknown1 case

Component
Contributing factor
Organisation
  1. IL-0335 A bugcheck in the primary SQL Server put the Stack Exchange network into read-only mode and then offline for 12 minutes

Faulty deployment1 case

Contributing factor
Organisation
  1. IL-0278 A weekly update put a Redis Cloud management process into an infinite loop, and most nodes of a GCP cluster failed
    Redis2016

Operator error1 case

  1. IL-0337 EBS volumes in one US East Availability Zone got stuck after a network change cut EBS nodes off from their replicas