Skip to main content

Module obs

Module obs 

Source
Expand description

Observability. The default build ships three dependency-free things: a hand-rolled JSON-lines logger to stderr, a tiny health surface, and W3C trace-context propagation. Only the heavier surfaces (metrics, OTLP export) are feature-gated.

Invariant: stdout is the agent’s result; stderr is all telemetry.

Modules§

health
Health / liveness.
log
Hand-rolled JSON-lines logger. ~150 lines reusing the serde_json serializer — deliberately not tracing (its implicit async span context is moot for a processes-plus-threads design, and the process tree gives us correlation for free).
metrics
Process-local counters → Prometheus text. [feature: metrics]
otel
OTLP span export with the GenAI semantic conventions. [feature: otel]
trace
W3C Trace Context propagation.