After write streams (4 Feb), this post covers pace fences: admission control, concurrency limits, load shed and token buckets so saying no is kinder than dying yes.

वेगवृतिधर्मः: A Metrical Codification of Pace-Fence Dharma (with English glosses)

What this post is about

A fence on speed protects the garden. Admit what you can finish; shed the rest with a clear face.

Topics

1. Why admit
2. Concurrency cap
3. Token bucket
4. Load shed order
5. Fair queue
6. Retry-After
7. Overload signal
8. Protect core
9. Not infinite accept
10. Five limbs
11. Close
12. Seal

Sanskrit title

वेगवृतिधर्मः = dharma of the pace fence.

English

Minimizable; Sanskrit-first.

ग्राह्यम् / Keep

१. cap in-flight not only RPS: conc
२. shed low priority first: shed
३. return Retry-After on deny: retry
४. protect core paths hardest: core
५. signal overload to clients early: signal

त्याज्यम् / Avoid

• Accept all until OOM
• Shed random without priority
• Deny with no retry hint
• Throttle only at DB last mile

पदच्छेदः
वेगवृतिः उद्यानं रक्षति तस्माद् समाप्यं एव । असमाप्ये स्वीकृतौ मृत्युः सदा नित्यम् ॥१॥

Word-for-word

Gloss table

English sense
A pace fence protects the garden; admit only what you can finish.

Context / topic
why

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

पदच्छेदः
समकालसीमां बध्नीहि केवलवेगमात्रं मा । असमकाले स्मृतिर्दहति पथि सदा ॥२॥

Word-for-word

Gloss table

English sense
Cap in-flight work not RPS alone; unbounded concurrency burns memory.

Context / topic
conc

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

पदच्छेदः
चिह्नकुम्भं योजय सदा सदा । स्फोटं ततः शोधय हि सम्यक् । अनन्तं मा देहि सदा सम्यक् । एवं कुम्भधर्मः सदा सम्यक् ॥३॥

Word-for-word

Gloss table

English sense
Token bucket then repay burst; never infinite tokens.

Context / topic
bucket

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

पदच्छेदः
भारे हीनं पूर्वं त्यज मुख्यं अन्ते रक्ष । अक्रमे त्यागे मूलं म्रियते हि नित्यम् ॥४॥

Word-for-word

Gloss table

English sense
Shed low priority first; protect the core last.

Context / topic
shed

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

पदच्छेदः
न्याय्यपङ्क्तिं देहि मा यदृच्छात्यागम् सदा । यदृच्छायां लघुः म्रियते पथि नित्यम् ॥५॥

Word-for-word

Gloss table

English sense
Fair queues under stress; random drop kills the small.

Context / topic
fair

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

पदच्छेदः
निषेधे पुनर्यत्नकालं वद मा मौनद्वारम् । मौने द्वारे ग्राहको अन्धयुद्ध्यति सदा ॥६॥

Word-for-word

Gloss table

English sense
On deny say Retry-After; silent door makes blind client war.

Context / topic
retry

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

पदच्छेदः
अत्यधिकसंकेतं शीघ्रं देहि मा अन्ते एव । अन्ते संकेते अग्निर्पूर्णः सदा नित्यम् ॥७॥

Word-for-word

Gloss table

English sense
Signal overload early; last-moment signals mean full fire.

Context / topic
signal

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

पदच्छेदः
मूलपथं कठिनतरं रक्ष सामान्यं मृदु । अमूले रक्षे सर्वं नश्यति पथि सदा ॥८॥

Word-for-word

Gloss table

English sense
Guard core paths harder than bulk; unguarded core loses all.

Context / topic
core

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

पदच्छेदः
अनन्तस्वीकृतिर् न धर्मः पथि कदापि । मितप्रवेशः पर्याप्तः पथि हि नित्यम् ॥९॥

Word-for-word

Gloss table

English sense
Infinite accept is not dharma; measured admission is enough.

Context / topic
not infinite

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

पदच्छेदः
प्रवेशं समकालं कुम्भम् सदा । त्यागं पङ्क्तिं कालम् सदा सम्यक् । संकेतं मूलविवेकम् एव । पञ्चाङ्गं वेगवृति उच्यते हि ॥१०॥

Word-for-word

Gloss table

English sense
Five limbs of pace-fence dharma.

Context / topic
five

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

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

Word-for-word

Gloss table

English sense
Closing: operable load under admit-and-shed law.

Context / topic
close

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

पदच्छेदः
समकालं बध्नीहि हीनं पूर्वं त्यज कालं वद । अनन्तं मा वेगधर्मः स उच्यते पथि ॥१२॥

Word-for-word

Gloss table

English sense
Cap concurrency, shed low first, Retry-After, protect core, never infinite yes.

Context / topic
seal

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

१. प्रवेशं तोलय
२. समकालं बध्नीहि
३. कुम्भं योजय
४. हीनं पूर्वं त्यज
५. न्याय्यपङ्क्तिं देहि
६. कालं वद
७. संकेतं देहि
८. मूलं रक्ष
९. पञ्चाङ्गं स्मर
१०. अनन्तं मा
११. सत्यं वेगं
१२. धर्मं धारय

1. Admission control
2. Load shedding
3. Prior: CDC 4 Feb, gateway 26 Jan