Interface: IsolationReport
Defined in: src/batteries/isolation/observability.ts:44
A single normalized isolation observability report. Every phase stamps phase/at/spawnCount plus its own extra fields (see the per-phase hook docs on IsolationObservabilityHooks for which extra fields a given phase populates).
Properties
| Property | Type | Description | Defined in |
|---|---|---|---|
approxBytes? | number | wire:out / wire:in — a cheap JSON.stringify(...).length-style size estimate; computed ONLY when a wire hook is registered (see emitIsolationReport). | src/batteries/isolation/observability.ts:93 |
argPath? | string | codec:escalate — the argument path that needed to escalate past the 'raw' tier. | src/batteries/isolation/observability.ts:95 |
at | string | ISO-8601 timestamp stamped when the report was emitted. | src/batteries/isolation/observability.ts:48 |
bootMs? | number | spawn:ready — time from connect() call to the ready envelope, in ms. | src/batteries/isolation/observability.ts:54 |
code? | number | null | crash — process exit code, when known. | src/batteries/isolation/observability.ts:62 |
deltaCount? | number | stream:end / stream:cancel — total deltas observed before end/cancel. | src/batteries/isolation/observability.ts:82 |
durationMs? | number | call:settle — wall-clock duration of the call, in ms. | src/batteries/isolation/observability.ts:74 |
error? | unknown | spawn:error / crash — the underlying error/reason. | src/batteries/isolation/observability.ts:56 |
errorMessage? | string | call:settle (when ok is false) — the rejection's message. | src/batteries/isolation/observability.ts:78 |
escalateReason? | string | codec:escalate — why it escalated (e.g. 'function', 'error', 'custom-encodable'). | src/batteries/isolation/observability.ts:97 |
firstDeltaMs? | number | stream:end — ms from stream:start to the first delta (undefined if none arrived). | src/batteries/isolation/observability.ts:84 |
forced? | boolean | dispose:done — true when the grace period elapsed and transport.terminate() was forced. | src/batteries/isolation/observability.ts:58 |
id? | string | call:start / call:settle — the correlation id. | src/batteries/isolation/observability.ts:72 |
inFlight? | number | crash — number of calls that were in flight (and rejected) at the moment of the crash. | src/batteries/isolation/observability.ts:66 |
kind? | string | wire:out / wire:in — the envelope's discriminant ('call', 'result', 'stream:delta', …). | src/batteries/isolation/observability.ts:88 |
method? | string | call:start / call:settle — the method name. | src/batteries/isolation/observability.ts:70 |
ok? | boolean | call:settle — true when the call resolved; false when it rejected. | src/batteries/isolation/observability.ts:76 |
payload? | unknown | With debugPayloads: true on a call:*/wire:* report — the raw payload body. | src/batteries/isolation/observability.ts:99 |
phase | IsolationReportPhase | The phase this report describes. | src/batteries/isolation/observability.ts:46 |
reason? | string | crash — the transport-reported crash reason. | src/batteries/isolation/observability.ts:60 |
serviceName? | string | The service's name (from its spec), when available. | src/batteries/isolation/observability.ts:50 |
signal? | string | null | crash — process exit signal, when known. | src/batteries/isolation/observability.ts:64 |
spawnCount | number | How many times this service's guest has been (re)spawned, including the current spawn. | src/batteries/isolation/observability.ts:52 |
streamError? | unknown | stream:error — the stream's terminal error. | src/batteries/isolation/observability.ts:86 |
streamName? | string | stream:start / stream:end / stream:error / stream:cancel — the stream name. | src/batteries/isolation/observability.ts:80 |
tier? | string | wire:out / wire:in — which codec tier carried the payload ('raw' or 'nhtio'), when known. | src/batteries/isolation/observability.ts:90 |
verdict? | "respawn" | "giveUp" | respawn:auto — the crash-policy verdict that was consulted. | src/batteries/isolation/observability.ts:68 |