Deze pagina’s tonen de URL’s van Cloud. Log in op Dedicated, dan tonen ze die van uw server.

Aan de slag

Van een eerste kennismaking met OpenTelemetry tot uw eigen trace in het Observatory. Elke stap bouwt voort op de vorige, dus volg ze op volgorde.

Over OpenTelemetry

Begin met OpenTelemetry

Dartastic is gebouwd op OpenTelemetry (OTel), de open standaard om vast te leggen wat software doet. Dartastic volgt de OpenTelemetry-specificatie nauwgezet: de namen, de gegevens en de manier van versturen zijn die van de standaard. Wat u over OpenTelemetry leert, geldt voor Dartastic, en wat u met Dartastic bouwt, blijft standaard OpenTelemetry.

De specificatie is goed te volgen. Neem, voordat u verdergaat, een uur de tijd voor de OpenTelemetry-documentatie om de basis te begrijpen:

De drie signalen

OpenTelemetry legt drie soorten gegevens vast, signalen genoemd:

Traces
Wat er stap voor stap gebeurde, en hoe lang elke stap duurde. Een trace is een boom van spans: een tik, de netwerkaanroep die daaruit volgde, het serverwerk achter die aanroep, de databasequery daaronder. Eén trace kan van uw app doorlopen naar uw server.
Metrics
Getallen die in de tijd worden gemeten: frametijden, geheugen, requests per minuut, fouten per release. Goedkoop om te bewaren, dus ze tonen trends en activeren alerts.
Logs
Regels tekst met een tijdstip en een ernstniveau. In OpenTelemetry verwijst een log naar de trace waarin hij werd geschreven, dus vanuit een log opent u al het andere dat op dat moment gebeurde.

Alle drie bevatten een resource: welke app ze stuurde, welke versie, op welk apparaat. Dartastic voegt daar monitoring van echte gebruikers aan toe (sessies, schermen, tikken en replay), ook vastgelegd als standaardsignalen. Het Overzicht legt de andere begrippen uit die deze pagina’s gebruiken.

BUILDDARTASTIC-ARCHITECTUURGEBRUIKERStokensissuesPub-tokenpushCI-uitwisselingapps bereiken gebruikers via appstores, het web en serverssymbolencrashesstacktracesbroncodetelemetrieOntwikkelaarscomputerflutter run · dart pub getCIGitHub Actions, GitLab, …Control Roomtokens aanmaken · rolgebaseerd toegangsbeheerControl Planeorganisaties · rollen · tokensDartastic Pubpackages · broncodeObservatorysessies · traces · logsSymbolizercrashes → broncoderegelsDartastic AIantwoorden uit beideIssuetrackerGitHub · Jira · LinearMobiele en desktopappstelefoons · tablets · desktopsverstuurt met een OTLP-tokenWebappsin browsersverstuurt met een Browser OTLP-tokenDart-serversbackends · servicesverstuurt met een OTLP-token

1. Inloggen

Log in op dartastic.io. De eerste keer stelt u uw organisatie in: het account waartoe uw tokens, teamgenoten en abonnement behoren. Heeft een teamgenoot u uitgenodigd, log dan in met het e-mailadres waarnaar de uitnodiging is gestuurd. U wordt dan lid van diens organisatie.

Met uw registratie start uw organisatie op Cloud Free, zonder kaart. U wordt gevraagd naar:

  • Naam van de organisatie en subdomein: de naam van de organisatie, en het subdomein waarnaar uw apps telemetrie sturen. Het subdomein is voorgoed van u.
  • Regio: waar uw telemetrie wordt opgeslagen. Dit kan later niet worden gewijzigd.
  • RUM-limiet: het hoogste replayniveau dat uw engine mag opnemen. Cloud Free gaat tot en met Wireframe; Shadow en Pixel zitten in de betaalde abonnementen. Uw engine wordt gesmeed met uw keuze, en niets op het apparaat kan dat niveau overschrijden.
  • Dartastic AI: werkt met uw eigen modelsleutel, die u dan of later kunt toevoegen.

Voor alleen Dartastic Pub kiest u een Pub-abonnement op Prijzen voordat u zich registreert. U geeft uw organisatie een naam en kiest de regio, en verder wordt niets gevraagd.

U komt terecht in de Control Room. Het scherm Organization toont de naam en het id van uw organisatie.

2. De Reference Demo downloaden

Druk op Reference Demo bovenaan de Control Room en pak het bestand uit. U draait de demo in stap 5: zo ziet u het snelst Dartastic aan het werk, en de code laat zien hoe u elke functie gebruikt. Meer over de Reference Demo.

3. dart pub verbinden met uw Dartastic Pub

De Dartastic-packages komen uit uw Dartastic Pub, niet uit pub.dev, en dart pub heeft een token nodig om eruit te lezen. De meeste ontwikkelaars hebben dit nog nooit gedaan; het kost een minuut, één keer per computer.

Dartastic Pub werkt ook als doorgeefluik naar pub.dev. Geef uw packages zoals altijd op in pubspec.yaml: die van pub.dev worden automatisch uit pub.dev opgehaald, naast de Dartastic-packages en uw privépackages.

  1. Ga in de Control Room naar het scherm Tokens:
    Het scherm “Tokens” van de Control Room: “Generate Token”, met “+ Pub”, “+ Symbolizer”, “+ OTLP” en “+ Browser OTLP”
  2. Maak een Pub-token aan: druk op + Pub. Het venster gaat open:
    Het venster “Generate Pub Token”: “Name”, wat het token toestaat, de organisatie en “Allow write (publish) access”
    • Name: een naam waarmee u uw tokens uit elkaar houdt; wij raden pub-org-read-write aan.
    • Organization: de organisatie waarvan dit token de packages leest en publiceert.
    • Allow write (publish) access: vink dit aan om met dit token naar uw Dartastic Pub te publiceren. Zonder dit vinkje kan het token alleen lezen, en dat is alles wat de Reference Demo nodig heeft, behalve symbolizer_demo_flutter en crash_demo_flutter, die naar uw Pub publiceren.
  3. Klik op Generate. Uw token wordt één keer getoond:
    Het nieuwe Pub-token: de “Token ID”, het geheime token met een kopieerknop, het commando dart pub token add, en “Granted scopes: Pub”
    Kopieer het token nu met de kopieerknop: zodra u dit venster sluit, kan het niet meer worden getoond. Granted scopes: Pub betekent dat dit token alleen voor Pub is: het kan geen telemetrie sturen en geen andere dienst aanroepen.
  4. Geef het token in een terminal door aan dart pub:
    shell
    dart pub token add https://pub.dartastic.io
    Verschijnt Enter secret token:, plak dan het token en druk op Enter. Tijdens het plakken ziet u niets; dat is normaal. Het antwoord is:
    terminal
    Enter secret token:
    Requests to "https://pub.dartastic.io" will now be authenticated using the secret token.
  5. Haal in de map van de Reference Demo de packages op:
    shell
    flutter pub get
    Lukt het, dan werken uw Pub en uw token.

dart pub bewaart het token voor die host en stuurt het alleen daarheen. De pagina Pub legt uit hoe u tokens bekijkt, vervangt en verwijdert, en hoe u publiceert.

Welke packages een Pub-token bereikt

Een Pub-token bereikt de packages die de eigenaar ervan mag gebruiken, en niet meer.

  • Beheerders van de organisatie hebben toegang tot elk package in de organisatie, en hun tokens dus ook.
  • Andere teamgenoten kunnen alleen tokens aanmaken voor de packages die ze hebben gekregen. Een beheerder kent packages toe aan een teamgenoot.

Zie Teamgenoten uitnodigen voor de rollen, en Pub voor het toekennen van packages aan leden van de organisatie.

4. Uw app telemetrie laten sturen

Maak op het scherm Tokens een OTLP-token aan en exporteer het in uw shell in de standaardvorm van OpenTelemetry. Schrijf authorization in kleine letters:

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

5. De demo draaien

Zorg dat Docker draait. Start dan de weerdemo vanuit de map van de Reference Demo en kies een apparaat:

shell
tool/launch.sh weather_flutter

Tik om het weer op te halen. Die tik start een trace die door de app, de weer-API, de cache ervan en de externe weerdienst loopt.

6. Bekijken in het Observatory

Uw tik bereikt het Observatory binnen enkele seconden. De app linkt naar wat hij stuurde: volg die link om de trace te openen en elke stap te zien, en hoe lang die duurde.

Volgende stappen