After canary (2 Nov), this post covers singleflight request coalescing: key design, thundering herds, error fanout, per-waiter timeouts, safe read-only uses, multi-instance leases, cancel policy and how it sits beside cache and backpressure.

एकधाउड्डयनधर्मः: A Metrical Codification of Singleflight Coalescing (with English glosses)

What this post is about

Singleflight ensures concurrent callers for the same expensive work share one in-flight execution.

Topics covered

1. Coalesce identical work
2. Key identity design
3. Thundering herd and soft TTL
4. Shared error policy
5. Per-waiter timeouts
6. Reads not unique writes
7. Suppression metrics
8. Multi-instance leases
9. Cancel versus remaining waiters
10. Cache backpressure links

Sanskrit title

एकधाउड्डयनधर्मः = ekadhā-uḍḍayana-dharmaḥ “dharma of single flight”.

English

Minimizable; Sanskrit-first.

ग्राह्यम् / Keep

१. key by logical work: not too coarse
२. pair with soft TTL: on cache fill
३. define error stickiness: for waiters
४. independent waiter deadlines: always
५. reads and pure compute only: no distinct writes
६. measure suppressions: prove value
७. plan multi-pod herd: lease or edge

त्याज्यम् / Avoid

• singleflight distinct checkout posts
• no per-waiter timeout on hung leader
• local-only coalesce with 500 pods and no lease

पदच्छेदः
एकमेव दुःसाध्यं कार्यं यदि शतं युगपत् पृच्छन्ति । एकधाउड्डयनधर्मस्तस्माद् संघातपठनम् ॥१॥

Word-for-word

Gloss table

English sense
Singleflight coalesces concurrent identical in-flight work into one execution and shares the result with all waiters.

Context / topic
Topic: why singleflight. Distinct from cache which may already be cold for all.

वृत्तमिति: ८-८-८-८।

पदच्छेदः
key = logical operation identity । coarse key stampede residual ॥२॥

Word-for-word

Gloss table

English sense
Choose keys that mean the same expensive work. Too coarse merges unrelated calls; too fine stops helping.

Context / topic
Topic: key design.

वृत्तमिति: ८-८-८-८।

पदच्छेदः
thundering herd on expiry । singleflight + soft TTL ॥३॥

Word-for-word

Gloss table

English sense
Cache expiry often stampedes origin. Combine singleflight with stale-while-revalidate patterns.

Context / topic
Topic: herd control.

वृत्तमिति: ८-८-८-८।

पदच्छेदः
errors shared to waiters carefully । poison one fails all briefly ॥४॥

Word-for-word

Gloss table

English sense
Decide whether failures fan out to waiters and how long a negative result is sticky.

Context / topic
Topic: error fanout.

वृत्तमिति: ८-८-८-८।

पदच्छेदः
timeouts per waiter पृथक् । leader hang सर्वान् मा बध्नातु ॥५॥

Word-for-word

Gloss table

English sense
Each waiter needs its own deadline. One hung leader must not pin every client forever.

Context / topic
Topic: waiter deadlines.

वृत्तमिति: एकादशाक्षराः पादाः।

पदच्छेदः
not for unique user writes । coalesce reads and pure compute ॥६॥

Word-for-word

Gloss table

English sense
Do not singleflight distinct mutating requests. Coalesce cache fills and idempotent pure compute.

Context / topic
Topic: safe use cases.

वृत्तमिति: ८-८-८-८।

पदच्छेदः
metrics: in-flight shared suppressed । invisible savings अन्धता ॥७॥

Word-for-word

Gloss table

English sense
Count how many calls were suppressed. Without that number you cannot prove the pattern earns its complexity.

Context / topic
Topic: observability.

वृत्तमिति: ८-८-८-८।

पदच्छेदः
distributed singleflight needs lease । local-only multi-pod residual herd ॥८॥

Word-for-word

Gloss table

English sense
Process-local singleflight still herds across pods. Use a short lease or edge coalesce when N is large.

Context / topic
Topic: multi-instance.

वृत्तमिति: ८-८-८-८।

पदच्छेदः
context cancel: leader may finish for others । policy स्पष्टा ॥९॥

Word-for-word

Gloss table

English sense
If the first caller cancels, decide whether work continues for remaining waiters or aborts for all.

Context / topic
Topic: cancellation policy.

वृत्तमिति: ८-८-८-८।

पदच्छेदः
सञ्चयः warm hit एकधा cold stampede । प्रतिदाबः प्रवेश द्वारम् ॥१०॥

Word-for-word

Gloss table

English sense
Caches serve warm hits; singleflight collapses cold stampedes; backpressure still gates total admission when everything is cold.

Context / topic
Topic: series distinctions.

सन्धिः: सञ्चय उष्ण; एकधा शीतसंघातः; दाब द्वार।

वृत्तमिति: एकादशाक्षराः पादाः।

पदच्छेदः
key herd error-timeout multi-instance metrics पञ्चकम् । एभिरेकधाउड्डयनधर्मः संघातपठनसमन्वितः ॥११॥

Word-for-word

Gloss table

English sense
Five limbs: precise keys, herd control with soft TTL, clear error and cancel policy, multi-instance plan and suppression metrics.

Context / topic
Topic: checklist.

वृत्तमिति: ८-८-८-८।

पदच्छेदः
इत्येकधाउड्डयनधर्मसारः संघातपठनसमन्वितः । मितमेककार्यं क्रियायोग्यं तन्त्रधर्मः स उच्यते ॥१२॥

Word-for-word

Gloss table

English sense
Closing: one flight for identical work, many waiters and honest timeouts.

Context / topic
Topic: close.

उपसंहारन्यायः: एकं कुरु; बहून् पायय; कालं पृथक् रक्ष।

वृत्तमिति: ८-८-८-८।

१. Why SF
२. Keys
३. Herd
४. Errors
५. Timeouts
६. Safe cases
७. Metrics
८. Multi-instance
९. Cancel
१०. Series
११. Five limbs
१२. Close

1. Prior: cache 2026-09-07; backpressure 2026-10-07; canary 2026-11-02.
2. Domain: singleflight coalescing.
3. English minimizable; Sanskrit-first.
4. Style: no em dash; no Oxford comma in English clauses.