Monitoring & Dashboard

The Akshi dashboard provides real-time visibility into agent status, logs, and event streams.

Opening the dashboard

After starting the runtime, open:

http://127.0.0.1:3210

If auth is enabled, enter the token from runtime.toml or use the one printed at startup.

Agent status view

The main view shows all agents with their current state:

Running — Agent is actively executing
Idle — Agent is waiting for the next tick
Stopped — Agent has been manually stopped
Error — Agent encountered a fatal error

Click an agent to see its detailed status including uptime, restart count, memory usage, and fuel remaining.

Live event stream

The events panel shows real-time agent activity:

Inference tokens as they stream
Tool calls with arguments and results
Agent tick completions with duration
Errors and warnings

This uses the SSE endpoint at /api/v1/events.

Prometheus metrics

Export metrics for external monitoring:

curl -H "Authorization: Bearer $TOKEN" http://127.0.0.1:3210/api/v1/metrics

Configure Prometheus to scrape this endpoint:

scrape_configs:
  - job_name: akshi
    bearer_token: "your-token"
    static_configs:
      - targets: ["127.0.0.1:3210"]
    metrics_path: /api/v1/metrics

Key metrics to monitor

Metric	Alert threshold	Description
`akshi_agents_total`	Drops below expected	Agent crashed and not restarted
`akshi_agent_restarts_total`	Rapid increase	Agent crash loop
`akshi_approvals_pending`	Grows unbounded	Approvals not being handled
`akshi_fuel_consumed_total`	Near fuel limit	Agent may be throttled

CLI status

Quick status check from the terminal:

akshi status

Keyboard shortcuts