The session banner now labels the VS Code family "VS Code Family", so it isn't confused with the VS Code editor. coderd_insights_applications_usage_seconds now reports built-in apps per app instead of per family.
- Generate the frontend's family labels from the Go table in codersdk.
- Add the connection_method label: workspace_app for template apps, and ssh, reconnecting_pty, or port_forwarding for built-in apps.
- Rename the application_name label to display_name. For built-in apps it holds the registry name, "Unknown" for unknown, and "Other apps" for overflow.
- Built-in apps get one series per app name, only for apps used in the window. The series limit and the fold rule are shared with the template insights API.
- Breaking: selectors with a value for application_name, or with slug="", match nothing. The Prometheus docs map each old series to its new one.
Closes#29940
Closes CLIENT-1034
Closes CLIENT-1036
Report template insights session usage per app instead of five fixed
family rows, with registry names and icons.
- Add per-app rows for reported session apps (VS Code, Cursor, GoLand,
Zed, etc.); unused apps are omitted
- Replace `type` (`builtin`/`app`) with `method` (`ssh`,
`reconnecting_pty`, `port_forwarding`, `workspace_app`); session
methods are derived from the app name until #31012 stores them
- Add `usage_total_seconds` to count each user's active minutes once,
and use it as the UI bar denominator so overlapping apps can exceed
100%
- Merge template apps sharing a slug into one row across templates,
using the newest display name and icon
- Rename Web Terminal slug from `reconnecting-pty` to
`reconnecting_pty`
- Cap the response at the 64 busiest unregistered apps and fold the
rest into "Other apps", flagged with `seconds_is_upper_bound`
("Up to" in the UI)
- Add `unknown` and `overflow` accounting rows with explanatory
tooltips, and a fallback icon for apps without one
- Remove the unused `codersdk.UnionByFamily` helper from the Go SDK
BREAKING CHANGE: `report.apps_usage` in `GET /api/v2/insights/templates`
no longer returns the fixed five rows, family slugs, or previous display
names. Consumers must update.
Part of CLIENT-642
Prometheus metrics handled separately in #29906
coderd_insights_applications_usage_seconds summed each family's per-app
minutes, so a user with VS Code and Cursor open in the same minute was
counted as two VS Code minutes. GetTemplateInsightsByTemplate now takes
the registry's app-to-family mapping as jsonb, groups the raw agent
stats by family, and counts each minute once per user and family.
- Keep the metric's four built-in series (Visual Studio Code, JetBrains,
Web Terminal, SSH) and their labels; only their values change. The
HELP text now says built-in apps are grouped by family.
- Add AppFamilyName.DisplayName() and remove the duplicate
TemplateBuiltinAppDisplayName* constants from codersdk. The template
insights handler returns the same display names.
- Pin how the migration 000596 rollback approximates family minutes
from per-app rows.
Family values can drop wherever the old per-app sum double-counted
overlapping apps. No migration or storage changes.
Store per-app session minutes in a child table instead of fixed family-minute columns, so adding an IDE no longer needs a rollup schema change. API, Prometheus, and telemetry output are unchanged.
- Add `template_usage_stats_session_apps`, keyed by start time, template, user, and app name, replacing the `ssh_mins`, `sftp_mins`, `reconnecting_pty_mins`, `vscode_mins`, and `jetbrains_mins` columns.
- Group app names into families at read time through the `codersdk` registry, so the registry never reaches SQL and attribution covers all history rather than only the buckets the rollup still revisits.
- Group `GetTemplateInsightsByTemplate` by app name so that Prometheus and the API report a family identically.
- Drop the `@app_families` query parameter and its dbauthz validation.
- Report a family total as the sum of its apps rather than the distinct minutes any of them was active. Numbers are unchanged today, because every agent reports one canonical name per family.
- Keep the child table window index-usable and count minutes with `COUNT(DISTINCT)` in the grouping, so a dashboard-sized range uses an index scan and a large deployment does not spill the sort to disk.
Part of #27410