After metrics cardinality (12 Nov), this post covers graceful shutdown: ordered SIGTERM steps, readiness before death, bounded drains, mesh and LB coordination, worker nack or checkpoint, stateful flush, aligned grace timers and drain metrics.

अनुग्रहनिरोधधर्मः: A Metrical Codification of Graceful Shutdown (with English glosses)

What this post is about

Graceful shutdown is the ordered exit path that stops new work, drains in-flight requests and hands off jobs before process death.

Topics covered

1. Why sudden death hurts
2. Ordered SIGTERM handling
3. Readiness before liveness kill
4. Bounded drain and cancel
5. Mesh and LB drain
6. Worker checkpoint or nack
7. Stateful flush
8. preStop vs grace alignment
9. In-flight drain metrics
10. Shed vs shutdown vs WAL

Sanskrit title

अनुग्रहनिरोधधर्मः = anugraha-nirodha-dharmaḥ “dharma of gracious stopping”.

English

Minimizable; Sanskrit-first.

ग्राह्यम् / Keep

१. not-ready first: then close listen
२. bound drain time: then cancel clear
३. coordinate LB/mesh drain: with app
४. nack/checkpoint jobs: no ack-then-die
५. flush stateful journals: in grace
६. align hooks and gracePeriod: with slack
७. metric inflight during drain: prove safety

त्याज्यम् / Avoid

• kill ready pods without draining
• ack queue messages then exit immediately
• preStop longer than terminationGracePeriod always

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

Word-for-word

Gloss table

English sense
Graceful shutdown stops new admissions, drains in-flight work and then exits so deploys and scale-in do not chop live requests.

Context / topic
Topic: why drain. Distinct from crash recovery and from load shed under overload.

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

पदच्छेदः
SIGTERM handler ordered steps । default kill 30s blind ॥२॥

Word-for-word

Gloss table

English sense
On terminate mark not-ready, close listeners, wait in-flight then exit. Relying on a hard kill alone drops work.

Context / topic
Topic: signal handling.

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

पदच्छेदः
fail readiness before liveness । kill while still ready युद्धाय ॥३॥

Word-for-word

Gloss table

English sense
Leave the load balancer before you stop the process. Killing a still-ready pod invites new work into a dying body.

Context / topic
Topic: probe order.

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

पदच्छेदः
drain timeout + forced cancel । endless wait stuck deploy ॥४॥

Word-for-word

Gloss table

English sense
Bound drain time then cancel remaining work with clear errors. Infinite grace freezes deployments.

Context / topic
Topic: bounded drain.

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

पदच्छेदः
mesh/LB connection draining पूर्वम् । app-only close अपूर्णम् ॥५॥

Word-for-word

Gloss table

English sense
Coordinate proxy and mesh drain with the app. App close alone still receives connections from a hot listener.

Context / topic
Topic: data plane drain.

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

पदच्छेदः
in-flight jobs checkpoint or nack । ack then die poison ॥६॥

Word-for-word

Gloss table

English sense
Workers should nack or checkpoint before exit so messages redeliver instead of vanishing after ack.

Context / topic
Topic: async workers.

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

पदच्छेदः
stateful: flush WAL / close sessions । half write residual ॥७॥

Word-for-word

Gloss table

English sense
Stateful nodes flush journals and close sessions cleanly within the grace window.

Context / topic
Topic: stateful drain.

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

पदच्छेदः
preStop hook + terminationGracePeriod aligned । hook > grace truncated ॥८॥

Word-for-word

Gloss table

English sense
Make hook duration fit inside the platform grace period with slack for final kill.

Context / topic
Topic: platform timers.

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

पदच्छेदः
metrics: inflight during drain zeroed । invisible chop अन्धता ॥९॥

Word-for-word

Gloss table

English sense
Export in-flight counts and drain duration so rollouts prove they did not chop.

Context / topic
Topic: observability.

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

पदच्छेदः
भारत्यागः overload refuse निरोधः planned exit । लेखनाग्रः flush truth ॥१०॥

Word-for-word

Gloss table

English sense
Load shed refuses under pressure; graceful stop drains on purpose; WAL flush protects durable intent during exit.

Context / topic
Topic: series distinctions.

सन्धिः: त्याग आपात; निरोध योजना; अग्र दृढता।

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

पदच्छेदः
ready-first bound-drain mesh jobs timers पञ्चकम् । एभिरनुग्रहनिरोधधर्मः क्रमशरिक्तिसमन्वितः ॥११॥

Word-for-word

Gloss table

English sense
Five limbs: not-ready before death, bounded drain with cancel, mesh and LB coordination, safe job handoff and aligned platform timers.

Context / topic
Topic: checklist.

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

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

Word-for-word

Gloss table

English sense
Closing: stop admissions, finish or requeue work and only then let the process die.

Context / topic
Topic: close.

उपसंहारन्यायः: अप्रवेशं कुरु; मध्यगं पालय; ततः म्रियस्व।

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

१. Why drain
२. SIGTERM order
३. Ready first
४. Bound drain
५. Mesh/LB
६. Workers
७. Stateful
८. Timers
९. Metrics
१०. Series
११. Five limbs
१२. Close

1. Prior: cardinality 2026-11-12; health 2026-10-11; load shed 2026-11-05; WAL 2026-10-27.
2. Domain: graceful shutdown and drain.
3. English minimizable; Sanskrit-first.
4. Style: no em dash; no Oxford comma in English clauses.