Queste pagine mostrano gli URL di Cloud. Acceda su Dedicated e vedrà quelli del suo server.

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.

BUILDARCHITETTURA DARTASTICUTENTItokentickettoken Pubpushscambio CIle app arrivano agli utenti: app store, web, serversimbolicrashstack tracecodice sorgentetelemetriaComputer dello sviluppatoreflutter run · dart pub getCIGitHub Actions, GitLab, …Control Roomcreazione di token · controllo degli accessi basato sui ruoliPiano di controlloorganizzazioni · ruoli · tokenDartastic Pubpacchetti · codice sorgenteObservatorysessioni · tracce · logSymbolizercrash → righe di codice sorgenteDartastic AIrisposte da entrambiSistema di ticketingGitHub · Jira · LinearApp mobile e desktoptelefoni · tablet · computerinvia con un token OTLPApp webnei browserinvia con un token Browser OTLPServer Dartbackend · serviziinvia con un token OTLP

Scaricarla

Acceda alla Control Room e prema Reference Demo in cima a ogni schermata, accanto a « Help »:

L’intestazione della Control Room con il pulsante « Reference Demo », accanto a « Help » e « Sign Out »

Viene scaricato dartastic-otel-reference-demo-<version>.tar.gz. Lo decomprima dove tiene il suo codice:

shell
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:

shell
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.

TokenServe per
Token Pub
dart pub token add (una volta)
Ogni demo: flutter pub get risolve i pacchetti dal suo Dartastic Pub.
Token OTLP
OTEL_EXPORTER_OTLP_HEADERS
Ogni demo: le app inviano la loro telemetria al suo Observatory.
Token Symbolizer
DARTASTIC_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:

shell
flutter pub get

Se 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:

shell
tool/launch.sh --list          # every demo app
tool/launch.sh                 # weather_flutter
tool/launch.sh rum_demo_flutter
  • Docker serve solo per weather_flutter e all_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

AppCosa mostra
weather_flutterUn 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_flutterQuasi tutte le demo come schede di un’unica app.
rum_demo_flutterSessioni, visualizzazioni di schermata, tap e segnali di frustrazione, con il replay di sessione.
crash_demo_flutterCrash registrati e consegnati anche quando l’app muore.
symbolizer_demo_flutterUna 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_flutterRilevamento degli ANR (L’app non risponde).
pii_demo_flutterTenere i dati personali fuori dalla telemetria.
webview_demo_flutterLa telemetria di una pagina web all’interno della sua app, unita alla traccia dell’app.
Metriche vitali della piattaformaStato 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

all_demos_flutter nella schermata « Metric » per flutter.frame.build, come mappa di calore: quattro minuti di frame, con la linea p95 che sale nel corso dell’esecuzione.
all_demos_flutter nella schermata « Metric » per flutter.frame.build, come mappa di calore: quattro minuti di frame, con la linea p95 che sale nel corso dell’esecuzione.

Stato delle release

« Traces » filtrato sugli span flutter.session della demo sullo stato delle release, uno per sessione. Quello in rosso è la sessione che ha avuto un crash.
« Traces » filtrato sugli span flutter.session della demo sullo stato delle release, uno per sessione. Quello in rosso è la sessione che ha avuto un crash.

Avvio dell’app

La schermata « Metric » per flutter.app.startup.duration, come mappa di calore: tre avvii a freddo di circa 2,2 s e due avvii a caldo di 33 e 63 ms.
La schermata « Metric » per flutter.app.startup.duration, come mappa di calore: tre avvii a freddo di circa 2,2 s e due avvii a caldo di 33 e 63 ms.

Instabilità della rete

« Traces » filtrato su dartastic.network.flaky = true: due richieste instabili, una durata 6,56 s e una di 114 ms terminata con un errore.
« Traces » filtrato su dartastic.network.flaky = true: due richieste instabili, una durata 6,56 s e una di 114 ms terminata con un errore.

Interaction to Next Paint

La schermata « Metric » per flutter.experience.inp, come mappa di calore: otto interazioni, due sotto i 16 ms e sei tra 200 e 250 ms.
La schermata « Metric » per flutter.experience.inp, come mappa di calore: otto interazioni, due sotto i 16 ms e sei tra 200 e 250 ms.

First Contentful Paint

La schermata « Metric » per flutter.experience.fcp: un first contentful paint, a 2,67 s.
La schermata « Metric » per flutter.experience.fcp: un first contentful paint, a 2,67 s.

ANR (L’app non risponde), come eventi

« Logs » filtrato sugli eventi dartastic.app.anr di anr_demo_flutter: tre ANR, contati sotto « Unspecified » perché un evento non ha gravità, e ogni riga mostra il nome del suo evento.
« Logs » filtrato sugli eventi dartastic.app.anr di anr_demo_flutter: tre ANR, contati sotto « Unspecified » perché un evento non ha gravità, e ogni riga mostra il nome del suo evento.

ANR (L’app non risponde), quanto durano

Gli stessi tre ANR nella schermata « Metric » per flutter.anr.duration: ciascuno da 6,0 a 6,6 s, al momento dell’esportazione.
Gli stessi tre ANR nella schermata « Metric » per flutter.anr.duration: ciascuno da 6,0 a 6,6 s, al momento dell’esportazione.

Uscite dell’app da iOS MetricKit

La schermata « Metric » per dartastic.app.exit.count, come barre: 50 uscite in un passo di cinque minuti, 43 normali, 3 per memoria esaurita, 3 per watchdog e 1 per timeout.
La schermata « Metric » per dartastic.app.exit.count, come barre: 50 uscite in un passo di cinque minuti, 43 normali, 3 per memoria esaurita, 3 per watchdog e 1 per timeout.