Skip to main content

Analytics and Usage

VibeControls provides analytics and usage visibility so you can understand how your workspace is being used, how healthy your agents are, and where your team spends its time.

Navigate to Analytics (/vibecontrols/analytics) and Health (/vibecontrols/health) in the VibeControls sidebar to access these views.

What Analytics Covers​

The analytics surface in VibeControls is focused on operational metrics — the things that matter for day-to-day development:

  • Session activity: how many sessions are running, how long they run, which agents host them
  • Agent health history: uptime, connectivity over time, probe results
  • Workspace usage: which vibes are most active, which agents handle the most work
  • AI usage: prompts dispatched, providers used, response times

Session Metrics​

The Sessions analytics panel shows:

Active Sessions Overview​

  • Current count of active sessions across all agents
  • Breakdown by session type (tmux, SSH, Script, etc.)
  • Which agents are hosting the most sessions

Session History​

  • Sessions started per day/week/month (time-series chart)
  • Average session duration
  • Peak usage times — useful for knowing when your team is most active
  • Sessions by vibe — see which projects generate the most terminal activity

Session Status Distribution​

  • A breakdown of session states: Active, Stopped, Error, Completed
  • Error rate over time — spikes here can indicate agent problems or script failures

Filtering Session Metrics​

Use the filters at the top of the panel to narrow down metrics:

  • Date range — focus on a specific period
  • Agent — see activity for a specific machine
  • Vibe — see activity for a specific project
  • Session type — filter to only tmux sessions, only scripts, etc.

Agent Health History​

The Health page (/vibecontrols/health) gives you a timeline view of agent connectivity.

Per-Agent Health Timeline​

For each registered agent, you can see:

  • Uptime percentage over the selected period
  • A timeline bar (similar to a status page) showing when the agent was online, degraded, or offline
  • Individual health probe results with timestamps
  • Any error messages from failed probes

This is useful for:

  • Identifying an agent that frequently drops offline (network issues, auto-sleep settings, etc.)
  • Confirming that a remote machine was up during a specific time window
  • Reporting on infrastructure reliability

Agent Health Across the Workspace​

The health overview page shows all agents in a single grid:

  • Color-coded status indicators (green/yellow/red)
  • Quick uptime summary for each agent
  • Last-seen timestamp

Click any agent to drill into its detailed health history.

Health Probe Details​

Each health check probe shows:

  • Probe timestamp
  • Result — success or failure
  • Latency — how long the probe took
  • Error message — if the probe failed, what went wrong

Workspace Usage Dashboard​

The Workspace analytics panel shows high-level usage across your workspace:

Resources Summary​

  • Total agents registered
  • Total vibes created (active vs archived)
  • Total sessions (active vs historical)
  • Total notes

Trend Charts​

  • New vibes created over time
  • New sessions started over time
  • Agent registrations over time

These trends help you understand whether your team's usage is growing, and at what pace.

Top Contributors​

  • Members who have created the most sessions, vibes, or notes
  • Useful for understanding team engagement

Most Active Vibes​

  • Which projects see the highest session activity
  • Helps identify which parts of the codebase your team focuses on

AI Usage Metrics​

If your workspace uses the AI hub, the AI analytics panel (also reachable from AI → Stats) shows:

  • Prompts dispatched — total count, per provider, per member
  • AI session counts — how many AI sessions have been created
  • Response time distribution — average and percentile latency per provider
  • Provider availability — uptime of each AI provider installed on agents
  • Queue depth — how many prompts are queued vs processed

Use this to understand which AI providers your team uses most and where performance could be improved.

Exporting Analytics Data​

From any analytics panel, click Export to download the current view's data:

  • CSV — for spreadsheet analysis
  • JSON — for programmatic use

The export reflects the current filter settings (date range, agent, vibe, etc.).

Viewing the Audit Log​

For a full record of all actions taken in your workspace, navigate to Audit (/vibecontrols/audit). The audit log records:

  • Who performed each action
  • What resource was affected
  • What changed
  • When it happened

The audit log is available to workspace Admins. You can filter by actor, resource type, and date range, and export it as CSV for compliance or review purposes.

Note: The audit log feature may need to be enabled by your workspace Admin — check Settings if you do not see it in the sidebar.

Health Notifications​

VibeControls can notify you when agent health changes:

  • An agent goes offline
  • An agent comes back online after being offline

To configure health notifications:

  1. Go to Notifications → Preferences
  2. Find the VibeControls section
  3. Enable notifications for Agent offline and Agent online events
  4. Choose your preferred channel (in-app, email, etc.)

Tips​

  • Check the Agent Health page before starting a large batch of sessions — confirm all agents you need are healthy before kicking off work.
  • Use the Most Active Vibes view to prioritize maintenance and cleanup. If a vibe has not had session activity in months, it may be a candidate for archiving.
  • Export session metrics at the end of a sprint to report on development activity.
  • If you notice a spike in session errors in the analytics, check the Agent Health timeline for the same period — agent problems and session errors often correlate.