Skip to main content

Usage Tracking

The Usage page gives you a clear view of how your workspace is using its plan. To open it: Workspace Settings → Billing → Usage.

You need the billing:read:all permission to view the page. By default only the Admin role has it. See Roles and Permissions.

What's tracked​

Harmony tracks usage on two independent systems:

  1. A monthly subscription quota (per seat × plan limits) for seats, insights, and transcription hours.
  2. A daily credit allowance (rolling 24-hour window) for Data Lake / Insights Engine AI analysis, measured in internal cost units.

Both surface on the Usage page when applicable.

Subscription quota (monthly)​

Three metric sections appear at the top of the Usage page, each with a progress bar.

Seats​

  • "{allocated} of {total} seats used" with a progress bar.
  • Cards: Total Seats, Allocated Seats, Available Seats.

Total Seats = the number of seats your subscription is paying for (subscription.seats). Allocated = seats currently assigned to specific users.

Insights​

  • "{used} of {total} insights used" with progress bar.
  • Cards: Total Insights, Used Insights, Remaining Insights.

Total Insights = subscription.seats × planTier.insightsPerSeat. Each AI insight analysis run consumes one insight from the quota.

Transcription hours​

  • "{used} of {total} hours used" with progress bar.
  • Cards: Total Hours, Used Hours, Remaining Hours.

Total Hours = subscription.seats × planTier.transcriptionHoursPerSeat. The metric counts transcription hours specifically (each transcribed audio hour is added; fractional hours supported) — it is not the same as "raw recording hours" and not the same as desktop-app screen-record time.

When the quota resets​

  • Usage resets at the start of each new billing period (typically monthly, matching Stripe's current_period_start / current_period_end).
  • Counters reset to 0 and the totals are recomputed from the current seats × per-seat values.
  • Adding or removing seats mid-period rescales the totals.

When you hit a limit​

  • Insights limit reached — new insight generation is blocked for the rest of the period. Add seats or change to a higher tier to raise the allowance.
  • Transcription hours limit reached — new transcription processing is blocked for the rest of the period.

Daily credit allowance (Data Lake AI analysis)​

For workspaces using the Data Lake heavily, Harmony also tracks a daily credit allowance that is separate from the monthly quota. It is a worker-computed, snapshot-based view of AI model cost in a rolling 24-hour window.

This panel only appears for users with billing:read:all and when the Allowance UI details feature is enabled for the workspace. If your workspace doesn't have it enabled, you won't see this section at all.

When shown, the panel includes:

  • Daily credit usage title and a description: "Worker-synced usage for your current 24-hour allowance window."
  • Status badge: Within limit / Over limit / Unlimited.
  • Coverage badge: Complete pricing coverage or Partial pricing coverage — tells you whether every priced event in the window has a known model cost.
  • Usage percent (when limited): e.g. "42% of daily credits used."
  • Window — start and end of the current 24-hour window.
  • Last synced — when the background worker last recomputed the snapshot.
  • Most expensive Data Lake definitions — up to 25 insight definitions ranked by relative cost across the last 48 hours, with the highest-cost definition shown as 100% and others as a relative percentage.

If pricing coverage is partial: "Pricing coverage is incomplete — {count} events in this window could not be priced yet."

If no snapshot exists yet: "No worker-synced billing allowance snapshot is available for this workspace yet."

The daily credit allowance tracks AI model cost in a rolling 24-hour window. The subscription quota tracks insight runs and transcription hours in the monthly billing period. They are stored, computed, and displayed separately. Seeing Within limit on the daily allowance does not mean you have remaining monthly insights, and vice versa.

User directory and seat allocation​

Below the usage metrics, the Usage page exposes the organisation user list, which doubles as a quick seat-allocation surface. Each user row shows their Email, Role, and Seat Status (Allocated / No Seat), with a per-row dropdown to allocate or deallocate a seat. Search and filter controls let you find a user by name, email, role, or team.

The same allocate / deallocate actions live on Settings → Billing → Seats under Users & Seat Allocations, where you also get the Change seats action to update the number of purchased seats. See Seats Management.

The user list shows the columns above. Reporting-manager and detailed team-membership columns are not part of the Usage page directory today.

Staying within your limits​

The progress bars at the top of the page make it easy to spot when you're approaching a limit. A few practical responses:

  • Running low on seats: check whether any allocated seats belong to users who are no longer active and can be deallocated. If you need more capacity, click Change seats under Settings → Billing → Seats.
  • Approaching your insights limit: consider scoping projects more tightly with Project Criteria (see Generating insights) or upgrade to a tier with a higher per-seat allowance.
  • Approaching transcription hours: be more selective about what gets recorded, or upgrade.

To increase the per-seat allowance for insights or transcription hours, you need to change the plan tier — which is currently routed through Harmony support (the in-app Change Plan button is a placeholder that is not wired today).

Troubleshooting​

Numbers look wrong. Confirm the displayed billing period — quota counters reset at the start of each period. The daily credit allowance is worker-synced, so very recent activity may not be reflected; check Last synced in that panel. If something still doesn't add up, contact support with the workspace and the period in question.

Daily credit panel missing. The panel is gated by the Allowance UI details feature flag for the workspace. If you don't see it and you think you should, contact support.

"Over limit" on the daily credit allowance. The workspace has used more AI model cost than the configured daily allowance. Contact support if you want the allowance raised or want help identifying expensive insight definitions.