Files
chopratejas--headroom/sql/create_proxy_telemetry_v2.sql
Garm d4cd49af95 feat(telemetry): add headroom_stack and install_mode identity fields
Adds two orthogonal identity fields to the anonymous telemetry beacon so we
can segment usage by integration surface and deployment shape:

- headroom_stack: how Headroom is invoked (proxy, wrap_claude, wrap_codex,
  adapter_ts_openai, adapter_ts_anthropic, etc.). Resolved from HEADROOM_STACK
  env, HEADROOM_AGENT_TYPE fallback, or aggregated request-header counts.
- install_mode: how the proxy is deployed (wrapped / persistent / on_demand).
  Detected from HEADROOM_AGENT_TYPE plus DeploymentManifest lookup.

TS SDK adapters now tag every request with X-Headroom-Stack; a FastAPI
middleware buckets the counts and surfaces them via /stats so the beacon can
report requests_by_stack for mixed-integration sessions.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-04-17 17:12:38 +02:00

74 lines
2.0 KiB
SQL

-- Supabase SQL: Create proxy_telemetry_v2 table
-- Run this in the Supabase SQL Editor (https://supabase.com/dashboard → SQL Editor)
-- This table matches every field the beacon code writes in headroom/telemetry/beacon.py
CREATE TABLE IF NOT EXISTS proxy_telemetry_v2 (
id uuid DEFAULT gen_random_uuid() PRIMARY KEY,
created_at timestamptz DEFAULT now() NOT NULL,
-- Core identity (always present)
session_id text NOT NULL,
instance_id text,
headroom_version text,
python_version text,
os text,
sdk text,
backend text,
session_minutes integer,
headroom_stack text,
install_mode text,
requests_by_stack jsonb,
-- Effectiveness metrics
tokens_saved bigint,
requests integer,
compression_percent real,
cache_hit_rate real,
cost_saved_usd real,
cache_saved_usd real,
models_used jsonb,
-- Performance overhead
overhead_avg_ms real,
overhead_max_ms real,
-- TTFB
ttfb_avg_ms real,
-- Pipeline timing (JSONB: {transform_name: avg_ms})
pipeline_timing jsonb,
-- Request patterns
avg_tokens_before integer,
avg_tokens_after integer,
-- Compression cache
compression_cache jsonb,
-- CCR usage
ccr jsonb,
-- Waste signals
waste_signals jsonb
);
-- Index for querying by session and time
CREATE INDEX IF NOT EXISTS idx_ptv2_session_id ON proxy_telemetry_v2(session_id);
CREATE INDEX IF NOT EXISTS idx_ptv2_created_at ON proxy_telemetry_v2(created_at DESC);
CREATE INDEX IF NOT EXISTS idx_ptv2_version ON proxy_telemetry_v2(headroom_version);
-- Enable Row Level Security
ALTER TABLE proxy_telemetry_v2 ENABLE ROW LEVEL SECURITY;
-- RLS policies: anon can INSERT (telemetry beacon) and SELECT (for debugging)
CREATE POLICY "anon_insert" ON proxy_telemetry_v2
FOR INSERT TO anon
WITH CHECK (true);
CREATE POLICY "anon_select" ON proxy_telemetry_v2
FOR SELECT TO anon
USING (true);
-- Grant permissions to anon role
GRANT INSERT, SELECT ON proxy_telemetry_v2 TO anon;