Diese Seiten zeigen die URLs von Cloud. Wenn Sie sich bei Dedicated anmelden, zeigen sie die Ihres Servers.

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.

ENTWICKLUNGDARTASTIC-ARCHITEKTURNUTZERTokensTicketsPub-TokenPushCI-AustauschApps gehen an Nutzer: App-Stores, Web, ServerSymboleAbstürzeStacktracesQuellcodeTelemetrieEntwicklerrechnerflutter run · dart pub getCIGitHub Actions, GitLab, …Control RoomTokens erstellen · rollenbasierte ZugriffskontrolleControl PlaneOrganisationen · Rollen · TokensDartastic PubPackages · QuellcodeObservatorySitzungen · Traces · LogsSymbolizerAbstürze → QuellcodezeilenDartastic AIAntworten aus beidenIssue-TrackerGitHub · Jira · LinearMobile + Desktop-AppsSmartphones · Tablets · Desktopssendet mit einem OTLP-TokenWeb-Appsim Browsersendet mit einem Browser-OTLP-TokenDart-ServerBackends · Dienstesendet mit einem OTLP-Token

Herunterladen

Melden Sie sich im Control Room an und klicken Sie oben auf jeder Seite neben „Help“ auf Reference Demo:

Die Kopfzeile des Control Room mit der Schaltfläche „Reference Demo“ neben „Help“ und „Sign Out“

Heruntergeladen wird dartastic-otel-reference-demo-<version>.tar.gz. Entpacken Sie die Datei dort, wo Sie Ihren Code aufbewahren:

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

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

TokenBenötigt für
Pub-Token
dart pub token add (einmalig)
Jede Demo: flutter pub get löst die Packages aus Ihrem Dartastic Pub auf.
OTLP-Token
OTEL_EXPORTER_OTLP_HEADERS
Jede Demo: Die Apps senden ihre Telemetrie an Ihr Observatory.
Symbolizer-Token
DARTASTIC_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:

shell
flutter pub get

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

shell
tool/launch.sh --list          # every demo app
tool/launch.sh                 # weather_flutter
tool/launch.sh rum_demo_flutter
  • Docker wird nur für weather_flutter und all_demos_flutter benö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

AppWas sie zeigt
weather_flutterEin Tap, von Anfang bis Ende verfolgt: die App, eine Wetter-API, ihr Cache und der externe Wetterdienst, in einem einzigen Trace.
all_demos_flutterFast jede Demo als Tab in einer einzigen App.
rum_demo_flutterSitzungen, Bildschirmaufrufe, Taps und Frustrationssignale, mit Session-Replay.
crash_demo_flutterAbstürze, aufgezeichnet und zugestellt, auch wenn die App beendet wird.
symbolizer_demo_flutterEin obfuskierter Release-Build, dessen Stacktraces als Ihre Dateien und Zeilen zurückkommen, und Jank, bis zum Widget zurückverfolgt.
anr_demo_flutterErkennung von „App reagiert nicht“ (ANR).
pii_demo_flutterPersonenbezogene Daten aus Ihrer Telemetrie heraushalten.
webview_demo_flutterTelemetrie aus einer Webseite in Ihrer App, verknüpft mit dem Trace der App.
Plattform-VitalmetrikenRelease-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

all_demos_flutter in der Ansicht „Metric“ für flutter.frame.build, als Heatmap: vier Minuten Frames, mit einer p95-Linie, die im Lauf ansteigt.
all_demos_flutter in der Ansicht „Metric“ für flutter.frame.build, als Heatmap: vier Minuten Frames, mit einer p95-Linie, die im Lauf ansteigt.

Release-Zustand

Traces, gefiltert auf die flutter.session-Spans der Release-Zustand-Demo, einer pro Sitzung. Der rote ist die Sitzung, die abgestürzt ist.
Traces, gefiltert auf die flutter.session-Spans der Release-Zustand-Demo, einer pro Sitzung. Der rote ist die Sitzung, die abgestürzt ist.

App-Start

Die Ansicht „Metric“ für flutter.app.startup.duration, als Heatmap: drei Kaltstarts von etwa 2,2 s und zwei Heißstarts von 33 und 63 ms.
Die Ansicht „Metric“ für flutter.app.startup.duration, als Heatmap: drei Kaltstarts von etwa 2,2 s und zwei Heißstarts von 33 und 63 ms.

Instabile Netzwerkverbindungen

Traces, gefiltert auf dartastic.network.flaky = true: zwei instabile Anfragen, eine mit 6,56 s und eine mit 114 ms, die mit einem Fehler endete.
Traces, gefiltert auf dartastic.network.flaky = true: zwei instabile Anfragen, eine mit 6,56 s und eine mit 114 ms, die mit einem Fehler endete.

Interaction to Next Paint

Die Ansicht „Metric“ für flutter.experience.inp, als Heatmap: acht Interaktionen, zwei unter 16 ms und sechs bei 200 bis 250 ms.
Die Ansicht „Metric“ für flutter.experience.inp, als Heatmap: acht Interaktionen, zwei unter 16 ms und sechs bei 200 bis 250 ms.

First Contentful Paint

Die Ansicht „Metric“ für flutter.experience.fcp: ein First Contentful Paint, bei 2,67 s.
Die Ansicht „Metric“ für flutter.experience.fcp: ein First Contentful Paint, bei 2,67 s.

App reagiert nicht, als Events

Logs, gefiltert auf die dartastic.app.anr-Events von anr_demo_flutter: drei ANRs, gezählt unter „Unspecified“, weil ein Event keinen Schweregrad trägt, und jede Zeile zeigt ihren Event-Namen.
Logs, gefiltert auf die dartastic.app.anr-Events von anr_demo_flutter: drei ANRs, gezählt unter „Unspecified“, weil ein Event keinen Schweregrad trägt, und jede Zeile zeigt ihren Event-Namen.

App reagiert nicht, die Dauer

Dieselben drei ANRs in der Ansicht „Metric“ für flutter.anr.duration: jeweils 6,0 bis 6,6 s, zum Zeitpunkt ihres Exports.
Dieselben drei ANRs in der Ansicht „Metric“ für flutter.anr.duration: jeweils 6,0 bis 6,6 s, zum Zeitpunkt ihres Exports.

App-Beendigungen aus iOS MetricKit

Die Ansicht „Metric“ für dartastic.app.exit.count, als Balken: 50 Beendigungen in einem Fünf-Minuten-Schritt, davon 43 normal, 3 wegen Speichermangels, 3 durch den Watchdog und 1 durch Timeout.
Die Ansicht „Metric“ für dartastic.app.exit.count, als Balken: 50 Beendigungen in einem Fünf-Minuten-Schritt, davon 43 normal, 3 wegen Speichermangels, 3 durch den Watchdog und 1 durch Timeout.