Panoramica delle Dashboard
Questa sezione documenta le due famiglie di dashboard esistenti per Playroll.
- Telemetria OTEL (SigNoz) — telemetria emessa dal client. Disponibili sull'istanza SigNoz all'indirizzo
https://otel.playroll.gge memorizzate nel database SQLite di SigNoz (/var/lib/signoz/signoz.db, tabelladashboard). Pubblico: ingegneria e operatori. Rispondono alla domanda "cosa ha cercato di fare il client?". - View Supabase — view SQL autoritative lato server nel database Postgres
playroll_supa_new, schemapublic. Pubblico: reportistica VC (*_vc_view) e supporto tester (support_*). Rispondono alla domanda "cosa è arrivato sul server?".
Le due famiglie si sovrappongono intenzionalmente su alcuni KPI (DAU, sessioni al giorno, throughput di upload). Quando i numeri divergono, OTEL riflette l'emissione del client e Supabase riflette l'ingestione lato server — entrambi sono corretti; misurano cose diverse. Vedi la pagina VC View per la fonte di verità raccomandata per ciascun KPI.
Legenda degli stati
Ogni pagina di dashboard inizia con dei badge che riassumono tre assi ortogonali.
Status — stato operativo della dashboard in questo momento.
- Active — dashboard di produzione, le query restituiscono dati in tempo reale.
- Reference — la struttura è in atto ma la fonte dati a monte non è ancora attiva; la dashboard è un contratto / segnaposto.
- Draft — in costruzione, non pronta per l'uso.
- Sunset planned — pianificata per la rimozione; mantenuta temporaneamente per validazione o migrazione.
Lifecycle — durata prevista.
- Permanent — destinata a vivere in produzione con durata indefinita.
- Mutable — il contenuto/la struttura cambieranno in modo significativo (es. in attesa che una pipeline lato server diventi attiva).
- Sunset planned — ha una data di fine vita pianificata.
Persistence — quando la dashboard è stata creata (informativo).
Telemetria OTEL (SigNoz)
| Dashboard | Status | Lifecycle | Creata |
|---|---|---|---|
| Audience | Active | Permanent | 2026-05-04 |
| Capture Pipeline (client) | Active | Permanent | 2026-05-04 |
| Errors & Auth | Active | Permanent | 2026-05-04 |
| Version Upgrades (slim) | Active | Permanent | 2026-05-04 |
| Game Library | Active | Permanent | 2026-05-04 |
| Pipeline Health | Reference | Mutable | 2026-05-02 |
Archivio (dashboard pre-revamp mantenute per validazione):
| Dashboard | Sostituita da |
|---|---|
| Product Health | Audience |
| Retention Cohort | Audience |
| Engagement | Capture Pipeline (client) |
| Error Monitoring | Errors & Auth |
| Version Upgrades | Version Upgrades (slim) |
View Supabase
| Pagina | View incluse | Pubblico |
|---|---|---|
| VC View | investor_daily_recording_kpis_vc_view | Investitori |
| Tester Views | support_recording_sessions, support_recording_files, support_player_upload_summary, playroll_users_view | Supporto tester |
Il contratto Supabase è riassunto anche in Database → Monitoring Views.
Sovrapposizione di KPI tra le due famiglie
| KPI | Fonte OTEL | Fonte Supabase | Autoritativa per |
|---|---|---|---|
| Daily Active Players | Audience → DAU by Track | investor_daily_recording_kpis_vc_view.active_players | Reportistica VC → Supabase |
| Sessioni al giorno | Capture Pipeline → Sessions by Version | investor_daily_recording_kpis_vc_view.total_sessions_seen | Reportistica VC → Supabase |
| Throughput di upload (GB/giorno) | Capture Pipeline → Upload Throughput | investor_daily_recording_kpis_vc_view.uploaded_size_gb | Reportistica VC → Supabase |
| Funnel / completezza upload | Pipeline Health (reference) | valid_current_sessions, partial_upload_sessions, session_completion_status | Realtà server → Supabase |
| File per tipo (mp4/csv/json) | Capture Pipeline | colonne *_files, daily_upload_stats | Realtà server → Supabase |
KPI presenti solo su OTEL: coorti di retention, utenti nuovi vs di ritorno, distribuzione delle versioni e upgrade, ciclo di vita dell'auth (BUG #7/#8), tassi di errore per servizio, funnel di cattura lato client e fallimenti del window-probe, esecuzioni del rilevatore della game library, capacità GPU.
KPI presenti solo su Supabase: ore validate cumulative, known_valid_current_recorded_hours rilevante per i pagamenti, copertura di durata, uploadability_status / block_reason per sessione, chiavi S3 per artefatto, lookup di identità tra steam/discord/email.