Library / Case Studies
Profiling C++ (Part 1: Optimization, Part 2: Measurement and Analysis) at Riot Games
Hi, I’m Tony Albrecht, an engineer at Riot, and I’m a performance junkie. This is the second part in a series on how to optimise your code. In Part 1, Measurement and Analysis , we learned how to find and analyse performance bottlenecks in…
By Riot Games engineers · Riot Games · Added 2026-10-12
All content belongs to Riot Games engineers / Riot Games. 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
Riot Games explains a real system. You should know the basics: caching, queues and replication.
Ideas you will meet
- Databases
- Schemas, indexes, query plans and choosing a store.
What we already know about this
Our own lessons on these ideas. Read them here before you start, so it makes sense.
Core Concepts: How Things Actually Work · 9 minTransactions and isolation levelsHow databases keep concurrent updates from corrupting each other, and the anomalies each isolation level allows.Read here
What a transaction is
A transaction groups several operations so they are treated as one unit. The classic guarantees are ACID:
- Atomicity: all or nothing.
- Consistency: rules (constraints) always hold afterwards.
- Isolation: concurrent transactions do not see each other's half-done work.
- Durability: once committed, it survives a crash.
Isolation is the subtle one, because perfect isolation is expensive.
What can go wrong when transactions overlap
Anomaly What happens Dirty read You read data another transaction has not committed (and may roll back) Non-repeatable read You read a row twice and it changed in between Phantom read You run the same query twice and new matching rows appear Lost update Two transactions read, then both write, and one overwrites the other Isolation levels
Databases offer levels that trade safety for speed:
Level Prevents Still allows Read uncommitted nothing much dirty reads and more Read committed (a common default) dirty reads non-repeatable and phantom reads Repeatable read dirty and non-repeatable reads phantoms (varies by database) Serializable all of the above nothing, but slower or more retries The exact behaviour differs between databases, so read your database's documentation instead of assuming.
100%Figure SDA-CORE-02-1 · Isolation levels · © forcsguy.com
How databases implement it
- Locks: readers and writers wait for each other. Simple, but can block and deadlock.
- MVCC (multi-version concurrency control): each transaction sees a consistent snapshot while writers create new versions. Readers do not block writers. Used by PostgreSQL, MySQL (InnoDB) and others.
Two mechanisms keep concurrent transactions apart. Locks make others wait; row versions let readers carry on:
100%Figure SDA-CORE-02-2 · Locks versus row versions · © forcsguy.com
A multi-version example
Say row X holds 100 at version 1. Transaction A begins and takes a snapshot. Transaction B updates X to 150, creating version 2, and commits. A still reads 100 because its snapshot predates version 2, while a transaction started afterwards reads 150. Readers never block writers; old versions are cleaned up once no snapshot needs them.
Practical advice
- Keep transactions short. Long ones hold locks and snapshots and hurt everyone.
- Prefer conditional updates (
WHERE seats > 0) over read-then-write in application code. - Be ready to retry on serialization failures and deadlocks.
- Across several databases or services there is no single transaction: use patterns such as sagas (later lessons).
Real-world reading
Related reading
- Workload isolation using shuffle shardingAmazon Builders' Library · Amazon Web ServicesBlogs
- How Discord Stores Billions of MessagesDiscordCase Studies
- Cross Shard Transactions at 10 Million RPS at DropboxDropbox engineers · DropboxCase Studies
- HaloDB: Embedded Key-Value Storage Engine at YahooYahoo engineers · YahooCase Studies
Show 6 moreShow fewer
- Explaining Low-Level Systems (OS, Network/Protocol, Database, Storage)Wustl engineers · WustlBlogs
- GitHub EngineeringGitHub engineers · GitHubBlogs
- Profiling C++ (Part 1: Optimization, Part 2: Measurement and Analysis) at Riot GamesRiot Games engineers · Riot GamesCase Studies
- VitessCNCF / Vitess · GitHubGitHub
- 8th Light Engineering Blog8th Light engineers · 8th LightBlogs
- Service Mesh at SnapSnap engineers · SnapCase Studies
Databases Deep Dive · 12 minReplication topologies and multi-region databasesSingle-leader, multi-leader and leaderless replication, how they handle conflicts and lag, and what changes across regions.Read here
Why replicate
Replication keeps copies of data on several machines for three reasons: availability (survive a node failure), read scaling (serve reads from replicas) and latency (put data near users). The hard part is keeping copies consistent while writes continue. (Basics are in the replication and sharding lesson of the foundations course; this lesson compares the topologies.)
Single-leader (primary and replicas)
One node, the leader (primary or master), accepts writes and ships its changes to followers (replicas), which serve reads.
100%Figure SDA-DDV-04-1 · Single-leader replication · © forcsguy.com
- Synchronous replication waits for a follower before acknowledging: safer, slower, and a stalled follower can block writes. Asynchronous is faster but a failover can lose the latest writes. A common compromise: one synchronous follower, others asynchronous.
- Failover must detect failure, choose the most up-to-date replica, redirect clients and ensure the old leader does not come back believing it still leads (split brain).
- Replication lag causes stale reads. Techniques: read-your-writes (route a user's reads to the leader shortly after they write), monotonic reads (keep a user on one replica), and checking replica position.
Multi-leader
Several nodes accept writes (often one per region) and replicate to each other. Benefits: local write latency and continued operation if a region is cut off. Cost: write conflicts.
Conflict handling options:
- Avoid them: route all writes for one record to one leader (for example by user or region).
- Last write wins by timestamp: simple, but silently drops one of two concurrent updates and depends on clocks.
- Merge values (union of sets, counters) using mergeable data types (CRDTs; see the collaborative editing lesson).
- Custom resolution in application code, or ask the user.
Multi-leader also appears in offline-capable apps (each device is a leader) and collaborative editing.
Before: single leader
100%After: multi-leader across regions
100%What changed
- Users in each region write to a nearby database
- Concurrent edits to the same row need conflict handling
- More moving parts to run and monitor
Leaderless (Dynamo-style)
Any replica accepts writes; clients write to several replicas and read from several, using quorums (
W + R > N) to get fresh data (see the key-value store lesson). Background anti-entropy and read repair fix stale copies; versions or vector clocks detect conflicts. It favours availability and is typical of Cassandra and DynamoDB-style stores.100%Figure SDA-DDV-04-2 · Choosing a replication model · © forcsguy.com
Multi-region designs
- Active-passive: one region serves writes; another is a warm standby. Simple; failover loses a little data (the replication lag) and takes minutes.
- Active-active: several regions serve traffic. Requires either partitioning data by home region (each record has one home, cross-region reads are replicas) or true multi-leader conflict handling.
- Global databases use consensus across regions (see the consensus lesson) for strong consistency at the cost of cross-region write latency; some offer tunable consistency per query.
- Latency numbers matter: a cross-ocean round trip is around 100 ms or more, so synchronous cross-region replication adds that to every write.
- Data residency laws may require keeping certain users' data in a region.
Partitioning and replication together
Real systems shard data into partitions and replicate each partition (a leader per partition spreads write load across nodes). Rebalancing, hot partitions and cross-partition transactions are the new problems (see sharding and the consistent-hashing lesson).
Master/slave naming
You will see "master/slave", "primary/replica" and "leader/follower" for the same single-leader idea; most current documentation prefers the last two.
Checklist
- What happens to writes if the leader or a region is lost, and how long?
- How much data can we lose (RPO) and how long can we be down (RTO)?
- How do we handle stale reads from replicas?
- Who resolves conflicts, and how?
- Have we practised failover?
Real-world reading
Related reading
- Active-Active for Multi-Regional ResiliencyNetflix Engineering · NetflixCase Studies
- Designing Data-Intensive ApplicationsMartin Kleppmann · O'ReillyBooks
- Read Consistency with Database Replicas at ShopifyShopify engineers · ShopifyCase Studies
- Uber Schemaless: A Scalable MySQL DatastoreUber Engineering · UberCase Studies
Show 6 moreShow fewer
- Mitigating MySQL Replication Lag and Reducing Read Load at GithubGithub engineers · GithubCase Studies
- Cassandra architecture overviewApache Cassandra · Apache Software FoundationDocumentation
- How Discord Stores Trillions of MessagesBo Ingram · DiscordBlogs
- Spanner: Google's Globally Distributed Database (paper)Corbett et al. · GooglePapers
- Scaling Multitenant Architecture Across Multiple Data Centres at Shopify - Weingarten, Engineering Lead at ShopifyShopifyYouTube
- MIT 6.824: Distributed SystemsRobert Morris · MITCourses
Databases Deep Dive · 13 minChoosing a database typeA practical map from workload to database: relational, document, key-value, wide-column, search, graph, time-series and vector stores.Read here
Start from the access pattern
There is no best database; there is a best database for a workload. Ask:
- What are the main queries (by key, by range, by search, by relationship)?
- How much data and how fast does it grow? Read/write ratio?
- What consistency and transaction guarantees are needed?
- What latency is required, and where are users?
- What can your team operate?
The families
100%Figure SDA-DDV-05-1 · Map from need to database family · © forcsguy.com
Relational (PostgreSQL, MySQL)
Tables, SQL, joins, constraints, ACID transactions. The default for most business data. PostgreSQL has rich features (JSON, full-text, extensions, many index types); MySQL is widely deployed and simple to operate. They scale vertically very far, and read replicas and sharding extend them. Choose when data is structured, relationships matter and correctness is critical.
Document (MongoDB and similar)
Stores JSON-like documents; flexible schema; related data can be embedded in one document so a single read gets everything. Good for content, catalogues and objects read whole. Watch for duplicated data, joins you must do in code, and weaker multi-document transaction habits.
Key-value (Redis, Memcached; DynamoDB as a key-value/wide hybrid)
Lookup by key at very low latency. Redis adds data structures (hashes, sorted sets, lists, bitmaps), persistence and clustering (see the Redis lesson). Ideal for caches, sessions, counters, rate limits, leaderboards. Not for ad-hoc queries.
Wide-column and partitioned key stores (Cassandra, DynamoDB, HBase)
Data is partitioned by a partition key across many nodes; you design tables around queries. Excellent write throughput, horizontal scale and availability. Cost: limited query flexibility, careful key design (hot partitions), eventual consistency by default. Good for event logs, messaging history, time-ordered user data.
Search engines (Elasticsearch, OpenSearch, Solr)
Build an inverted index (word to documents) for full-text search, relevance scoring, filters and facets. Usually a secondary copy of data from a primary database, kept in sync. Not a system of record: treat it as a derived index that can be rebuilt.
Graph (Neo4j and others)
Stores nodes and relationships and answers questions that follow connections: friends of friends, fraud rings, recommendations, dependency analysis. Where many-hop traversals would need expensive recursive joins in SQL, a graph database is natural.
Time-series (InfluxDB, TimescaleDB, Prometheus)
Optimised for append-heavy, timestamped data with time-range queries, downsampling and retention. Used for metrics, IoT and finance ticks (see the metrics monitoring lesson). Keep tag cardinality low.
Vector databases (and vector indexes in other databases)
Store embeddings (arrays of numbers representing meaning) and find the nearest neighbours, using approximate indexes (graph-based or clustering) for speed. Used for semantic search and retrieval for AI applications. Many general databases now offer vector indexes, which can be enough for moderate scale and avoids another system.
A quick chooser
Need First choice Business data with relationships and transactions Relational Flexible, self-contained records Document Cache, session, counter, leaderboard Redis Massive write volume, simple access by key Wide-column / DynamoDB-style Full-text search and facets Search engine Many-hop relationship queries Graph Metrics and sensor data Time-series Semantic similarity Vector index Analytics on large history Warehouse or lakehouse (see the big data course) Polyglot persistence and its price
Many systems use several stores, each for what it does best: a relational database as the source of truth, a cache, a search index and a metrics store fed from it. The cost is keeping them in sync (change events, outbox pattern, rebuild jobs), more to operate and more failure modes. Add a store only when a measured need justifies it.
SQL versus NoSQL, honestly
"NoSQL" is a family of different designs, not one thing. Relational databases scale further than many assume; NoSQL stores often give up joins and some consistency for scale and flexibility. Decide on requirements, not fashion. If in doubt, start relational and specialise later.
Questions before committing
- Can we model our top ten queries easily?
- What happens at 10 times the data? At a regional failure?
- How do we back up, restore, migrate and monitor it?
- Does the team know it, and is it supported well on our platform?
Real-world reading
Related reading
- Redis UniversityRedis · Redis Ltd.Courses
- RedisRedis · Redis Ltd.GitHub
- Redis DocumentationRedis · Redis Ltd.Documentation
- Build Your Own XCodeCrafters · GitHubGitHub
Show 6 moreShow fewer
- Redis persistenceRedis · Redis Ltd.Documentation
- Moving Food Feed from Redis to Cassandra at ZomatoZomato engineers · ZomatoCase Studies
- Scale with Redis ClusterRedis · Redis Ltd.Documentation
- Improving key expiration in Redis at TwitterTwitter engineers · TwitterCase Studies
- Migrating MySQL from 5.6 to 8.0 at FacebookFacebook engineers · FacebookCase Studies
- Decreasing RAM Usage by 40% Using jemalloc with Python & Celery at ZapierZapier engineers · ZapierCase Studies
Go deeper on this
A path through videos, articles, other case studies and code on the same ideas as Profiling C++ (Part 1: Optimization, Part 2: Measurement and Analysis) at Riot Games.
Warm upGet the vocabulary first.
Courses · Free from the author
Use The Index, Luke
A free guide to SQL indexing and performance across the major databases.
use-the-index-luke.comIntermediate
Documentation
Cassandra architecture overview
The ring, replication, tunable consistency and the storage engine of Cassandra.
Apache Software FoundationIntermediate
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.
Papers · Read here
Cassandra: A Decentralized Structured Storage System (paper)
The paper describing Cassandra's design: a Dynamo-style ring and replication with a Bigtable-style data model and storage engine.
FacebookIntermediate
Blogs
AWS Big Data Blog
AWS posts and announcements on analytics and data topics, such as Redshift, EMR and Apache Iceberg tables.
Amazon Web ServicesIntermediate
See it in another companyThe same ideas, a different system.
Case Studies · Read here
ELK (Elasticsearch, Logstash, Kibana) Stack
As part of the widespread movement towards open source software, the ELK Stack has become the most common log management platform in the world.
LogzIntermediate
Case Studies · Read here
Fast Order Search using Data Pipeline and Elasticsearch at Yelp
Fast Order Search Using Yelp’s Data Pipeline and Elasticsearch Dmitriy Kunitskiy, Software Engineer Jun 1, 2018 Since its inception in 2013, Yelp has grown its transactions platform to tens of...
YelpIntermediate
Read the codeSee how it looks when it is real.
GitHub
Build Your Own X
Tutorials for building your own Redis, database, Docker, web server and more, to learn how they work.
GitHubIntermediate
GitHub
CockroachDB
A distributed SQL database built on ranges, Raft and MVCC.
GitHubAdvanced
Keep learning
Loading community…