feat: add boundary usage tracking database schema and tracker skeleton (#21670)

mirror of https://github.com/coder/coder.git synced 2026-09-24 15:04:27 +08:00

feat: add boundary usage telemetry database schema and RBAC

Adds the foundation for tracking boundary usage telemetry across Coder
replicas. This includes:

  - Database schema: `boundary_usage_stats` table with per-replica stats
    (unique workspaces, unique users, allowed/denied request counts)
  - Database queries: upsert stats, get aggregated summary, reset stats,
    delete by replica ID
  - RBAC: `boundary_usage` resource type with read/update/delete actions,
    accessible only via system `BoundaryUsageTracker` subject (not regular
    user roles)
  - Tracker skeleton + docs: stub implementation in `coderd/boundaryusage/`

The tracker accumulates stats in memory and periodically flushes to the
database. Stats are aggregated across replicas for telemetry reporting,
then reset when a new reporting period begins. The tracker implementation
and plumbing will be done in a subsequent commit/PR.

---------

Co-authored-by: Claude Opus 4.5 <noreply@anthropic.com>

This commit is contained in:

Zach

2026-01-27 13:29:21 -07:00

committed by

GitHub

co-authored by

Claude Opus 4.5

parent e008f720b6

commit 7dfa33b410

30 changed files with 660 additions and 37 deletions

									
										coderd/database/migrations/testdata/fixtures/000411_boundary_usage_stats.up.sql
									
Vendored

		+2
		
												View File
												
				@@ -0,0 +1,2 @@

				INSERT INTO boundary_usage_stats (replica_id, unique_workspaces_count, unique_users_count, allowed_requests, denied_requests, window_start, updated_at)

				VALUES ('00000000-0000-0000-0000-000000000001', 10, 5, 100, 20, NOW(), NOW());