ObservabilityConfig

Properties

exporter?

optional exporter?: "json" | "console" | ((trace) => Promise<void>);

Where to send the final SessionTrace. Default: console.

---

includeContent?

optional includeContent?: boolean;

Include message text in span events (PII risk). Default: false.

---

metrics?

optional metrics?: Metrics;

Optional metrics service for timings alongside spans.

---

outputPath?

optional outputPath?: string;

Output file for json exporter. Default: ./.kuralle-traces/session-<id>.json

---

serviceName?

optional serviceName?: string;

Service name stored on spans.

---

traceStream?

optional traceStream?: (event) => void;

Optional live trace stream (e.g. Kuralle Studio WebSocket). Fire-and-forget; keep handlers synchronous or schedule async work without blocking the harness.

Parameters

Parameter	Type
event	TraceStreamEvent

Returns

void