Framework.Overlay.Timeline (Framework v0.5.0)

View Source

Timeline component for observability overlay.

Tracks the canonical flow: accept → plan → commit → append → flush → effects. Provides real-time visibility into operation lifecycle with structured correlation.

Features

  • Per-request timeline tracking
  • Stage timing and metrics
  • Error propagation visibility
  • Effect execution tracking

Summary

Functions

Get active operations currently in progress.

Get operation metrics for monitoring dashboard.

Get recent requests for timeline view.

Get detailed request flow for a specific request.

Get timeline events for a specific request or session.

Functions

get_active_operations(limit \\ 50)

Get active operations currently in progress.

Shows operations that have started (accept event) but not completed (operation_settled event), useful for monitoring stuck operations.

get_operation_metrics(time_window_minutes \\ 60)

Get operation metrics for monitoring dashboard.

Returns aggregate metrics for operation performance:

  • Average stage durations
  • Success/failure rates
  • Throughput metrics
  • Error patterns

get_recent_requests(opts \\ [])

Get recent requests for timeline view.

Returns list of requests with their basic info for timeline dashboard.

get_request_flow(request_id)

Get detailed request flow for a specific request.

Returns complete timeline with all events for the request.

get_timeline(correlation_id, correlation_type \\ :request_id, limit \\ 100)

Get timeline events for a specific request or session.

Returns chronological sequence of events showing operation progression.

Parameters

  • correlation_id: request_id, client_id, or session_id to filter by
  • correlation_type: :request_id | :client_id | :session_id

  • limit: Maximum events to return (default 100)

Returns

List of timeline events with:

  • sequence: Global sequence number
  • stage: accept | plan | commit | append | flush | effects

  • timestamp: Event timestamp
  • duration_ms: Stage duration if available
  • correlation_ids: Full correlation triad
  • event_type: Specific event type
  • metadata: Stage-specific metadata