#Observability & Inspector

Version: 0.51.0 release Updated: 2026-06-04 Applies to: ranvier-inspector Category: Deep Dives

Production-ready trace storage, metrics, and real-time debugging with ranvier-inspector.

#Inspector Runtime

#Metrics & Debugging

• MetricsCollector: Sliding-window latency histograms (p50/p95/p99) per circuit.
• StallDetector: Threshold-based detection for unresponsive transitions.
• ConditionalBreakpoint: JSON path condition evaluator for step-through debugging.
• PayloadCapturePolicy: Off/Hash/Full payload capture for compliance and debugging.

#OTLP & Trace Pipeline

• Circuit Mapping: Every Axon execution maps to a standard OpenTelemetry Trace.
• Node Spans: Transitions are automatically recorded as Spans with metadata.
• WebSocket Streaming: Real-time event feed for Inspector UI and external consumers.

#Quickstart

use ranvier_core::schematic::Schematic;
use ranvier_inspector::Inspector;

let inspector = Inspector::new(Schematic::new("checkout"), 9090)
    .with_mode_from_env()
    .with_bearer_token_from_env()
    .with_trace_registry_config(Default::default());

inspector.serve().await?;

#Workflows

1. Add ranvier-inspector to your workspace dependencies.
2. Configure RANVIER_MODE=prod and RANVIER_INSPECTOR_TOKEN for shared environments.
3. Choose trace retention bounds and, when needed, a TraceStore backend.
4. Connect to Jaeger, Tempo, or Datadog using standard OTLP exporters.
5. Monitor node-level heatmaps in the Inspector UI or Ranvier Studio.
6. For deployment-mode, auth, CORS, fail-mode, and backpressure rules, see Operational Policy Guide.

#Key Types