After deposit marks (24 Jan), this post covers retries: backoff, jitter, idempotency keys and budgets so recovery does not become a stampede.

पुनर्यत्नधर्मः: A Metrical Codification of Retry Dharma (with English glosses)

What this post is about

Retry is mercy with a meter. Without backoff and a key the mercy becomes a club on the same wound.

Topics

1. Why retry
2. Class first
3. Backoff
4. Jitter
5. Idempotency key
6. Budget cap
7. Give up path
8. Honor Retry-After
9. Not blind loop
10. Five limbs
11. Close
12. Seal

Sanskrit title

पुनर्यत्नधर्मः = dharma of the second effort.

English

Minimizable; Sanskrit-first.

ग्राह्यम् / Keep

१. retry only retryable class: class
२. exponential backoff with ceiling: backoff
३. jitter every attempt: jitter
४. idempotency key on side effects: key
५. hard budget then fail loud: budget

त्याज्यम् / Avoid

• Retry forever on all errors
• No jitter synchronized storms
• POST without idempotency key
• Ignore server Retry-After

पदच्छेदः
पुनर्यत्नः दया मितया सह तस्माद् मापदण्डं । अमिते दया प्रहारे जायते नित्यम् ॥१॥

Word-for-word

Gloss table

English sense
Retry is mercy with a meter; unmetered mercy becomes a club.

Context / topic
why

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

पदच्छेदः
पुनर्योग्यवर्गे एव यतस्व घातकं मा स्पृश । घातके यत्ने ऋणं वर्धते पथि सदा ॥२॥

Word-for-word

Gloss table

English sense
Retry only the retryable class; fatal retries grow debt.

Context / topic
class

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

पदच्छेदः
विरामं वर्धय सोपानेन हि । अन्ते छतं लिख सदा सम्यक् । सहसा मा बाढ़य हि सम्यक् । एवं विरामधर्मः हि सम्यक् ॥३॥

Word-for-word

Gloss table

English sense
Grow pause on steps; write a ceiling; never flood.

Context / topic
backoff

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

पदच्छेदः
प्रत्येकयत्ने कम्पं योजय युगपत् बाढ़ां मा । समयत्ने जालं स्तम्भयति पथि सदा ॥४॥

Word-for-word

Gloss table

English sense
Jitter every attempt; synchronized fleets stampede the net.

Context / topic
jitter

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

पदच्छेदः
पार्श्वप्रभावे एककर्मचिह्नं देहि द्विवारं । अचिह्ने द्विलेखे सत्यं भिद्यते नित्यम् ॥५॥

Word-for-word

Gloss table

English sense
Side effects need an idempotency key; unmarked double-write splits truth.

Context / topic
key

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

पदच्छेदः
यत्नसीमां कठिनां बध्नीहि अनन्ते मा भ्रम । अनन्ते बाढ़ा जालं दहति पथि सदा ॥६॥

Word-for-word

Gloss table

English sense
Hard budget then stop; infinite retry burns the net.

Context / topic
budget

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

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

Word-for-word

Gloss table

English sense
Past budget fail loud with a give-up path; silence blinds clients.

Context / topic
giveup

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

पदच्छेदः
पुनर्यत्नादेशं मानय कालं देहि मा अवज्ञां । अवज्ञायां युद्धं नित्यं जायते नित्यम् ॥८॥

Word-for-word

Gloss table

English sense
Honor Retry-After timing; contempt makes permanent war.

Context / topic
honor

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

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

Word-for-word

Gloss table

English sense
Blind loop retry is not dharma; measured effort is enough.

Context / topic
not blind

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

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

Word-for-word

Gloss table

English sense
Five limbs of retry dharma.

Context / topic
five

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

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

Word-for-word

Gloss table

English sense
Closing: operable recovery under jitter and key law.

Context / topic
close

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

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

Word-for-word

Gloss table

English sense
Class first, back off, jitter, key side effects, never blind loop.

Context / topic
seal

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

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

1. Retry policy
2. Idempotent APIs
3. Prior: schema 24 Jan, fault class 20 Jan