Usage dashboard
How to read metering data in the Cosmo dashboard.
Usage dashboard
The usage dashboard shows a breakdown of all metered activity for your workspace. Navigate to Developer platform → Usage (/<workspace>/developer/usage).
Time range selector
[Screenshot placeholder: Time range dropdown showing options: Today, Last 7 days, Last 30 days, Current billing period, Custom range]
Select a time range to scope all metrics on the page. The default view shows the current billing period.
Voice minutes chart
[Screenshot placeholder: Line chart of voice minutes per day with a total summary card]
The chart shows mic-active minutes aggregated by day. Hover a bar for the exact value.
Summary card above the chart shows:
- Total this period — accumulated mic-active minutes.
- Change vs. prior period — percentage delta.
A spike on a single day typically indicates a long session or a batch of automated testing. Sessions shorter than one second are not shown individually but are included in the aggregate.
Tool dispatches
[Screenshot placeholder: Bar chart of tool dispatches per day with a breakdown table by tool name]
The bar chart shows dispatch counts by day. The table below breaks down by tool name:
| Tool | Dispatches this period |
|---|---|
cosmo_brain | — |
find_workspace_files | — |
start_analysis | — |
| (other tools) | — |
Counts are workspace-wide across all projects and API keys.
Sessions
[Screenshot placeholder: Sessions count card and a table of recent sessions with session_id, start time, duration, and status]
The sessions table shows:
- Session ID — the opaque
session_idfromRealtimeSessionResponse. Include this in support requests. - Start time — timestamp of the successful session-start call.
- Duration — wall-clock session duration (from session-start to disconnect/end).
- Mic minutes — mic-active time within the session.
- Tool dispatches — tool calls within the session.
- Status — Completed, Disconnected, or Error.
Exporting data
[Screenshot placeholder: Export button in the top-right corner of the usage page]
Click Export CSV to download a row-per-session breakdown for the selected time range. Fields include session_id, start_time, duration_seconds, mic_active_seconds, tool_dispatch_count, status.
A programmatic export API is planned for a future release.
Per-project breakdown
Usage is aggregated at the workspace level by default. A per-project breakdown view is planned and will be surfaced in the same dashboard page. For now, filter the sessions table by project_id using the search box to approximate per-project totals.