Dal primo accesso alle risposte sulla sua app in produzione.
Queste pagine mostrano gli URL di Cloud. Acceda su Dedicated e vedrà quelli del suo server.
Primi passi
Da un primo sguardo a OpenTelemetry alla sua prima traccia nell’Observatory. Ogni passaggio si basa sul precedente, quindi li segua in ordine.
Informazioni su OpenTelemetry
Iniziare da OpenTelemetry
Dartastic si basa su OpenTelemetry (OTel), lo standard aperto per registrare ciò che fa il software. Dartastic segue da vicino la specifica OpenTelemetry: i nomi, i dati e il modo in cui vengono inviati sono quelli standard. Ciò che impara su OpenTelemetry vale per Dartastic, e ciò che costruisce con Dartastic resta OpenTelemetry standard.
La specifica è accessibile. Prima di andare avanti, dedichi un’ora alla documentazione di OpenTelemetry per acquisirne le basi:
Cosa è successo, passo per passo, e quanto è durato ogni passo. Una traccia è un albero di span: un tap, la chiamata di rete che ha generato, il lavoro del server dietro quella chiamata, la query al database sottostante. Una traccia può passare dalla sua app al suo server.
Numeri misurati nel tempo: tempi dei frame, memoria, richieste al minuto, errori per release. Poco costose da conservare, mostrano le tendenze e fanno scattare gli avvisi.
Righe di testo con un orario e un livello di gravità. In OpenTelemetry un log porta con sé la traccia in cui è stato scritto, quindi da un log può aprire tutto il resto che è accaduto in quel momento.
Tutti e tre portano con sé una risorsa: quale app li ha inviati, quale versione, su quale dispositivo. Dartastic aggiunge il monitoraggio degli utenti reali (sessioni, schermate, tap e replay), registrato anch’esso come segnali standard. La Panoramica spiega gli altri termini usati in queste pagine.
1. Accedere
Accedere a dartastic.io. Al primo accesso, configura la sua organizzazione: l’account a cui appartengono i suoi token, i suoi colleghi e il suo piano. Se un collega l’ha invitata, acceda con l’indirizzo email a cui è arrivato l’invito ed entrerà invece nell’organizzazione del collega.
Con la registrazione, la sua organizzazione parte su Cloud Free, senza carta. Le viene chiesto:
Nome dell’organizzazione e sottodominio: il suo nome, e il sottodominio a cui le sue app inviano la telemetria. Il sottodominio è suo per sempre.
Regione: dove viene conservata la sua telemetria. Non può essere modificata in seguito.
Limite RUM: il livello di replay più alto che il suo motore può registrare. Cloud Free arriva fino a Wireframe; Shadow e Pixel sono nei piani a pagamento. Il suo motore viene forgiato con la sua scelta e nulla sul dispositivo può superarla.
Dartastic AI: funziona con la sua chiave per i modelli, che può aggiungere subito o in seguito.
Per il solo Dartastic Pub, scelga un piano Pub in Prezzi prima di registrarsi. Dà un nome alla sua organizzazione e ne sceglie la regione, e non viene chiesto altro.
Prema Reference Demo in cima alla Control Room e la decomprima. La eseguirà al passaggio 5: è il modo più rapido per vedere Dartastic in azione, e il suo codice mostra come usare ogni funzionalità. Maggiori informazioni sulla Reference Demo.
3. Collegare dart pub al suo Dartastic Pub
I pacchetti Dartastic arrivano dal suo Dartastic Pub, non da pub.dev, e dart pub ha bisogno di un token per leggerli. La maggior parte degli sviluppatori non l’ha mai fatto prima; richiede un minuto, una volta per computer.
Dartastic Pub fa anche da tramite verso pub.dev. Definisca i suoi pacchetti in pubspec.yaml come ha sempre fatto, e quelli di pub.dev vengono risolti automaticamente da pub.dev, insieme ai pacchetti Dartastic e a quelli privati.
Crei un token Pub: prema + Pub. Si apre la finestra:
Name: un nome qualsiasi che distingua i suoi token; consigliamo pub-org-read-write.
Organization: l’organizzazione di cui questo token legge e pubblica i pacchetti.
Allow write (publish) access: la selezioni per pubblicare sul suo Dartastic Pub con questo token. Senza, il token può solo leggere, che è tutto ciò che serve alla Reference Demo tranne symbolizer_demo_flutter e crash_demo_flutter, che pubblicano sul suo Pub.
Faccia clic su Generate. Il token viene mostrato una sola volta: Copi subito il token con il suo pulsante di copia: una volta chiusa questa finestra non può più essere mostrato. Granted scopes: Pub significa che questo token vale solo per Pub: non può inviare telemetria né chiamare altri servizi.
In una shell, passi il token a dart pub:
shell
dart pub token add https://pub.dartastic.io
Quando chiede Enter secret token:, incolli il token e prema Invio. Il prompt non mostra nulla mentre incolla; è normale. Risponde:
terminal
Enter secret token:
Requests to "https://pub.dartastic.io" will now be authenticated using the secret token.
Nella cartella della Reference Demo, scarichi i suoi pacchetti:
shell
flutter pub get
Se l’operazione riesce, il suo Pub e il suo token funzionano.
dart pub conserva il token per quell’host e lo invia solo lì. Pub spiega come elencare, sostituire e rimuovere i token, e come pubblicare.
Quali pacchetti raggiunge un token Pub
Un token Pub raggiunge i pacchetti che il suo titolare può usare, e nient’altro.
Gli amministratori dell’organizzazione hanno accesso a tutti i pacchetti dell’organizzazione, e così i loro token.
Gli altri colleghi possono creare token solo per i pacchetti che sono stati loro concessi. Un amministratore concede i pacchetti a un collega.
Veda Invitare colleghi per i ruoli, e Pub per concedere pacchetti ai membri dell’organizzazione.
4. Permettere all’app di inviare telemetria
In Tokens, crei un token OTLP, poi lo esporti nella sua shell nella forma standard di OpenTelemetry. Scriva authorization in minuscolo:
Con Docker in esecuzione, avvii la demo meteo dalla cartella della Reference Demo e scelga un dispositivo:
shell
tool/launch.sh weather_flutter
Tocchi per scaricare il meteo. Quel tap avvia una traccia che attraversa l’app, l’API meteo, la sua cache e il servizio meteo esterno.
6. Vederla nell’Observatory
Il suo tap raggiunge l’Observatory in pochi secondi. L’app contiene i link a ciò che ha inviato: segua il link per aprire la traccia e vedere ogni passaggio e quanto è durato.
Passi successivi
Creare la prima app: le versioni di Flutter e Dart richieste da ogni pacchetto.
Usiamo cookie essenziali per far funzionare questo sito e cookie analitici solo con il suo consenso. Consulti la nostra Cookie Policy e la nostra Informativa sulla privacy.