Dartastic OTel Reference Demo
App Flutter funzionanti che mostrano ogni funzionalità di Dartastic, con la configurazione già fatta. Le esegua per vedere Dartastic all’opera da un capo all’altro, poi ne legga il codice e lo copi.
È la versione commerciale avanzata della Dart OTel Reference Demo open source, con molte più demo. Ogni app risolve i suoi pacchetti dal suo Dartastic Pub e invia i dati al suo Observatory, quindi quando la demo funziona, è provato che il suo account funziona.
Scaricarla
Acceda alla Control Room e prema Reference Demo in cima a ogni schermata, accanto a « Help »:

Viene scaricato dartastic-otel-reference-demo-<version>.tar.gz. Lo decomprima dove tiene il suo codice:
tar -xzf dartastic-otel-reference-demo-*.tar.gz
cd dartastic-otel-reference-demo-*Il README.md nella cartella principale è la guida completa. I passaggi qui sotto la portano alla prima esecuzione.
Su Dedicated: puntarla al suo server
La demo parte puntata su Dartastic Cloud, quindi su Cloud qui non c’è nulla da fare. Su Dedicated, esegua questo comando una volta con il suo sottodominio:
tool/set-hosted-slug.sh <subdomain>Scrive il suo sottodominio in .env (che git ignora) e aggiorna i pubspec. Lo esegua di nuovo con un altro sottodominio per cambiare, o con "" per tornare a Cloud.
I token necessari
Crei ciascuno nella schermata Tokens della Control Room. Ogni token viene mostrato una sola volta, quindi lo copi quando lo crea.
| Token | Serve per |
|---|---|
Token Pubdart pub token add (una volta) | Ogni demo: flutter pub get risolve i pacchetti dal suo Dartastic Pub. |
Token OTLPOTEL_EXPORTER_OTLP_HEADERS | Ogni demo: le app inviano la loro telemetria al suo Observatory. |
Token SymbolizerDARTASTIC_SYMBOLIZER_TOKEN | Solo symbolizer_demo_flutter. |
Un token Pub di sola lettura basta per ogni demo tranne symbolizer_demo_flutter e crash_demo_flutter, che pubblicano sul suo Pub e richiedono un token di lettura e scrittura. Primi passi spiega passo passo come aggiungere il token Pub ed esportare gli altri.
Esporti i token nella sua shell invece di scriverli in .env: un .env condiviso o salvato nel repository è un modo frequente in cui i segreti trapelano.
Eseguire una demo
La demo è un unico workspace Flutter, quindi scarichi i pacchetti di tutte le app in una volta dalla sua cartella principale:
flutter pub getSe l’operazione riesce, il suo Dartastic Pub e il suo token Pub funzionano. Poi avvii un’app; tool/launch.sh chiede su quale dispositivo eseguirla:
tool/launch.sh --list # every demo app
tool/launch.sh # weather_flutter
tool/launch.sh rum_demo_flutter- Docker serve solo per
weather_fluttereall_demos_flutter: avviano l’API meteo sulla sua macchina per mostrare una sola traccia tra app e server. - Le demo funzionano su Android, iOS, macOS, Windows e Linux, su dispositivi e simulatori. Non funzionano sul web.
Cosa contiene
| App | Cosa mostra |
|---|---|
weather_flutter | Un tap tracciato da un capo all’altro: l’app, un’API meteo, la sua cache e il servizio meteo esterno, in una sola traccia. |
all_demos_flutter | Quasi tutte le demo come schede di un’unica app. |
rum_demo_flutter | Sessioni, visualizzazioni di schermata, tap e segnali di frustrazione, con il replay di sessione. |
crash_demo_flutter | Crash registrati e consegnati anche quando l’app muore. |
symbolizer_demo_flutter | Una build di release offuscata i cui stack trace tornano come i suoi file e le sue righe, e il jank ricondotto al widget. |
anr_demo_flutter | Rilevamento degli ANR (L’app non risponde). |
pii_demo_flutter | Tenere i dati personali fuori dalla telemetria. |
webview_demo_flutter | La telemetria di una pagina web all’interno della sua app, unita alla traccia dell’app. |
| Metriche vitali della piattaforma | Stato delle release, Android Vitals, iOS MetricKit, avvio dell’app, stato del dispositivo, stato termico, instabilità della rete, esperienza utente e metriche vitali dei server Linux, un’app per ciascuno. |
Ogni app contiene i link a ciò che ha inviato nel suo Observatory. Per imparare una funzionalità, esegua la sua app, poi ne legga il codice: è il più piccolo esempio funzionante di quella funzionalità. Lo indichi anche al suo assistente di programmazione IA.
Cosa vede nell’Observatory
Schermate di un’esecuzione delle demo. La sua esecuzione dà i propri valori; ciò che mostra ogni schermata è lo stesso.
Tempi di build dei frame

Stato delle release

Avvio dell’app

Instabilità della rete

Interaction to Next Paint

First Contentful Paint

ANR (L’app non risponde), come eventi

ANR (L’app non risponde), quanto durano

Uscite dell’app da iOS MetricKit
