Expand description
Per-Actor Introspection API — FR-015
Runtime actor inspection for debugging and monitoring:
- List all actors with state, queue depth, message rate
- Inspect per-actor metrics (read-only)
- Peek at queued messages
- Trace recent message processing with timing
§Streaming Introspection (v1.1)
Live introspection streaming for sub-millisecond metric freshness:
IntrospectionStream— subscribe to periodic metric emissions per-actorMetricAggregator— EWMA rate calculation and latency histogramLiveMetrics— the observation record emitted to subscribers- Wire formats (
SubscribeMetricsRequest,LiveMetricsEvent) for GPU/CPU bridge
Structs§
- Actor
Snapshot - Snapshot of a single actor’s state for introspection.
- Introspection
Service - Introspection service that aggregates data from all actors.
- Introspection
Stream - Streaming live-metric dispatcher with per-actor subscriptions.
- Latency
Histogram - A ring-buffer latency histogram for p50/p99 percentile computation.
- Live
Metrics - Live per-actor metrics delivered to subscribers.
- Live
Metrics Event - K2H response: periodic metric emission from a GPU actor.
- Metric
Aggregator - Aggregates per-actor metric counters and produces smoothed snapshots.
- Performance
Snapshot - Snapshot of an actor’s performance metrics.
- Queue
Snapshot - Snapshot of an actor’s queue state.
- Subscribe
Metrics Request - H2K command: subscribe to metrics from a GPU actor.
- Subscriber
Handle - A handle to a single live-metrics subscription.
- Trace
Buffer - Per-actor trace buffer (ring buffer of recent processing traces).
- Trace
Entry - A recent message processing trace entry.
Enums§
- Trace
Outcome - Outcome of a traced message.
Constants§
- DEFAULT_
EWMA_ ALPHA - Default EWMA smoothing factor for rate calculations.
- LATENCY_
HISTOGRAM_ CAPACITY - Capacity of the
LatencyHistogramring buffer.