Dartastic OTel Reference Demo
Lauffähige Flutter-Apps, die jede Funktion von Dartastic zeigen, mit bereits erledigter Einrichtung. Führen Sie sie aus, um Dartastic von Anfang bis Ende arbeiten zu sehen, und lesen Sie dann ihren Code und übernehmen Sie daraus, was Sie brauchen.
Sie ist die erweiterte kommerzielle Version der Open-Source-Demo Dart OTel Reference Demo, mit vielen weiteren Demos. Jede App bezieht ihre Packages aus Ihrem Dartastic Pub und sendet an Ihr Observatory: Läuft die Demo, ist bewiesen, dass Ihr Konto funktioniert.
Herunterladen
Melden Sie sich im Control Room an und klicken Sie oben auf jeder Seite neben „Help“ auf Reference Demo:

Heruntergeladen wird dartastic-otel-reference-demo-<version>.tar.gz. Entpacken Sie die Datei dort, wo Sie Ihren Code aufbewahren:
tar -xzf dartastic-otel-reference-demo-*.tar.gz
cd dartastic-otel-reference-demo-*Die Datei README.md auf oberster Ebene ist die vollständige Anleitung. Die folgenden Schritte bringen Sie zum ersten Lauf.
Bei Dedicated: auf Ihren Server ausrichten
Die Demo ist zu Beginn auf Dartastic Cloud ausgerichtet, bei Cloud ist hier also nichts zu tun. Bei Dedicated führen Sie dies einmal mit Ihrer Subdomain aus:
tool/set-hosted-slug.sh <subdomain>Der Befehl schreibt Ihre Subdomain in .env (das git ignoriert) und aktualisiert die Pubspecs. Führen Sie ihn mit einer anderen Subdomain erneut aus, um zu wechseln, oder mit "", um zu Cloud zurückzukehren.
Die benötigten Tokens
Erstellen Sie jedes davon im Control Room auf der Seite Tokens. Jedes Token wird nur einmal angezeigt, kopieren Sie es also beim Erstellen.
| Token | Benötigt für |
|---|---|
Pub-Tokendart pub token add (einmalig) | Jede Demo: flutter pub get löst die Packages aus Ihrem Dartastic Pub auf. |
OTLP-TokenOTEL_EXPORTER_OTLP_HEADERS | Jede Demo: Die Apps senden ihre Telemetrie an Ihr Observatory. |
Symbolizer-TokenDARTASTIC_SYMBOLIZER_TOKEN | Nur symbolizer_demo_flutter. |
Ein Pub-Token mit Lesezugriff genügt für jede Demo außer symbolizer_demo_flutter und crash_demo_flutter: Diese veröffentlichen in Ihr Pub-Repository und brauchen ein Token mit Lese- und Schreibzugriff. Erste Schritte zeigt Schritt für Schritt, wie Sie das Pub-Token hinzufügen und die anderen exportieren.
Exportieren Sie die Tokens in Ihrer Shell, statt sie in .env zu schreiben: Eine geteilte oder committete .env ist ein häufiger Weg, auf dem Secrets nach außen gelangen.
Eine Demo ausführen
Die Demo ist ein einziger Flutter-Workspace. Laden Sie daher die Packages aller Apps auf einmal aus dem obersten Ordner:
flutter pub getGelingt das, funktionieren Ihr Dartastic Pub und Ihr Pub-Token. Starten Sie dann eine App; tool/launch.sh fragt, auf welchem Gerät sie laufen soll:
tool/launch.sh --list # every demo app
tool/launch.sh # weather_flutter
tool/launch.sh rum_demo_flutter- Docker wird nur für
weather_flutterundall_demos_flutterbenötigt: Sie starten die Wetter-API auf Ihrem Rechner, um einen einzigen Trace über App und Server hinweg zu zeigen. - Die Demos laufen auf Android, iOS, macOS, Windows und Linux, auf Geräten und in Simulatoren. Im Web laufen sie nicht.
Was enthalten ist
| App | Was sie zeigt |
|---|---|
weather_flutter | Ein Tap, von Anfang bis Ende verfolgt: die App, eine Wetter-API, ihr Cache und der externe Wetterdienst, in einem einzigen Trace. |
all_demos_flutter | Fast jede Demo als Tab in einer einzigen App. |
rum_demo_flutter | Sitzungen, Bildschirmaufrufe, Taps und Frustrationssignale, mit Session-Replay. |
crash_demo_flutter | Abstürze, aufgezeichnet und zugestellt, auch wenn die App beendet wird. |
symbolizer_demo_flutter | Ein obfuskierter Release-Build, dessen Stacktraces als Ihre Dateien und Zeilen zurückkommen, und Jank, bis zum Widget zurückverfolgt. |
anr_demo_flutter | Erkennung von „App reagiert nicht“ (ANR). |
pii_demo_flutter | Personenbezogene Daten aus Ihrer Telemetrie heraushalten. |
webview_demo_flutter | Telemetrie aus einer Webseite in Ihrer App, verknüpft mit dem Trace der App. |
| Plattform-Vitalmetriken | Release-Zustand, Android Vitals, iOS MetricKit, App-Start, Gerätezustand, thermischer Zustand, instabile Netzwerkverbindungen, Nutzererlebnis und Vitalmetriken von Linux-Servern, je eine App. |
Jede App verlinkt auf das, was sie an Ihr Observatory gesendet hat. Um eine Funktion kennenzulernen, führen Sie ihre App aus und lesen dann ihren Code: Er ist das kleinste lauffähige Beispiel dieser Funktion. Zeigen Sie ihn auch Ihrem KI-Coding-Assistenten.
Was Sie im Observatory sehen
Ansichten aus einem Lauf der Demos. Ihr eigener Lauf liefert eigene Werte; was jede Ansicht zeigt, ist dasselbe.
Frame-Build-Zeiten

Release-Zustand

App-Start

Instabile Netzwerkverbindungen

Interaction to Next Paint

First Contentful Paint

App reagiert nicht, als Events

App reagiert nicht, die Dauer

App-Beendigungen aus iOS MetricKit
