Skip to content

Admin Dashboard

The ContextForge dashboard is a Starlette ASGI app that renders GridViewSpec pages for ContextUnity observability. It reads Brain data through Brain Admin gRPC and stores dashboard-local agent records/preferences in local SQLite stores.

Dashboard Views

ViewURLDescription
Overview/KPIs, service status, trace volume, memory summaries
Traces/traces/Searchable list of agent execution traces
Trace Detail/traces/{trace_id}/Step-by-step trace inspection
Agents/agents/Dashboard-local agent record list
Agent Detail/agents/{pk}/Agent metadata, activity, and related traces
Agent Hierarchy/agents/hierarchy/Agent relationship view
Events/events/Event search
Memory/memory/Memory layer statistics
Memory Events/memory/events/Episodic event search

Data Flow

Browser
-> Starlette dashboard routes
-> GridViewSpec page builders
-> BrainAdminClient gRPC wrappers
-> ContextBrain Admin RPCs
Forge local SQLite:
- AgentStore records
- Grid preferences

KPI Dashboard

The overview page displays:

  • Trace volume from Brain Admin trace search and analytics summaries.
  • Error rates from trace status and analytics summaries.
  • Service health from Forge probes and configured service endpoints.
  • Memory statistics from Brain Admin memory layer stats.
  • Request/error charts from /api/chart-data/.

Time range is selectable with dashboard query parameters such as ?range=24h|7d|30d.

Trace Inspector

The trace detail view provides:

  1. Step timeline with graph node spans.
  2. Tool calls, arguments, and results.
  3. Token usage and cost estimates where available.
  4. Security and provenance badges.
  5. Langfuse link metadata when configured.

Agent Views

Forge agent pages are dashboard-local operational metadata. Router graph behavior remains manifest-driven; Forge does not act as Router’s permission source.