---
url: >-
  https://adk.nht.io/api/@nhtio/adk/batteries/interfaces/IsolationObservabilityHooks.md
description: >-
  The opt-in observability option block mixed into
  `createIsolatedService`/`serveIsolated` options. Every reported phase fires
  {@link 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.
---

# Interface: IsolationObservabilityHooks

Defined in: [src/batteries/isolation/observability.ts:110](https://github.com/NHTIO/ADK/blob/v1.20260713.1/src/src/batteries/isolation/observability.ts#L110)

The opt-in observability option block mixed into `createIsolatedService`/`serveIsolated` options.
Every reported phase fires [onIsolation](#property-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

* [`ServeIsolatedOptions`](ServeIsolatedOptions.md)
* [`IsolatedServiceOptions`](IsolatedServiceOptions.md)

## Properties

| Property                                                 | Type                                                                    | Description                                                                                                                                                                                                               | Defined in                                                                                                                                        |
| -------------------------------------------------------- | ----------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------- |
|  `debugPayloads?`     | `boolean`                                                               | Include payload bodies on `call:*`/`wire:*` reports (see [IsolationReport.payload](IsolationReport.md#property-payload)). Default `false` — payloads may be large/sensitive, so this is opt-in even when hooks are wired. | [src/batteries/isolation/observability.ts:135](https://github.com/NHTIO/ADK/blob/v1.20260713.1/src/src/batteries/isolation/observability.ts#L135) |
|  `onAbort?`                 | [`IsolationReportCallback`](../type-aliases/IsolationReportCallback.md) | `abort:sent` — the host sent an `abort` envelope for an in-flight call.                                                                                                                                                   | [src/batteries/isolation/observability.ts:128](https://github.com/NHTIO/ADK/blob/v1.20260713.1/src/src/batteries/isolation/observability.ts#L128) |
|  `onCall?`                   | [`IsolationReportCallback`](../type-aliases/IsolationReportCallback.md) | `call:start` / `call:settle` — a single request/response method call.                                                                                                                                                     | [src/batteries/isolation/observability.ts:124](https://github.com/NHTIO/ADK/blob/v1.20260713.1/src/src/batteries/isolation/observability.ts#L124) |
|  `onCodecEscalate?` | [`IsolationReportCallback`](../type-aliases/IsolationReportCallback.md) | `codec:escalate` — the codec escalated an argument past the `'raw'` tier.                                                                                                                                                 | [src/batteries/isolation/observability.ts:132](https://github.com/NHTIO/ADK/blob/v1.20260713.1/src/src/batteries/isolation/observability.ts#L132) |
|  `onCrashReport?`     | [`IsolationReportCallback`](../type-aliases/IsolationReportCallback.md) | `crash` — the transport reported an unexpected guest exit/termination.                                                                                                                                                    | [src/batteries/isolation/observability.ts:120](https://github.com/NHTIO/ADK/blob/v1.20260713.1/src/src/batteries/isolation/observability.ts#L120) |
|  `onDispose?`             | [`IsolationReportCallback`](../type-aliases/IsolationReportCallback.md) | `dispose:start` / `dispose:done` — graceful-then-forced teardown.                                                                                                                                                         | [src/batteries/isolation/observability.ts:116](https://github.com/NHTIO/ADK/blob/v1.20260713.1/src/src/batteries/isolation/observability.ts#L116) |
|  `onIsolation?`         | [`IsolationReportCallback`](../type-aliases/IsolationReportCallback.md) | Fires on EVERY report (the firehose).                                                                                                                                                                                     | [src/batteries/isolation/observability.ts:112](https://github.com/NHTIO/ADK/blob/v1.20260713.1/src/src/batteries/isolation/observability.ts#L112) |
|  `onRecycle?`             | [`IsolationReportCallback`](../type-aliases/IsolationReportCallback.md) | `recycle:start` / `recycle:done` — terminate + reconnect through the same transport.                                                                                                                                      | [src/batteries/isolation/observability.ts:118](https://github.com/NHTIO/ADK/blob/v1.20260713.1/src/src/batteries/isolation/observability.ts#L118) |
|  `onRespawnAuto?`     | [`IsolationReportCallback`](../type-aliases/IsolationReportCallback.md) | `respawn:auto` — an `autoRespawn` crash-policy verdict was consulted and acted on.                                                                                                                                        | [src/batteries/isolation/observability.ts:122](https://github.com/NHTIO/ADK/blob/v1.20260713.1/src/src/batteries/isolation/observability.ts#L122) |
|  `onSpawn?`                 | [`IsolationReportCallback`](../type-aliases/IsolationReportCallback.md) | `spawn:start` / `spawn:ready` / `spawn:error` — guest connect lifecycle.                                                                                                                                                  | [src/batteries/isolation/observability.ts:114](https://github.com/NHTIO/ADK/blob/v1.20260713.1/src/src/batteries/isolation/observability.ts#L114) |
|  `onStream?`               | [`IsolationReportCallback`](../type-aliases/IsolationReportCallback.md) | `stream:start` / `stream:end` / `stream:error` / `stream:cancel` — a streaming method call.                                                                                                                               | [src/batteries/isolation/observability.ts:126](https://github.com/NHTIO/ADK/blob/v1.20260713.1/src/src/batteries/isolation/observability.ts#L126) |
|  `onWire?`                   | [`IsolationReportCallback`](../type-aliases/IsolationReportCallback.md) | `wire:out` / `wire:in` — every envelope crossing the wire (verbose; opt in deliberately).                                                                                                                                 | [src/batteries/isolation/observability.ts:130](https://github.com/NHTIO/ADK/blob/v1.20260713.1/src/src/batteries/isolation/observability.ts#L130) |