Od pierwszego logowania po odpowiedzi na pytania o aplikację w produkcji.
Te strony pokazują adresy URL Cloud. Po zalogowaniu się na Dedicated pokazują adresy własnego serwera: Zaloguj się.
Pierwsze kroki
Od pierwszego kontaktu z OpenTelemetry do własnej trasy w Observatory. Każdy krok opiera się na poprzednim, dlatego należy przechodzić je po kolei.
O OpenTelemetry
Na początek OpenTelemetry
Dartastic jest zbudowany na OpenTelemetry (OTel), otwartym standardzie rejestrowania tego, co robi oprogramowanie. Dartastic ściśle trzyma się specyfikacji OpenTelemetry: nazwy, dane i sposób ich wysyłania są standardowe. Wiedza o OpenTelemetry dotyczy też Dartastic, a to, co powstaje z Dartastic, pozostaje standardowym OpenTelemetry.
Specyfikacja jest przystępna. Przed dalszą lekturą warto poświęcić godzinę dokumentacji OpenTelemetry, by zrozumieć podstawy:
Co się wydarzyło, krok po kroku, i ile trwał każdy krok. Trasa to drzewo spanów: stuknięcie, uruchomione przez nie wywołanie sieciowe, obsługująca je praca serwera i wykonane przy tym zapytanie do bazy danych. Jedna trasa może przejść z aplikacji do serwera.
Linie tekstu z czasem i poziomem ważności. W OpenTelemetry log jest powiązany z trasą, w której został zapisany, więc z logu można otworzyć wszystko inne, co wydarzyło się w tej chwili.
Wszystkie trzy zawierają zasób: która aplikacja je wysłała, w jakiej wersji, na jakim urządzeniu. Dartastic dodaje do tego monitorowanie rzeczywistych użytkowników (sesje, ekrany, stuknięcia i odtwarzanie), także rejestrowane jako standardowe sygnały. Strona Przegląd wyjaśnia inne pojęcia używane na tych stronach.
1. Logowanie
Zaloguj się w dartastic.io. Przy pierwszym logowaniu konfiguruje się organizację: konto, do którego należą tokeny, członkowie zespołu i plan. Osoba zaproszona przez członka zespołu loguje się adresem e-mail, na który przyszło zaproszenie, i wtedy dołącza do istniejącej organizacji zamiast tworzyć nową.
Rejestracja uruchamia organizację w Cloud Free, bez karty. Trzeba podać:
Nazwa organizacji i subdomena: jej nazwę oraz subdomenę, do której aplikacje wysyłają telemetrię. Subdomena zostaje przy organizacji na stałe.
Region: miejsce przechowywania telemetrii. Nie można go później zmienić.
Limit RUM: najwyższy poziom odtwarzania, jaki silnik może nagrywać. Cloud Free sięga do poziomu Wireframe; Shadow i Pixel są dostępne w płatnych planach. Silnik jest wykuwany z tym wyborem i nic na urządzeniu nie może go przekroczyć.
Dartastic AI: działa na własnym kluczu do modelu, który można dodać od razu albo później.
Aby korzystać tylko z Dartastic Pub, przed rejestracją proszę wybrać plan Pub na stronie Cennik. Podaje się nazwę organizacji i wybiera jej region, i o nic więcej nie ma pytań.
Następuje przekierowanie do Control Room. Strona Organization pokazuje nazwę i identyfikator organizacji.
2. Pobranie Reference Demo
Należy nacisnąć Reference Demo u góry Control Room i rozpakować archiwum. Demo uruchamia się w kroku 5: to najszybszy sposób, by zobaczyć Dartastic w działaniu, a jego kod pokazuje, jak używać każdej funkcji. Więcej o Reference Demo.
3. Połączenie dart pub z Dartastic Pub
Pakiety Dartastic pochodzą z Dartastic Pub, nie z pub.dev, a dart pub potrzebuje tokenu, by z niego czytać. Większość programistów nigdy wcześniej tego nie robiła; zajmuje to minutę, raz na komputer.
Dartastic Pub przekazuje też zapytania do pub.dev. Pakiety definiuje się w pubspec.yaml tak jak zawsze, a te z pub.dev są automatycznie pobierane z pub.dev, obok pakietów Dartastic i prywatnych.
Aby utworzyć token Pub, należy nacisnąć + Pub. Otwiera się okno:
Name: dowolna nazwa, która odróżnia tokeny; zalecamy pub-org-read-write.
Organization: organizacja, której pakiety ten token odczytuje i publikuje.
Allow write (publish) access: zaznaczenie pozwala publikować tym tokenem w Dartastic Pub. Bez niego token może tylko czytać, a to wystarcza całemu Reference Demo z wyjątkiem symbolizer_demo_flutter i crash_demo_flutter, które publikują w Dartastic Pub.
Należy kliknąć Generate. Token jest pokazywany raz: Należy od razu skopiować token przyciskiem kopiowania: po zamknięciu okna nie da się go ponownie wyświetlić. Granted scopes: Pub oznacza, że token służy tylko do Dartastic Pub: nie może wysyłać telemetrii ani wywoływać żadnej innej usługi.
W powłoce należy przekazać token do dart pub:
shell
dart pub token add https://pub.dartastic.io
Gdy pojawi się monit Enter secret token:, należy wkleić token i nacisnąć Enter. Podczas wklejania monit niczego nie wyświetla; tak ma być. Odpowiedź:
terminal
Enter secret token:
Requests to "https://pub.dartastic.io" will now be authenticated using the secret token.
W folderze Reference Demo należy pobrać jego pakiety:
shell
flutter pub get
Jeśli polecenie się powiedzie, Dartastic Pub i token działają.
dart pub przechowuje token dla tego hosta i wysyła go tylko tam. Strona Pub opisuje wyświetlanie, zastępowanie i usuwanie tokenów oraz publikowanie.
Do których pakietów sięga token Pub
Token Pub sięga do pakietów, z których może korzystać jego właściciel, i do żadnych innych.
Administratorzy organizacji mają dostęp do każdego pakietu w organizacji, więc ich tokeny także.
Pozostali członkowie zespołu mogą tworzyć tokeny tylko dla przydzielonych im pakietów. Pakiety członkom zespołu przydziela administrator.
Na ekranie Tokens należy utworzyć token OTLP, a następnie wyeksportować go w powłoce w standardowej postaci OpenTelemetry. authorization należy zapisać małymi literami:
Przy uruchomionym Dockerze należy uruchomić demo pogodowe z folderu Reference Demo i wybrać urządzenie:
shell
tool/launch.sh weather_flutter
Należy stuknąć, aby pobrać pogodę. To stuknięcie rozpoczyna trasę, która przechodzi przez aplikację, API pogodowe, jego pamięć podręczną i zewnętrzną usługę pogodową.
6. Podgląd w Observatory
Stuknięcie dociera do Observatory w ciągu kilku sekund. Aplikacja podaje link do wysłanych danych: otwiera on trasę, w której widać każdy krok i czas jego trwania.