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

Przegląd

Dartastic pokazuje, co aplikacje Dart i Flutter naprawdę robią w rękach użytkowników, i pomaga naprawić to, co nie działa. Ta strona jest mapą. Wystarczy przeczytać ją raz, a potem przejść krok po kroku przez stronę Pierwsze kroki.

Platforma

Każda strona Pomocy pokazuje ten sam schemat z podświetlonymi częściami, których dotyczy, więc zawsze wiadomo, o którym miejscu platformy mowa.

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
  1. Budowanie odbywa się na komputerze i w CI. Aplikacja pobiera pakiety Dartastic z Dartastic Pub tak samo, jak pobiera pakiety z pub.dev.
  2. Aplikacja działa na telefonach i komputerach, w przeglądarkach i jako serwery Dart. Pakiety Dartastic OTel w aplikacji rejestrują, co się dzieje, i wysyłają to do Observatory.
  3. Gdy coś się psuje, Symbolizer przekłada awarię z powrotem na plik i linię kodu, korzystając z symboli opublikowanych w Dartastic Pub razem z aplikacją.
  4. Gdy trzeba wiedzieć, dlaczego, wystarczy zapytać Dartastic AI. Analizuje telemetrię i kod źródłowy w Dartastic Pub, a potem podaje przyczynę i poprawkę.
  5. Control Room to miejsce, w którym konfiguruje się to wszystko: tworzy tokeny, które otwierają każdą strzałkę na schemacie.

Elementy

ElementDo czego służyGdzie go znaleźć
Control RoomKonto. Tu tworzy się tokeny, zaprasza członków zespołu, wybiera plan i pobiera Reference Demo.dartastic.io/control-room, po zalogowaniu
Dartastic PubPrywatne repozytorium pakietów działające jak pub.dev. Pobiera się z niego pakiety Dartastic, przechowuje w nim własne prywatne pakiety i publikuje w nim kod źródłowy aplikacji.dart pub get, dart pub publish
Dartastic OTelPakiety dodawane do aplikacji. Rejestrują, co się w niej dzieje (ekrany, stuknięcia, wywołania sieciowe, błędy, awarie, wydajność), w formacie OpenTelemetry i wysyłają te dane.pubspec.yaml i main()
ObservatoryMiejsce, w którym ogląda się dane. Sesje z odtwarzaniem, trasy, logi, metryki, awarie, dashboardy i alerty dla wszystkiego, co wysyłają aplikacje.Otwierane z Control Room
SymbolizerPrzekłada nieczytelne stosy wywołań z obfuskowanego buildu release z powrotem na nazwy plików i numery linii. Działa samodzielnie, gdy tylko docierają awarie.Nie trzeba niczego wywoływać: odczytuje symbole publikowane w Dartastic Pub
Dartastic AIOdpowiada zwykłym językiem na pytania o aplikację. Analizuje telemetrię i kod źródłowy w Dartastic Pub, znajduje przyczynę i proponuje poprawkę.Przycisk „Ask” w Observatory i w Control Room

Co widać

Oto Observatory. Każda sesja użytkowników jest na liście razem z ekranami, stuknięciami, błędami i sygnałami frustracji:

Lista „Sessions” w Observatory, jeden wiersz na sesję użytkownika

Wystarczy otworzyć sesję i ją odtworzyć. Pod znacznikiem odtwarzania widać trasę, logi i błąd z danej chwili, a stamtąd można przejść prosto do linii kodu:

Nagranie sesji z osią czasu, trasą pod znacznikiem odtwarzania i jej logami

Tokeny łączą elementy

Każda strzałka na schemacie wymaga własnego rodzaju tokenu. Tworzy się je w Control Room, a każdy jest pokazywany tylko raz, więc należy go skopiować od razu po utworzeniu. Większość programistów nigdy nie używała tokenu z dart pub; strona Pub przeprowadza przez to krok po kroku.

TokenSkądDokądUmożliwia
Token PubKomputerDartastic Pubdart pub get może pobierać pakiety Dartastic i prywatne pakiety; dart pub publish może je wysyłać.
Wymiana w CICIDartastic PubCI odczytuje i publikuje pakiety bez żadnego przechowywanego tokenu.
Token OTLPAplikacja na telefonie lub komputerze, serwer DartObservatoryAplikacja może wysyłać telemetrię.
Token Browser OTLPAplikacja Flutter WebObservatoryAplikacja webowa może wysyłać telemetrię, wyłącznie z wymienionych witryn.

Wszystkie posiadane tokeny są na jednym ekranie. Strona Tokeny opisuje każdy rodzaj oraz sposób odwołania lub zastąpienia tokenu.

Gdzie to działa: plan

  • Cloud działa na infrastrukturze, którą Dartastic współdzieli między klientami. Dartastic Pub działa pod adresem pub.dartastic.io.
  • Dedicated daje organizacji własny serwer pod wybraną subdomeną: Dartastic Pub działa pod adresem pub.<subdomain>.dartastic.io.
  • Self-Hosted uruchamia całą platformę we własnej sieci.

Kroki są takie same w każdym planie. Tam, gdzie adres URL się różni, te strony podają oba. Porównaj plany.

Co jest potrzebne

  • Flutter 3.44 i Dart 3.12 lub nowsze dla wszystkich funkcji; Flutter 3.22 i Dart 3.4 dla wszystkiego poza metrykami Fluttera. Wersje wymagane przez poszczególne pakiety.
  • Konto Dartastic: rejestracja jest bezpłatna. Rejestracja uruchamia organizację w Cloud Free, bez karty.
  • Tylko dla serwera pogodowego w Reference Demo: Docker.

Jak się tego nauczyć

Można wybrać dowolny sposób; wszystkie obejmują ten sam zakres.

  • Lektura: te strony po kolei. Linki na dole każdej strony prowadzą do poprzedniej i następnej.
  • Uruchomienie Dartastic OTel Reference Demo. To rozszerzona komercyjna wersja otwartoźródłowego projektu Dart OTel Reference Demo: znacznie więcej dem, czyli działających aplikacji Flutter, które pokazują, jak używać każdej funkcji Dartastic, z gotową konfiguracją. Można czytać jego kod, kopiować z niego albo wskazać go asystentowi AI do programowania. Pobierz Reference Demo.
  • Kontakt: Wsparcie odpowiada na pytania.

Pojęcia używane na tych stronach

OpenTelemetry (OTel)
Otwarty standard rejestrowania tego, co robi oprogramowanie. Dartastic posługuje się nim od początku do końca, więc nic, co się napisze, nie jest uzależnione od Dartastic.
OTLP
Format przesyłu OpenTelemetry: sposób, w jaki aplikacja wysyła zarejestrowane dane.
Trasa i span
Span to jeden mierzony w czasie fragment pracy (stuknięcie, wywołanie sieciowe, zapytanie do bazy danych). Trasa to drzewo spanów jednej operacji, nawet gdy obejmuje aplikację i serwer.
Log
Linia tekstu zapisana przez aplikację, powiązana z trasą, w której powstała.
Metryka
Liczba mierzona w czasie: czasy klatek, pamięć, liczba żądań.
Sesja
Jedna wizyta jednej osoby w aplikacji, od uruchomienia do wyjścia, z każdym ekranem, stuknięciem, błędem i trasą.
Odtwarzanie
Ponowne obejrzenie sesji. Można wybrać, ile jest rejestrowane: oś czasu zdarzeń, wireframe albo prawdziwe piksele.
RUM
Real User Monitoring (monitorowanie rzeczywistych użytkowników): telemetria od osób, które naprawdę korzystają z aplikacji, a nie z testów.
Obfuskacja i symbole
Build release może obfuskować nazwy (flutter build --obfuscate). Zapisywany przy tym plik symboli (--split-debug-info) jest kluczem do ich odczytania.
Token
Długi tajny ciąg znaków, który pozwala jednemu elementowi komunikować się z jednym innym. Każdy rodzaj otwiera jedną ścieżkę na schemacie powyżej.