Te strony pokazują adresy URL Cloud. Po zalogowaniu się na Dedicated pokazują adresy własnego serwera: Zaloguj się.

Dartastic OTel Reference Demo

Działające aplikacje Flutter, które pokazują każdą funkcję Dartastic, z gotową konfiguracją. Można je uruchomić, by zobaczyć Dartastic w działaniu od początku do końca, a potem czytać ich kod i z niego kopiować.

To rozszerzona komercyjna wersja otwartoźródłowego projektu Dart OTel Reference Demo, ze znacznie większą liczbą dem. Każda aplikacja pobiera pakiety z Dartastic Pub i wysyła dane do Observatory, więc gdy demo działa, wiadomo, że konto działa.

BUDOWANIEARCHITEKTURA DARTASTICUŻYTKOWNICYtokenyzgłoszeniatoken Pubpushwymiana w CIaplikacje trafiają do użytkowników: sklepy z aplikacjami, web, serwerysymboleawariestosy wywołańkod źródłowytelemetriaKomputer programistyflutter run · dart pub getCIGitHub Actions, GitLab, …Control Roomtworzenie tokenów · kontrola dostępu oparta na rolachPłaszczyzna sterowaniaorganizacje · role · tokenyDartastic Pubpakiety · kod źródłowyObservatorysesje · trasy · logiSymbolizerawarie → linie kodu źródłowegoDartastic AIodpowiedzi z obu źródełSystem zgłoszeńGitHub · Jira · LinearAplikacje mobilne i desktopowetelefony · tablety · komputerywysyła z tokenem OTLPAplikacje webowew przeglądarkachwysyła z tokenem Browser OTLPSerwery Dartbackendy · usługiwysyła z tokenem OTLP

Pobieranie

Należy zalogować się do Control Room i nacisnąć Reference Demo u góry każdego ekranu, obok „Help”:

Nagłówek Control Room z przyciskiem „Reference Demo” obok „Help” i „Sign Out”

Pobiera się plik dartastic-otel-reference-demo-<version>.tar.gz. Należy rozpakować go tam, gdzie przechowuje się kod:

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

Plik README.md w głównym folderze to pełny przewodnik. Poniższe kroki prowadzą do pierwszego uruchomienia.

W Dedicated: wskazanie własnego serwera

Demo jest domyślnie skierowane na Dartastic Cloud, więc w Cloud nie trzeba tu nic robić. W Dedicated należy uruchomić to raz z własną subdomeną:

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

Polecenie zapisuje subdomenę w .env (ignorowanym przez git) i aktualizuje pliki pubspec. Aby przełączyć się na inną subdomenę, wystarczy uruchomić je ponownie z nią, a aby wrócić do Cloud, z "".

Potrzebne tokeny

Każdy z nich tworzy się na ekranie Tokens w Control Room. Każdy token jest pokazywany tylko raz, więc należy go skopiować od razu po utworzeniu.

TokenDo czego jest potrzebny
Token Pub
dart pub token add (raz)
Każde demo: flutter pub get pobiera pakiety z Dartastic Pub.
Token OTLP
OTEL_EXPORTER_OTLP_HEADERS
Każde demo: aplikacje wysyłają telemetrię do Observatory.
Token Symbolizer
DARTASTIC_SYMBOLIZER_TOKEN
Tylko symbolizer_demo_flutter.

Token Pub tylko do odczytu wystarcza do każdego demo z wyjątkiem symbolizer_demo_flutter i crash_demo_flutter, które publikują w Dartastic Pub i potrzebują tokenu do odczytu i zapisu. Strona Pierwsze kroki pokazuje, jak dodać token Pub i wyeksportować pozostałe.

Tokeny należy eksportować w powłoce, zamiast zapisywać je w .env: udostępniony lub zatwierdzony w repozytorium plik .env to częsta droga wycieku sekretów.

Uruchamianie demo

Demo to jeden workspace Flutter, więc pakiety wszystkich aplikacji pobiera się naraz z jego głównego folderu:

shell
flutter pub get

Jeśli to się uda, Dartastic Pub i token Pub działają. Potem można uruchomić aplikację; tool/launch.sh pyta, na którym urządzeniu:

shell
tool/launch.sh --list          # every demo app
tool/launch.sh                 # weather_flutter
tool/launch.sh rum_demo_flutter
  • Docker jest potrzebny tylko dla weather_flutter i all_demos_flutter: uruchamiają one API pogodowe na komputerze, by pokazać jedną trasę obejmującą aplikację i serwer.
  • Dema działają na platformach Android, iOS, macOS, Windows i Linux, na urządzeniach i symulatorach. Nie działają w przeglądarce.

Zawartość

AplikacjaCo pokazuje
weather_flutterJedno stuknięcie śledzone od początku do końca: aplikacja, API pogodowe, jego pamięć podręczna i zewnętrzny serwis pogodowy w jednej trasie.
all_demos_flutterPrawie każde demo jako karta w jednej aplikacji.
rum_demo_flutterSesje, wyświetlenia ekranów, stuknięcia i sygnały frustracji, z odtwarzaniem sesji.
crash_demo_flutterAwarie rejestrowane i dostarczane nawet wtedy, gdy aplikacja przestaje działać.
symbolizer_demo_flutterObfuskowany build release, którego stosy wywołań wracają jako pliki i linie kodu, oraz jank przypisany do widgetu.
anr_demo_flutterWykrywanie ANR (Aplikacja nie odpowiada).
pii_demo_flutterUsuwanie danych osobowych z telemetrii.
webview_demo_flutterTelemetria ze strony internetowej wewnątrz aplikacji, połączona z trasą aplikacji.
Wskaźniki platformyKondycja wersji, Android Vitals, iOS MetricKit, uruchamianie aplikacji, stan urządzenia, stan termiczny, niestabilność sieci, doświadczenie użytkownika i wskaźniki vitals serwera Linux, po jednej aplikacji na każdy temat.

Każda aplikacja zawiera link do danych, które wysłała do Observatory. Aby poznać funkcję, wystarczy uruchomić jej aplikację, a potem przeczytać jej kod: to najmniejszy działający przykład tej funkcji. Można też wskazać go asystentowi AI do programowania.

Co widać w Observatory

Ekrany z jednego uruchomienia dem. Własne uruchomienie daje własne wartości; to, co pokazuje każdy ekran, jest takie samo.

Czasy budowania klatek

all_demos_flutter na ekranie „Metric” dla flutter.frame.build jako mapa cieplna: cztery minuty klatek, z linią p95 rosnącą w trakcie uruchomienia.
all_demos_flutter na ekranie „Metric” dla flutter.frame.build jako mapa cieplna: cztery minuty klatek, z linią p95 rosnącą w trakcie uruchomienia.

Kondycja wersji

Trasy przefiltrowane do spanów flutter.session z demo kondycji wersji, po jednym na sesję. Ten na czerwono to sesja, w której wystąpiła awaria.
Trasy przefiltrowane do spanów flutter.session z demo kondycji wersji, po jednym na sesję. Ten na czerwono to sesja, w której wystąpiła awaria.

Uruchamianie aplikacji

Ekran „Metric” dla flutter.app.startup.duration jako mapa cieplna: trzy zimne starty po około 2,2 s i dwa gorące starty, 33 i 63 ms.
Ekran „Metric” dla flutter.app.startup.duration jako mapa cieplna: trzy zimne starty po około 2,2 s i dwa gorące starty, 33 i 63 ms.

Niestabilność sieci

Trasy przefiltrowane do dartastic.network.flaky = true: dwa niestabilne żądania, jedno trwające 6,56 s i jedno trwające 114 ms, zakończone błędem.
Trasy przefiltrowane do dartastic.network.flaky = true: dwa niestabilne żądania, jedno trwające 6,56 s i jedno trwające 114 ms, zakończone błędem.

Interaction to Next Paint

Ekran „Metric” dla flutter.experience.inp jako mapa cieplna: osiem interakcji, dwie poniżej 16 ms i sześć w przedziale 200–250 ms.
Ekran „Metric” dla flutter.experience.inp jako mapa cieplna: osiem interakcji, dwie poniżej 16 ms i sześć w przedziale 200–250 ms.

First Contentful Paint

Ekran „Metric” dla flutter.experience.fcp: jedno zdarzenie First Contentful Paint, po 2,67 s.
Ekran „Metric” dla flutter.experience.fcp: jedno zdarzenie First Contentful Paint, po 2,67 s.

App Not Responding jako zdarzenia

Logi przefiltrowane do zdarzeń dartastic.app.anr aplikacji anr_demo_flutter: trzy ANR, liczone w kategorii „Unspecified”, bo zdarzenie nie ma poziomu ważności, a każdy wiersz pokazuje nazwę swojego zdarzenia.
Logi przefiltrowane do zdarzeń dartastic.app.anr aplikacji anr_demo_flutter: trzy ANR, liczone w kategorii „Unspecified”, bo zdarzenie nie ma poziomu ważności, a każdy wiersz pokazuje nazwę swojego zdarzenia.

App Not Responding: czas trwania

Te same trzy ANR na ekranie „Metric” dla flutter.anr.duration: każdy trwał 6,0–6,6 s w chwili eksportu.
Te same trzy ANR na ekranie „Metric” dla flutter.anr.duration: każdy trwał 6,0–6,6 s w chwili eksportu.

Zakończenia aplikacji w iOS MetricKit

Ekran „Metric” dla dartastic.app.exit.count jako wykres słupkowy: 50 zakończeń w jednym pięciominutowym kroku, 43 normalne, 3 z braku pamięci, 3 przez watchdog i 1 przez przekroczenie czasu.
Ekran „Metric” dla dartastic.app.exit.count jako wykres słupkowy: 50 zakończeń w jednym pięciominutowym kroku, 43 normalne, 3 z braku pamięci, 3 przez watchdog i 1 przez przekroczenie czasu.