Library / Case Studies
Performance Impact of Removing Out of Band Garbage Collector (OOBGC) at Github
Until last week, GitHub used an Out of Band Garbage Collector (OOBGC) in production. Since removing it, we decreased CPU time across our production machines by 10%. Let’s talk about…
By Github engineers · Github · Added 2026-10-12
All content belongs to Github engineers / Github. We only link to it and give credit. Report a problem
Learn this case study
About 37 min left. Your work is saved as you go.
What you are about to study
Github explains a real system. You should know the basics: caching, queues and replication.
Ideas you will meet
- Observability
- Metrics, logs, traces, SLOs and alerting.
What we already know about this
Our own lessons on these ideas. Read them here before you start, so it makes sense.
System Design Foundations · 9 minObservability and running a systemMetrics, logs and traces, how to define 'healthy' with SLOs, and how to ship changes without breaking things.Read here
You cannot fix what you cannot see
A system you cannot observe is a system you cannot trust. Observability is the ability to understand what is happening inside from the outside. Three kinds of signal work together.
Signal What it is Best for Metrics Numbers over time (requests per second, error rate, CPU) Dashboards, alerts, trends Logs Timestamped records of events Details of what happened Traces The path of one request through many services Finding where time is spent 100%Figure SDA-FND-11-1 · From alert to root cause · © forcsguy.com
What to measure
A simple checklist, the four golden signals:
- Latency: how long requests take (use percentiles).
- Traffic: how much demand there is.
- Errors: how many requests fail.
- Saturation: how full the busiest resource is (CPU, memory, connections, disk, queue depth).
Averages hide pain. If the average is 100 ms but p99 is 4 seconds, one user in a hundred is waiting four seconds, and with many requests per page that is most of your users sometimes.
Defining healthy: SLIs, SLOs, error budgets
- An SLI (indicator) is a measurement, like "fraction of requests answered successfully in under 300 ms".
- An SLO (objective) is the target, like "99.9% over 30 days".
- The error budget is what is left over: 0.1% of requests may fail. While there is budget, ship features; when it runs out, focus on reliability.
Alert on symptoms users feel (error rate, latency) more than on causes (one machine's CPU). Page a human only for things that need action now.
Ship changes safely
Most outages come from changes. Reduce the risk:
- Small, frequent releases are easier to understand and undo than big ones.
- Canary release: send a few percent of traffic to the new version and watch the metrics before going wider.
- Feature flags: deploy code turned off, then enable it gradually, and switch it off instantly if needed.
- Blue-green: keep the old version running so you can switch back in seconds.
- Backwards-compatible changes: database and API changes should work with both old and new code during rollout.
- Fast rollback must be a rehearsed, boring button.
When things go wrong
Have an incident process: someone leads, someone communicates, mitigate first and investigate later. Afterwards write a blameless postmortem that asks "how did our system and process allow this?" rather than "who did this?". That is how reliability actually improves.
A worked example: error budgets and burn rate
Your service has an SLO of 99.9% of requests succeed over 30 days, and it serves 10 million requests a month.
- Error budget: 0.1% of 10,000,000 = 10,000 failed requests may happen in the month before you break the promise.
- Burn rate is how fast you spend it. A burn rate of 1 uses exactly the budget over 30 days. If 5% of requests are failing now, the error rate is 50 times the allowed 0.1%, a burn rate of 50: the whole month's budget is gone in 30 / 50 = 0.6 days, about 14 hours.
- Alert on burn rate, not on a single bad minute. A common pattern watches two windows together: page someone if the burn rate over the last hour is above about 14 and the last 5 minutes agree (a fast burn: 2% of the monthly budget gone in an hour). Open a ticket for a slower burn, say rate above 6 over 6 hours. Two windows avoid paging for blips and avoid missing slow leaks.
Why this beats "alert when error rate is above X": it ties alerts to what users were promised, it pages only when the budget is in danger, and it gives the team a rule for trade-offs: when the budget is healthy, ship faster; when it is nearly spent, slow down and fix reliability.
100%Figure SDA-FND-11-2 · Alerting on how fast the error budget burns · © forcsguy.com
Finding the cause with all three signals
A worked investigation shows why you want metrics, traces and logs together.
- A metric alerts: the checkout success rate dropped and p99 latency rose. Metrics tell you that something is wrong and how bad, cheaply and over time.
- Narrow it down by dimension: break the metric down by region, version and endpoint. Only the new version in one region is affected, a strong hint it is a deploy.
- A trace shows where the time goes: one slow checkout request shows 4.8 of its 5 seconds in a call to the payment provider's tokenisation endpoint.
- Logs give the detail: filter logs by the trace id from that request and read the exact error: a timeout talking to a new tokenisation URL.
- Fix and verify: roll back the version, and watch the metric recover.
100%Figure SDA-FND-11-3 · From an alert to a root cause · © forcsguy.com
The glue is a correlation id (trace id) carried on every request and written into every log line, so you can jump from one signal to the others.
Mistakes people make
- Alerting on causes instead of symptoms. "CPU is 85%" may be fine; "users are seeing errors" never is. Page on symptoms users feel, and use cause metrics for diagnosis.
- Averaging percentiles. The mean of two hosts' p99 is meaningless; merge distributions instead (see the t-digest lesson).
- High-cardinality labels. A label such as
user_idon a metric creates a new time series per user, which can multiply storage and cost by millions. Put such detail in logs or traces. - Logs without structure or ids. Free text is hard to query. Log JSON with a trace id, service and version.
- Dashboards no one owns. A wall of graphs nobody reads is noise. Build a small dashboard per service around the golden signals: latency, traffic, errors and saturation.
- No runbook. An alert that does not say what to check first wastes the first ten minutes of every incident.
Try it yourself
Run any test in the System Builder and read its charts as if they were production graphs: which signal moves first, and which part would you look at next? Build the search metrics lab to practise percentile maths, and read the t-digest lesson for how real systems summarise latency at scale.
Real-world reading
Related reading
- The Site Reliability WorkbookGoogle SRE team · O'Reilly / GoogleBooks
- Feature Toggles (aka Feature Flags)Pete Hodgson · Martin FowlerBlogs
- InfluxData BlogInfluxData engineers · InfluxDataBlogs
- MetricsDB: TimeSeries Database for storing metrics at TwitterTwitter engineers · TwitterCase Studies
Show 6 moreShow fewer
- The Architecture Twitter Uses to Deal with 150M Active Users, 300K QPS, a 22 MB/S Firehose, and Send Tweets in Under 5 SecondsHigh Scalability engineers · High ScalabilityCase Studies
- Steady State: Always Put Logs on Separate DiskMicrosoft engineers · MicrosoftCase Studies
- XCMetrics: All-in-One Tool for Tracking Xcode Build Metrics at SpotifySpotify engineers · SpotifyCase Studies
- Honeycomb BlogHoneycomb engineers · HoneycombBlogs
- BookKeeper: Distributed Log Storage at YahooYahoo engineers · YahooCase Studies
- Analyzing V8 Garbage Collection Logs at AlibabaAlibaba engineers · AlibabaCase Studies
Messaging and Microservice Patterns · 13 minObservability: metrics, SLIs, SLOs and alertingTurning raw signals into targets people can act on: the three pillars, the four golden signals, SLIs, SLOs, error budgets and alerts that wake you only when it matters.Read here
Monitoring versus observability
Monitoring watches known questions ("is the error rate high?"). Observability is the ability to ask new questions of a running system from the data it emits, which matters when failures are unexpected. It rests on three signal types, often called the pillars:
Signal What it is Good for Metrics Numbers over time (counts, rates, durations) Dashboards, alerts, trends; cheap to store Logs Timestamped event records Detail about what happened in one place Traces A request's path across services Finding where time and errors come from Together with context (deploy markers, config changes) they let you move from "something is wrong" to "this is why". (Collection architecture is in the metrics monitoring lesson; instrumentation in the previous lesson.)
What to measure
Two handy checklists:
- The four golden signals (for services): latency (separate successful from failed), traffic (demand), errors (rate of failures) and saturation (how full the most constrained resource is).
- RED for request-driven services (Rate, Errors, Duration) and USE for resources (Utilisation, Saturation, Errors).
Use percentiles (p50, p95, p99) rather than averages for latency, because averages hide the slow tail that users feel (see the latency lesson). Keep label cardinality low (do not label metrics with user ids).
SLIs, SLOs and SLAs
100%Figure SDA-MSV-06-1 · From measurement to promise · © forcsguy.com
- SLI (indicator): a ratio of good events to valid events, such as
successful requests / valid requestsorrequests under 300 ms / all requests. - SLO (objective): a target for the SLI over a window. Few, meaningful SLOs beat many.
- SLA (agreement): the contractual promise and what happens if missed; keep it looser than the SLO so you have room to react.
- Error budget =
1 - SLO. With 99.9 percent over 30 days you may be "down" about 43 minutes. Common reference points: 99 percent ≈ 7.2 hours a month, 99.9 percent ≈ 43 minutes, 99.99 percent ≈ 4.3 minutes.
Using the budget: while budget remains, ship features and take risks; when it is nearly spent, prioritise reliability work. This turns arguments between "ship faster" and "be safer" into a shared, measurable policy.
Alerting that deserves a human
Alert fatigue is a reliability problem: people ignore noisy pages.
- Alert on symptoms, not causes: "users see errors" rather than "one pod restarted". Keep cause metrics for dashboards and diagnosis.
- Every page must be urgent, actionable and with a runbook; if not, make it a ticket or delete it.
- Use burn-rate alerts: page when the error budget is being consumed much faster than allowed (for example 2 percent of a 30-day budget in an hour), ticket for slow burns. Use two windows (short and long) to be fast but not flappy.
- Group and deduplicate related alerts; route by ownership; add severity.
- Review alerts after incidents and prune them regularly.
100%Figure SDA-MSV-06-2 · From signal to action · © forcsguy.com
The tools, in one table
Need Common tools Metrics collection and alert rules Prometheus (pull model), cloud metrics, Datadog Dashboards Grafana, vendor dashboards Logs ELK or OpenSearch stack, Loki, Splunk, cloud logging Traces Jaeger, Zipkin, Tempo, vendor APM Instrumentation standard OpenTelemetry Incident paging PagerDuty, Opsgenie and similar Dashboards that help
One overview per service showing the golden signals and SLO burn; drill-down panels for dependencies and resources; deploy and config markers on graphs; and consistent layout across services so anyone on call can read any of them.
Incidents and learning
Have on-call rotations with clear escalation, runbooks for known failures, and blameless post-incident reviews that produce concrete follow-ups. Practise with game days. Reliability is a process as much as a technology: measure, set targets, spend the budget wisely, and learn from every failure.
Real-world reading
Related reading
- The Site Reliability WorkbookGoogle SRE team · O'Reilly / GoogleBooks
- Google SRE Book: Service Level ObjectivesGoogle SRE team · GoogleBlogs
- Alerting on Service-Level Objectives (SLOs) at SoundCloudSoundCloud engineers · SoundCloudCase Studies
- PrometheusPrometheus · CNCF / PrometheusGitHub
Show 6 moreShow fewer
- Prometheus overviewPrometheus · CNCF / PrometheusDocumentation
- Google SRE Book: Monitoring Distributed SystemsGoogle SRE team · GoogleBlogs
- Grafana LabsGrafana Labs engineers · Grafana LabsBlogs
- Monitoring and Alert System using Graphite and Cabot at HackerEarthHackerEarth engineers · HackerEarthCase Studies
- Kotlin at DoorDashDoorDash engineers · DoorDashCase Studies
- ThirdEye: Monitoring Platform at LinkedInLinkedIn engineers · LinkedInCase Studies
Core Concepts: How Things Actually Work · 8 minChoosing a programming language for a systemWhy 'most popular' is the wrong question, and the criteria that actually decide which language suits which part of a system.Read here
"What is the most popular language?" is a moving target
Rankings such as the Stack Overflow Developer Survey, the TIOBE index and GitHub's Octoverse change every year and measure different things (what people use, search for, or commit). They are useful to understand the job market and ecosystem health, but popularity does not tell you which language fits your system. JavaScript/TypeScript, Python, Java, C#, C++, Go and others consistently rank high, and each is strong at different jobs.
Criteria that actually decide
- Team skills and hiring: productivity today and ability to hire later.
- Ecosystem: libraries, frameworks, tooling, community support for your problem (web, data, mobile, embedded).
- Performance profile: raw speed, memory use, and latency predictability (garbage-collection pauses matter for some systems).
- Concurrency model: threads, async/await, goroutines, actors. Fit with your workload (many connections versus heavy computation).
- Safety and correctness: static types, memory safety, null handling, how many bugs the language prevents.
- Deployment and operations: single binary or runtime, startup time (serverless!), container size, observability support.
- Interoperability and maturity: how well it talks to existing systems; long-term support.
- Cost of change: how easy it is to refactor and onboard people.
Where each family typically fits
Language Typical strengths Common uses JavaScript / TypeScript Runs in browsers; huge ecosystem; one language front to back; async I/O Web front ends, APIs, tooling, serverless Python Readable; vast data, science and ML libraries Data pipelines, ML, scripting, automation, back ends Java / Kotlin Mature, fast JIT, rich enterprise ecosystem, strong tooling Large back ends, Android (Kotlin), big-data systems C# Productive, strong tooling, good performance Enterprise software, games (Unity), Windows and cloud services Go Simple, fast to compile, excellent concurrency, single binaries Network services, infrastructure, cloud tooling Rust Memory safety without a garbage collector, high performance Performance-critical services, systems, browsers, embedded C / C++ Maximum control and speed Databases, game engines, operating systems, trading systems Swift / Kotlin First-class mobile platforms iOS and Android apps PHP / Ruby Fast web development, large frameworks Websites, content systems, rapid prototyping SQL Declarative data queries Anywhere there is a relational database or warehouse 100%Figure SDA-CORE-22-1 · Where each family typically fits · © forcsguy.com
Polyglot systems
Real systems usually mix languages: a TypeScript web tier, Go or Java services, Python for data and ML, SQL for analytics, and a systems language for the hottest path. This is healthy if boundaries are clean APIs and you accept the costs: more build systems, more skills, more security patching. Do not add a language for novelty.
Practical advice
- Start with what the team knows, unless the problem clearly demands otherwise.
- Benchmark your own workload before choosing on speed claims.
- Prefer boring, well-supported technology for the core, and experiment at the edges.
- Check the hiring market and operational maturity (profilers, debuggers, libraries) for the long term.
- Remember that architecture, data and algorithms usually affect performance far more than the language does.
Real-world reading
Related reading
- Performance Impact of Removing Out of Band Garbage Collector (OOBGC) at GithubGithub engineers · GithubCase Studies
- Performance Optimization by Tuning Garbage CollectionAtlassian engineers · AtlassianCase Studies
- Garbage Collection in Java Applications at LinkedInLinkedIn engineers · LinkedInCase Studies
- Fixing Linux filesystem performance regressions at LinkedInLinkedIn engineers · LinkedInCase Studies
Show 6 moreShow fewer
- Solr: Improving Performance for Batch Indexing at BoxBox engineers · BoxCase Studies
- Performance Optimization on OS, Storage, Database, NetworkStackify engineers · StackifyCase Studies
- Couchbase Ecosystem at LinkedInLinkedIn engineers · LinkedInCase Studies
- Amazon Redshift and the art of performance optimization in the cloudAllthingsdistributed engineers · AllthingsdistributedCase Studies
- Stack Overflow Architecture - High Scalability -High Scalability engineers · High ScalabilityCase Studies
- Systems Performance (2nd edition)Brendan Gregg · PearsonBooks
Go deeper on this
A path through videos, articles, other case studies and code on the same ideas as Performance Impact of Removing Out of Band Garbage Collector (OOBGC) at Github.
Warm upGet the vocabulary first.
Books · Free from the author
Site Reliability Engineering
How Google runs production systems: SLOs, error budgets, monitoring and incident response. Free to read online from Google.
GoogleIntermediate
Books · Free from the author
The Site Reliability Workbook
The practical companion to the SRE book, with worked examples of SLOs, alerting and incident response.
O'Reilly / GoogleIntermediate
WatchHow others solve the same problem, on video.
Videos belong to their creators and play from YouTube. More on YouTube (opens in a new tab)
ReadEngineers explain it in their own words.
Blogs
Implementing health checks
Kinds of health checks, how load balancers use them, and how a careless check can take down a whole fleet.
Amazon Web ServicesIntermediate
Blogs
Dynatrace Blog
Tutorials, tips and resources for engineers on cloud technologies and observability. Learn from the engineers shaping the future of technology.
DynatraceIntermediate
See it in another companyThe same ideas, a different system.
Case Studies · Read here
Improve Zipkin Traces using Kubernetes Pod Metadata at SoundCloud
We revisited our distributed tracing setup and incorporated Kubernetes pod metadata into it, significantly enhancing our engineers’ ability to troubleshoot problems that cut across microservices.
SoundCloudIntermediate
Case Studies · Read here
Monitor DNS systems at Stripe
The secret life of DNS packets: investigating complex networks.
StripeIntermediate
Read the codeSee how it looks when it is real.
GitHub
Jaeger
A distributed tracing system modelled on Dapper.
GitHubIntermediate
GitHub
Prometheus
The source of the metrics monitoring and alerting system.
CNCF / PrometheusIntermediate
Keep learning
Loading community…