Cases3 cases
1 to 3 of 3
IL-0231Deleting EKS managed node groups also deleted Karpenter's instance profile, and every Stytch worker node shut downStytch2023- Symptoms
On 23 February 2023 Stytch's EKS worker nodes went Ready:Unknown one after another, Karpenter failed to launch replacement nodes, and with fewer and fewer pods scheduled the Live Stytch API went down for 14 minutes, returning 5XX on every call.
- Trigger
At 14:21 UTC Stytch landed a change to remove unused EKS managed node groups, because it had decided to run its data plane applications fully on nodes provisioned by Karpenter. Because Crossplane resources use an orphan deletion policy, engineers deleted the node groups in the AWS console, first in staging and then in production.
- Root cause
- Component
- Contributing factor
- Detection
Low-urgency alerts that Karpenter could not find the instance profile fired in staging at 16:06 UTC and in production at 17:48 UTC but were not treated as an incident. The incident process started at 20:26 UTC when node launch failures spiked the Karpenter error rate, and Kubernetes monitoring alerts in production followed at 20:44 UTC. The support team flagged the outage at 21:14 UTC.
- Remediation
- Reverted the node group deletion, which recreated the managed node groups
- Manually scaled up one of the Live API node groups with more and much larger nodes and removed its taints
- Removed node selectors from the applications one after another so their pods could be scheduled
- Action items
- Treat Karpenter errors as high-urgency alerts that page the on-call engineer
- Tune cluster alerting thresholds to send a high-urgency page earlier
- Add alerts for nodes that stay NotReady or Unknown for long periods
- Raise the thresholds of other deployment alerts, such as unschedulable pods and replicas not available
- Give Karpenter its own IAM instance profile, separate from the one used by the node groups
- Separate other AWS resources that were shared between uses, specifically IAM and security groups
- Rework the EKS and Karpenter configuration so system instance profiles are unique, static per cluster and generated by Karpenter
- Introduce a cloud visualization tool for engineers making infrastructure changes
- Add live system and product metrics to the status page
- Ask AWS to confirm the undocumented actions and side effects of deleting a node group
- Correct the shared use of IAM roles and security groups across the infrastructure
- Lessons
The IAM role for Karpenter's self-managed nodes should never have been the same as the one for the managed node groups; sharing it is what let the node group deletion break Karpenter, and the roles had been left combined for speed and simplicity when Karpenter was first set up. The hours-long delay between the configuration change and its effect made the incident hard to assess, and AWS confirmed that this delay is expected, so Stytch will allow for it in future IAM instance profile changes.
IL-0191A label selector accidentally added to the Loki distributor Service matched only the new pods of a rollout, which took all write traffic, were OOM-killed and stalled the rolloutGrafana Labs2022- Symptoms
During a rollout of the Grafana Loki distributor Deployment in one Grafana Cloud Logs environment, the write path went down for about 25 minutes. The newly started distributor pods were OOM-killed over and over, never passed their health and readiness checks, and the rollout stopped making progress.
- Trigger
Step 1 of moving the Loki ring off a separately deployed key-value store onto embedded memberlist added a new label, gossip_ring_member: 'true', to the distributor pods and Service, together with a small config change, and the change required a rollout of the distributors.
- Root cause
- Component
- Contributing factor
- Detection
The first clue was kubectl get pods and the kube_deployment_status_replicas_updated metric showing that only 16 of 140 distributor pods had been updated.
- Remediation
- scaled the distributor Deployment out horizontally so the load spread over more pods with the new label and the rollout could continue
- reverted the migration step to end the outage
- set service_ignored_labels:: [$._config.gossip_member_label] and passed it to k.util.serviceFor so the label is no longer copied into the Service selector
- Action items
- Update the function that generates a Service from a Deployment or StatefulSet to handle edge cases, including this one
- Lessons
A Service whose selector is built by copying every label of a workload changes which pods it matches as soon as a new label is added. During a rollout it then matches only the new pods, which receive all the traffic before there are enough of them. A few errors during a rollout in other environments hid the problem, because those environments gave distributors more memory and could absorb the shift. Manifest diffs kept for every pull request made it possible to see that the Service selector had changed.
IL-0011HAProxy ingress piled requests onto the same pods because a Go template visited the backend map in sorted pod IP orderSkyscanner2019- Symptoms
On a Sunday, a team using one of Skyscanner's Kubernetes clusters manually paged the out-of-hours Kubernetes support because their service showed elevated latency, worst at the p90 and maximum levels.
- Trigger
Upgrading the HAProxy ingress controller to v0.6 and going back from Service virtual IPs to individual pod IPs as backends, on the understanding that the sort-backends flag introduced in v0.5, false by default, meant backends were randomly shuffled.
- Root cause
- Component
- Contributing factor
- Detection
A cluster user manually paged the out-of-hours Kubernetes support about elevated latency; Prometheus queries then showed the uneven request distribution across pods.
- Remediation
- switched the affected service from pod IPs back to the Service virtual IP through a config change in the internal deployment tool Slingshot
- patched the controller to keep each backend's servers in an insertion-ordered slice and changed the template to iterate over that slice
- tested the patch in sandbox clusters and rolled it out to the production clusters
- Action items
- Run the internal controller patch in production and return to pod IPs as the default backends
- Raise the problem upstream with a GitHub issue and pull request
- Test changes to cluster components against the specific behaviour and conditions that matter
- Lessons
The team already knew that sorted backends cause hot-podding and still did not test the new flag well enough to see that it did not work; changes to cluster components need tests aimed at the exact behaviour that matters, under conditions like production. A keyword can behave differently in different parts of a language: range over a map is unordered in Go code but sorted in text/template. A small cluster component can do outsized harm to every user of the cluster and, in the end, to customers.
These 3 cases involve Configuration templating and HAProxy. 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 cause2
Configuration change2 cases
- Contributing factor
- Organisation
IL-0231Deleting EKS managed node groups also deleted Karpenter's instance profile, and every Stytch worker node shut downStytch2023IL-0191A label selector accidentally added to the Loki distributor Service matched only the new pods of a rollout, which took all write traffic, were OOM-killed and stalled the rolloutGrafana Labs2022
Software defect1 case
- Contributing factor
- Organisation