Skip to content
2 min read · 322 words

Interface: IsolationObservabilityHooks

Defined in: src/batteries/isolation/observability.ts:110

The opt-in observability option block mixed into createIsolatedService/serveIsolated options. Every reported phase fires onIsolation (the firehose) AND its matching per-phase-group hook; subscribe to either or both. All optional — omitting them leaves behavior byte-for-byte unchanged.

Extended by

Properties

PropertyTypeDescriptionDefined in
debugPayloads?booleanInclude payload bodies on call:*/wire:* reports (see IsolationReport.payload). Default false — payloads may be large/sensitive, so this is opt-in even when hooks are wired.src/batteries/isolation/observability.ts:135
onAbort?IsolationReportCallbackabort:sent — the host sent an abort envelope for an in-flight call.src/batteries/isolation/observability.ts:128
onCall?IsolationReportCallbackcall:start / call:settle — a single request/response method call.src/batteries/isolation/observability.ts:124
onCodecEscalate?IsolationReportCallbackcodec:escalate — the codec escalated an argument past the 'raw' tier.src/batteries/isolation/observability.ts:132
onCrashReport?IsolationReportCallbackcrash — the transport reported an unexpected guest exit/termination.src/batteries/isolation/observability.ts:120
onDispose?IsolationReportCallbackdispose:start / dispose:done — graceful-then-forced teardown.src/batteries/isolation/observability.ts:116
onIsolation?IsolationReportCallbackFires on EVERY report (the firehose).src/batteries/isolation/observability.ts:112
onRecycle?IsolationReportCallbackrecycle:start / recycle:done — terminate + reconnect through the same transport.src/batteries/isolation/observability.ts:118
onRespawnAuto?IsolationReportCallbackrespawn:auto — an autoRespawn crash-policy verdict was consulted and acted on.src/batteries/isolation/observability.ts:122
onSpawn?IsolationReportCallbackspawn:start / spawn:ready / spawn:error — guest connect lifecycle.src/batteries/isolation/observability.ts:114
onStream?IsolationReportCallbackstream:start / stream:end / stream:error / stream:cancel — a streaming method call.src/batteries/isolation/observability.ts:126
onWire?IsolationReportCallbackwire:out / wire:in — every envelope crossing the wire (verbose; opt in deliberately).src/batteries/isolation/observability.ts:130