Library / Case Studies
Airflow at Grab
This blog post focuses on the lessons we learned while building our batch data pipeline.
By Grab engineers · Grab · Added 2026-10-12
All content belongs to Grab engineers / Grab. 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
Grab explains a real system. You should know the basics: caching, queues and replication.
Ideas you will meet
- Distributed Systems
- Consensus, time, failure and the fundamentals of scale-out.
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 · 8 minTime, clocks and ordering of eventsWhy you cannot trust timestamps across machines, and how logical clocks give a safe ordering.Read here
Why time is hard
On one machine, order is easy: the clock only goes forward (mostly). Across machines, there is no shared clock.
- Each machine's clock drifts, and synchronisation (NTP) is only accurate to some milliseconds, sometimes much worse.
- Clocks can jump (corrections, leap seconds, virtual machine pauses).
- Messages take unpredictable time, so "A happened before B" cannot be read from two clocks.
So never use wall-clock timestamps from different machines to order important events (or to decide who wins a conflict, or to measure the timeout of a lock).
Image: National Institute of Standards and Technology (NIST) · Public domain · Source · Wikimedia Commons: NIST-F2 cesium fountain atomic clockWhat we can know: happened-before
Event A happened before B if A could have caused B: same process in order, or a message sent at A and received at B (and transitivity). Events with no such chain are concurrent.
Logical clocks
Lamport clock
Each process keeps a counter. Increase it on each event; attach it to messages; on receiving, set it to
max(local, received) + 1. Guarantee: if A happened before B, thenclock(A) < clock(B). The reverse does not hold, so equal-looking order does not prove causality.Vector clock
Each process keeps a vector of counters, one per process. Comparing two vectors tells you whether one event happened before the other or whether they are concurrent. Used by Dynamo-style stores to detect conflicting writes.
100%Figure SDA-CORE-17-1 · Vector clock · © forcsguy.com
Practical choices
Need Tool A total order of events A single leader, or consensus (Raft, Paxos), or a log such as Kafka partitions Detect concurrent updates Version vectors, or version numbers with conditional writes Merge concurrent edits CRDTs, operational transformation, application-level merge Unique, roughly time-ordered ids Snowflake-style ids (accepting small skew) Real-time bounds Databases that use atomic clocks and wait out uncertainty (such as Spanner) Rules of thumb
- Use monotonic clocks (not wall time) to measure durations on one machine.
- Treat timestamps as approximate and for humans; use versions for correctness.
- Make operations idempotent and commutative where possible, so arrival order matters less.
More on this site
Related reading
- Time, Clocks, and the Ordering of Events in a Distributed System (paper)Leslie Lamport · Microsoft ResearchPapers
- Spanner: Google's Globally Distributed Database (paper)Corbett et al. · GooglePapers
- The Raft Consensus Algorithm (site and visualisation)Diego Ongaro and community · raft.github.ioDocumentation
- In Search of an Understandable Consensus Algorithm (Raft paper)Ongaro and Ousterhout · Stanford UniversityPapers
Show 6 moreShow fewer
- How Ringpop from Uber Engineering Helps Distribute Your ApplicationUber Engineering · UberCase Studies
- Google SRE Book: Managing Critical State (Distributed Consensus)Google SRE team · GoogleBlogs
- The Chubby Lock Service (paper)Mike Burrows · GooglePapers
- Clock Skew when Syncing Password Payloads at DrobboxDrobbox engineers · DrobboxCase Studies
- Airflow at GrabGrab engineers · GrabCase Studies
- OpenTable BlogOpenTable engineers · OpenTableBlogs
Go deeper on this
A path through videos, articles, other case studies and code on the same ideas as Airflow at Grab.
Warm upGet the vocabulary first.
Books · Free from the author
Concurrent and Distributed Systems (Cambridge lecture notes)
Eight lectures on time, broadcast, replication, consensus and transactions, with notes, slides and video. Free from the author under CC BY-SA.
University of CambridgeIntermediate
Books · Free from the author
Computer Networks: A Systems Approach
How networks are built and why: protocols, routing, congestion control and the internet's architecture. The authors publish it free online under CC BY 4.0.
Systems ApproachIntermediate
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 · Free from the author · Read here
Scalable Web Architecture and Distributed Systems
A full chapter on the building blocks of large websites: availability, performance, reliability, scalability, caches, proxies, indexes, load balancers and queues. Free to read here under CC BY 3.0.
The Architecture of Open Source ApplicationsBeginner40 min
Papers · Read here
Facebook’s photo storage
This paper describes Haystack, an object storage system optimized for Facebook’s Photos application. Facebook currently stores over 260 billion images, which translates to over 20 petabytes of data.
USENIXIntermediate
See it in another companyThe same ideas, a different system.
Case Studies · Read here
Aroma: Using ML for Code Recommendation at Facebook
Thousands of engineers write the code to create our apps, which serve billions of people worldwide. This is no trivial task—our services have grown so diverse and complex that the codebase contains…
FacebookIntermediate
Case Studies · Read here
Brooklin: Distributed Service for Near Real-Time Data Streaming at LinkedIn
Brooklin—a distributed service for streaming data in near real-time and at scale—has been running in production at LinkedIn since 2016, powering thousands of data streams and over 2 trillion messages per day. Today, w...
LinkedInIntermediate
Read the codeSee how it looks when it is real.
GitHub
Engineering Blogs
A huge directory of company engineering blogs to learn from real production systems.
kilimchoiIntermediate
GitHub
Awesome Scalability
Curated reading list of articles on the architecture of scalable, reliable systems.
binhnguyennusIntermediate
Keep learning
Loading community…