Deze pagina’s tonen de URL’s van Cloud. Log in op Dedicated, dan tonen ze die van uw server.

Dartastic OTel Reference Demo

Werkende Flutter-apps die elke functie van Dartastic laten zien, met de configuratie al gedaan. Draai ze om Dartastic van begin tot eind te zien werken, lees daarna hun code en neem eruit over wat u nodig heeft.

Het is de uitgebreide commerciële versie van Dart OTel Reference Demo, het opensourceproject, met veel meer demo’s. Elke app haalt zijn packages uit uw Dartastic Pub en verstuurt naar uw Observatory, dus wanneer de demo draait, is bewezen dat uw account werkt.

BUILDDARTASTIC-ARCHITECTUURGEBRUIKERStokensissuesPub-tokenpushCI-uitwisselingapps bereiken gebruikers via appstores, het web en serverssymbolencrashesstacktracesbroncodetelemetrieOntwikkelaarscomputerflutter run · dart pub getCIGitHub Actions, GitLab, …Control Roomtokens aanmaken · rolgebaseerd toegangsbeheerControl Planeorganisaties · rollen · tokensDartastic Pubpackages · broncodeObservatorysessies · traces · logsSymbolizercrashes → broncoderegelsDartastic AIantwoorden uit beideIssuetrackerGitHub · Jira · LinearMobiele en desktopappstelefoons · tablets · desktopsverstuurt met een OTLP-tokenWebappsin browsersverstuurt met een Browser OTLP-tokenDart-serversbackends · servicesverstuurt met een OTLP-token

Downloaden

Log in op de Control Room en druk op Reference Demo bovenaan elk scherm, naast “Help”:

De koptekst van de Control Room met de knop “Reference Demo”, naast “Help” en “Sign Out”

U downloadt dartastic-otel-reference-demo-<version>.tar.gz. Pak het uit waar u uw code bewaart:

shell
tar -xzf dartastic-otel-reference-demo-*.tar.gz
cd dartastic-otel-reference-demo-*

De README.md bovenaan is de volledige handleiding. Met de stappen hieronder komt u tot uw eerste run.

Op Dedicated: richt de demo op uw server

De demo is bij de start gericht op Dartastic Cloud, dus op Cloud hoeft u hier niets te doen. Op Dedicated voert u dit één keer uit met uw subdomein:

shell
tool/set-hosted-slug.sh <subdomain>

Het schrijft uw subdomein naar .env (dat git negeert) en werkt de pubspecs bij. Voer het opnieuw uit met een ander subdomein om over te stappen, of met "" om terug te gaan naar Cloud.

De tokens die de demo nodig heeft

Maak elk token aan op het scherm Tokens van de Control Room. Elk token wordt maar één keer getoond, dus kopieer het zodra u het aanmaakt.

TokenNodig voor
Pub-token
dart pub token add (één keer)
Elke demo: flutter pub get haalt de packages uit uw Dartastic Pub.
OTLP-token
OTEL_EXPORTER_OTLP_HEADERS
Elke demo: de apps sturen hun telemetrie naar uw Observatory.
Symbolizer-token
DARTASTIC_SYMBOLIZER_TOKEN
Alleen symbolizer_demo_flutter.

Een Pub-token met alleen leesrechten volstaat voor elke demo behalve symbolizer_demo_flutter en crash_demo_flutter: die publiceren naar uw Pub en hebben een token met lees- en schrijfrechten nodig. Aan de slag legt stap voor stap uit hoe u het Pub-token toevoegt en de andere exporteert.

Exporteer de tokens in uw shell in plaats van ze in .env te schrijven: een gedeeld of gecommit .env-bestand is een veelvoorkomende manier waarop geheimen uitlekken.

Een demo draaien

De demo is één Flutter-workspace, dus haal de packages van alle apps in één keer op vanuit de bovenste map:

shell
flutter pub get

Lukt dat, dan werken uw Dartastic Pub en uw Pub-token. Start daarna een app; tool/launch.sh vraagt op welk apparaat:

shell
tool/launch.sh --list          # every demo app
tool/launch.sh                 # weather_flutter
tool/launch.sh rum_demo_flutter
  • Docker is alleen nodig voor weather_flutter en all_demos_flutter: die starten de weer-API op uw computer om één trace over app en server heen te laten zien.
  • De demo’s draaien op Android, iOS, macOS, Windows en Linux, op apparaten en simulators. Ze draaien niet op het web.

Wat erin zit

AppWat de app laat zien
weather_flutterEén tik van begin tot eind getraced: de app, een weer-API, de cache ervan en de externe weerdienst, in één trace.
all_demos_flutterBijna elke demo als tabblad in één app.
rum_demo_flutterSessies, schermweergaven, tikken en frustratiesignalen, met session replay.
crash_demo_flutterCrashes vastgelegd en afgeleverd, ook wanneer de app stopt.
symbolizer_demo_flutterEen geobfusceerde releasebuild waarvan de stacktraces terugkomen als uw bestanden en regels, en jank herleid tot de widget.
anr_demo_flutterDetectie van App Not Responding.
pii_demo_flutterPersoonsgegevens buiten uw telemetrie houden.
webview_demo_flutterTelemetrie van een webpagina in uw app, gekoppeld aan de trace van de app.
PlatformvitalsReleasegezondheid, Android Vitals, iOS MetricKit, app-opstart, apparaatstatus, thermische status, onbetrouwbaar netwerk, gebruikerservaring en vitals van Linux-servers, elk in een eigen app.

Elke app linkt naar wat hij naar uw Observatory stuurde. Wilt u een functie leren kennen, draai dan de app ervan en lees daarna de code: het is het kleinste werkende voorbeeld van die functie. Wijs ook uw AI-codeerassistent erop.

Wat u ziet in het Observatory

Schermen van één run van de demo’s. Uw eigen run geeft eigen cijfers; wat elk scherm laat zien, is hetzelfde.

Bouwtijden van frames

all_demos_flutter op het scherm “Metric” voor flutter.frame.build, als heatmap: vier minuten aan frames, met de p95-lijn die gedurende de run stijgt.
all_demos_flutter op het scherm “Metric” voor flutter.frame.build, als heatmap: vier minuten aan frames, met de p95-lijn die gedurende de run stijgt.

Releasegezondheid

Traces gefilterd op de flutter.session-spans van de demo voor releasegezondheid, één per sessie. De rode is de sessie die crashte.
Traces gefilterd op de flutter.session-spans van de demo voor releasegezondheid, één per sessie. De rode is de sessie die crashte.

App-opstart

Het scherm “Metric” voor flutter.app.startup.duration, als heatmap: drie koude starts van ongeveer 2,2 s en twee warme starts van 33 en 63 ms.
Het scherm “Metric” voor flutter.app.startup.duration, als heatmap: drie koude starts van ongeveer 2,2 s en twee warme starts van 33 en 63 ms.

Onbetrouwbaar netwerk

Traces gefilterd op dartastic.network.flaky = true: twee onbetrouwbare requests, één van 6,56 s en één van 114 ms die met een fout eindigde.
Traces gefilterd op dartastic.network.flaky = true: twee onbetrouwbare requests, één van 6,56 s en één van 114 ms die met een fout eindigde.

Interaction to Next Paint

Het scherm “Metric” voor flutter.experience.inp, als heatmap: acht interacties, twee onder 16 ms en zes tussen 200 en 250 ms.
Het scherm “Metric” voor flutter.experience.inp, als heatmap: acht interacties, twee onder 16 ms en zes tussen 200 en 250 ms.

First Contentful Paint

Het scherm “Metric” voor flutter.experience.fcp: één first contentful paint, na 2,67 s.
Het scherm “Metric” voor flutter.experience.fcp: één first contentful paint, na 2,67 s.

App Not Responding, als events

Logs gefilterd op de dartastic.app.anr-events van anr_demo_flutter: drie ANR’s, geteld onder “Unspecified” omdat een event geen ernstniveau heeft, en elke rij toont de naam van het event.
Logs gefilterd op de dartastic.app.anr-events van anr_demo_flutter: drie ANR’s, geteld onder “Unspecified” omdat een event geen ernstniveau heeft, en elke rij toont de naam van het event.

App Not Responding, hoe lang

Dezelfde drie ANR’s op het scherm “Metric” voor flutter.anr.duration: elk 6,0 tot 6,6 s, op het moment van export.
Dezelfde drie ANR’s op het scherm “Metric” voor flutter.anr.duration: elk 6,0 tot 6,6 s, op het moment van export.

App-afsluitingen in iOS MetricKit

Het scherm “Metric” voor dartastic.app.exit.count, als staven: 50 afsluitingen in één stap van vijf minuten, 43 normaal, 3 door geheugentekort, 3 door de watchdog en 1 door een time-out.
Het scherm “Metric” voor dartastic.app.exit.count, als staven: 50 afsluitingen in één stap van vijf minuten, 43 normaal, 3 door geheugentekort, 3 door de watchdog en 1 door een time-out.