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:

Trzy sygnały

OpenTelemetry rejestruje trzy rodzaje danych, nazywane sygnałami:

Trasy
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.
Metryki
Liczby mierzone w czasie: czasy klatek, pamięć, żądania na minutę, błędy na wersję. Tanie w przechowywaniu, więc pokazują trendy i wyzwalają alerty.
Logi
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.

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

  1. W Control Room należy przejść do Tokens:
    Ekran „Tokens” w Control Room: „Generate Token” z przyciskami „+ Pub”, „+ Symbolizer”, „+ OTLP” i „+ Browser OTLP”
  2. Aby utworzyć token Pub, należy nacisnąć + Pub. Otwiera się okno:
    Okno „Generate Pub Token”: „Name”, uprawnienia tokenu, organizacja i „Allow write (publish) access”
    • 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.
  3. Należy kliknąć Generate. Token jest pokazywany raz:
    Nowy token Pub: „Token ID”, tajny token z przyciskiem kopiowania, polecenie dart pub token add i „Granted scopes: Pub”
    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.
  4. 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.
  5. 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.

Role opisuje strona Zapraszanie członków zespołu, a przydzielanie pakietów członkom organizacji strona Pub.

4. Wysyłanie telemetrii z aplikacji

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:

shell
export OTEL_EXPORTER_OTLP_HEADERS="authorization=Bearer <your OTLP token>"

5. Uruchomienie demo

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.

Co dalej