Van uw eerste keer inloggen tot antwoorden over uw app in productie.
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:
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.
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.
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.
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.
Maak een Pub-token aan: druk op + Pub. Het venster gaat open:
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.
Klik op Generate. Uw token wordt één keer getoond: 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.
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.
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:
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.
Wij gebruiken essentiële cookies om deze site te laten werken, en analytische cookies alleen met uw toestemming. Zie ons Cookiebeleid en Privacybeleid.