After circuit breakers (16 Nov), this post covers token-bucket rate limiting: refill and burst knobs, fixed-window and leaky contrasts, key design, distributed stores, 429 signals, weighted costs and edge plus service layers versus shed and backpressure.

टोकनकुम्भधर्मः: A Metrical Codification of Token Buckets (with English glosses)

What this post is about

Token buckets bound average admission rate while permitting configured bursts by spending and refilling tokens.

Topics covered

1. Bounded average flow
2. Refill and burst knobs
3. vs fixed window cliffs
4. vs leaky bucket shaping
5. Fair rate keys
6. Distributed shared state
7. 429 and Retry-After
8. Cost-weighted tokens
9. Edge and service layers
10. Shed vs bucket vs backpressure

Sanskrit title

टोकनकुम्भधर्मः = ṭokan-kumbha-dharmaḥ “dharma of the token pot”.

English

Minimizable; Sanskrit-first.

ग्राह्यम् / Keep

१. set refill and burst: two explicit knobs
२. prefer token/sliding: over naive fixed window alone
३. design fair keys: user tenant route
४. shared store multi-node: no N× bypass
५. return 429+Retry-After: honest clients
६. weight heavy ops: more tokens
७. limit edge and service: defense layers

त्याज्यम् / Avoid

• per-pod limits only on 50 replicas without shared state
• silent drop with no 429
• same token cost for ping and full export

पदच्छेदः
अनन्तप्रवेशः यदि क्षणेन पतति तदा मूलं दह्यते । टोकनकुम्भधर्मस्तस्माद् मितप्रवाहः ॥१॥

Word-for-word

Gloss table

English sense
Token buckets admit work only when tokens exist so average rate stays bounded while short bursts remain possible.

Context / topic
Topic: why token bucket. Distinct from load shed under overload and from simple fixed windows.

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

पदच्छेदः
refill rate + burst capacity । rate-only no burst कठोरम् ॥२॥

Word-for-word

Gloss table

English sense
Set sustained refill and maximum burst separately. Many APIs need brief spikes above the long-run mean.

Context / topic
Topic: knobs.

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

पदच्छेदः
fixed window easy boundary burst । token smoother edges ॥३॥

Word-for-word

Gloss table

English sense
Fixed windows allow double-rate at boundaries. Token and sliding designs smooth those cliffs.

Context / topic
Topic: vs fixed window.

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

पदच्छेदः
leaky bucket smooths shape । token allows controlled burst ॥४॥

Word-for-word

Gloss table

English sense
Choose leaky buckets when you must reshape traffic; token buckets when bursts are legitimate.

Context / topic
Topic: vs leaky.

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

पदच्छेदः
key: user IP tenant route स्पष्टम् । one global key अन्यायः ॥५॥

Word-for-word

Gloss table

English sense
Rate keys define fairness. Global-only keys let one tenant starve others; too fine keys explode state.

Context / topic
Topic: keys.

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

पदच्छेदः
distributed bucket needs shared store । per-node only residual bypass ॥६॥

Word-for-word

Gloss table

English sense
Multi-instance gateways need Redis or similar for shared counts or they multiply the effective limit by replica count.

Context / topic
Topic: distributed.

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

पदच्छेदः
return 429 + Retry-After + remaining । silent drop client storm ॥७॥

Word-for-word

Gloss table

English sense
Tell clients they are limited and when to retry. Silent drops invite aggressive client loops.

Context / topic
Topic: client signals.

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

पदच्छेदः
cost-weighted tokens for heavy ops । one-count unequal work ॥८॥

Word-for-word

Gloss table

English sense
Charge more tokens for expensive endpoints so a heavy export cannot equal a cheap ping in cost.

Context / topic
Topic: weighted cost.

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

पदच्छेदः
edge limit + service limit defense । only edge bypass internal ॥९॥

Word-for-word

Gloss table

English sense
Limit at the edge and again per service for internal fans. Edge-only leaves service-to-service floods free.

Context / topic
Topic: layers.

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

पदच्छेदः
भारत्याग overload drop टोकन steady quota । प्रतिदाबः slow send ॥१०॥

Word-for-word

Gloss table

English sense
Load shed is emergency overload triage; token buckets are steady quotas; backpressure slows producers. Different timescales same family.

Context / topic
Topic: series distinctions.

सन्धिः: त्याग आपात; कुम्भ नित्यकोटा; दाब मन्दनम्।

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

पदच्छेदः
knobs keys shared signals weight layers पञ्चकम् । एभिष्टोकनकुम्भधर्मो मितप्रवाहसमन्वितः ॥११॥

Word-for-word

Gloss table

English sense
Five limbs: refill and burst knobs, fair keys, shared distributed state, honest 429 signals and weighted multi-layer limits.

Context / topic
Topic: checklist.

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

पदच्छेदः
इति टोकनकुम्भधर्मसारो मितप्रवाहसमन्वितः । मितं प्रवेशं क्रियायोग्यं तन्त्रधर्मः स उच्यते ॥१२॥

Word-for-word

Gloss table

English sense
Closing: meter the flow, allow honest bursts and tell the client when the bucket is dry.

Context / topic
Topic: close.

उपसंहारन्यायः: टोकन् देहि; स्फोटं मय; ४२९ सत्यं वद।

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

१. Why bucket
२. Knobs
३. vs window
४. vs leaky
५. Keys
६. Distributed
७. Signals
८. Weighted
९. Layers
१०. Series
११. Five limbs
१२. Close

1. Prior: circuit breaker 2026-11-16; load shed 2026-11-05; backpressure 2026-10-07.
2. Domain: token-bucket rate limiting.
3. English minimizable; Sanskrit-first.
4. Style: no em dash; no Oxford comma in English clauses.