Ces pages affichent les URL de Cloud. Connectez-vous sur Dedicated et elles affichent celles de votre serveur.

Dartastic OTel Reference Demo

Des applications Flutter fonctionnelles qui montrent chaque fonctionnalité de Dartastic, avec la configuration déjà faite. Lancez-les pour voir Dartastic fonctionner de bout en bout, puis lisez leur code et reprenez-en des extraits.

C’est la version commerciale enrichie de la Dart OTel Reference Demo open source, avec bien plus de démos. Chaque application résout ses packages depuis votre Dartastic Pub et envoie sa télémétrie à votre Observatory : quand la démo fonctionne, votre compte est validé.

BUILDARCHITECTURE DARTASTICUTILISATEURSjetonsticketsjeton Pubpushéchange CIles applis sont livrées aux utilisateurs : stores d’applications, web, serveurssymbolescrashspiles d’appelscode sourcetélémétriePoste développeurflutter run · dart pub getCIGitHub Actions, GitLab, …Control Roomcréation de jetons · contrôle d’accès par rôlePlan de contrôleorganisations · rôles · jetonsDartastic Pubpackages · code sourceObservatorysessions · traces · logsSymbolizercrashs → lignes de codeDartastic AIrépond à partir des deuxSuivi des ticketsGitHub · Jira · LinearApplis mobiles + bureautéléphones · tablettes · ordinateursenvoie avec un jeton OTLPApplis webdans les navigateursenvoie avec un jeton Browser OTLPServeurs Dartbackends · servicesenvoie avec un jeton OTLP

La télécharger

Connectez-vous au Control Room et appuyez sur Reference Demo en haut de chaque écran, à côté de « Help » :

L’en-tête du Control Room avec le bouton « Reference Demo », à côté de « Help » et « Sign Out »

Le bouton télécharge dartastic-otel-reference-demo-<version>.tar.gz. Décompressez l’archive là où vous rangez votre code :

shell
tar -xzf dartastic-otel-reference-demo-*.tar.gz
cd dartastic-otel-reference-demo-*

Le README.md à sa racine est le guide complet. Les étapes ci-dessous vous mènent à votre premier lancement.

Sur Dedicated : la pointer vers votre serveur

La démo pointe au départ vers Dartastic Cloud : sur Cloud, il n’y a donc rien à faire ici. Sur Dedicated, lancez ceci une fois avec votre sous-domaine :

shell
tool/set-hosted-slug.sh <subdomain>

Elle écrit votre sous-domaine dans .env (ignoré par git) et met à jour les pubspecs. Relancez-la avec un autre sous-domaine pour changer, ou avec "" pour revenir à Cloud.

Les jetons nécessaires

Générez chacun d’eux sur l’écran Tokens du Control Room. Chaque jeton n’est affiché qu’une fois : copiez-le au moment où vous le générez.

JetonNécessaire pour
Jeton Pub
dart pub token add (une fois)
Toutes les démos : flutter pub get résout les packages depuis votre Dartastic Pub.
Jeton OTLP
OTEL_EXPORTER_OTLP_HEADERS
Toutes les démos : les applications envoient leur télémétrie à votre Observatory.
Jeton Symbolizer
DARTASTIC_SYMBOLIZER_TOKEN
symbolizer_demo_flutter uniquement.

Un jeton Pub en lecture seule suffit pour toutes les démos sauf symbolizer_demo_flutter et crash_demo_flutter, qui publient sur votre Pub et demandent un jeton en lecture et écriture. La page Premiers pas explique comment ajouter le jeton Pub et exporter les autres.

Exportez les jetons dans votre shell plutôt que de les écrire dans .env : un .env partagé ou versionné est une cause fréquente de fuite de secrets.

Lancer une démo

La démo forme un seul workspace Flutter. Récupérez les packages de toutes les applications en une fois depuis son dossier racine :

shell
flutter pub get

Si la commande réussit, votre Dartastic Pub et votre jeton Pub fonctionnent. Lancez ensuite une application ; tool/launch.sh vous demande sur quel appareil l’exécuter :

shell
tool/launch.sh --list          # every demo app
tool/launch.sh                 # weather_flutter
tool/launch.sh rum_demo_flutter
  • Docker n’est nécessaire que pour weather_flutter et all_demos_flutter : elles démarrent l’API météo sur votre machine pour montrer une seule trace entre application et serveur.
  • Les démos s’exécutent sur Android, iOS, macOS, Windows et Linux, sur appareils et simulateurs. Elles ne s’exécutent pas sur le web.

Ce qu’elle contient

ApplicationCe qu’elle montre
weather_flutterUn tap tracé de bout en bout : l’application, une API météo, son cache et le service météo externe, dans une seule trace.
all_demos_flutterPresque toutes les démos, chacune dans un onglet d’une même application.
rum_demo_flutterSessions, vues d’écran, taps et signaux de frustration, avec replay de session.
crash_demo_flutterDes crashs enregistrés et transmis même quand l’application s’arrête brutalement.
symbolizer_demo_flutterUn build release obfusqué dont les piles d’appels reviennent sous forme de vos fichiers et de vos lignes, et le jank rattaché au widget responsable.
anr_demo_flutterDétection des ANR (App Not Responding).
pii_demo_flutterGarder les données personnelles hors de votre télémétrie.
webview_demo_flutterLa télémétrie d’une page web intégrée à votre application, rattachée à la trace de l’application.
Métriques vitales des plateformesSanté des versions, Android Vitals, iOS MetricKit, démarrage de l’application, état de l’appareil, état thermique, instabilité du réseau, expérience utilisateur et métriques vitales des serveurs Linux, une application pour chacun.

Chaque application renvoie vers ce qu’elle a envoyé dans votre Observatory. Pour découvrir une fonctionnalité, lancez son application, puis lisez son code : c’est le plus petit exemple fonctionnel de cette fonctionnalité. Donnez-le aussi à votre assistant de code IA.

Ce que vous voyez dans l’Observatory

Des écrans issus d’un même lancement des démos. Votre propre lancement donne ses propres chiffres ; ce que montre chaque écran reste le même.

Temps de construction des frames

all_demos_flutter sur l’écran « Metric » pour flutter.frame.build, en carte de chaleur : quatre minutes de frames, avec la ligne p95 qui monte au fil du lancement.
all_demos_flutter sur l’écran « Metric » pour flutter.frame.build, en carte de chaleur : quatre minutes de frames, avec la ligne p95 qui monte au fil du lancement.

Santé des versions

Les traces filtrées sur les spans flutter.session de la démo de santé des versions, un par session. Celui en rouge correspond à la session qui a crashé.
Les traces filtrées sur les spans flutter.session de la démo de santé des versions, un par session. Celui en rouge correspond à la session qui a crashé.

Démarrage de l’application

L’écran « Metric » pour flutter.app.startup.duration, en carte de chaleur : trois démarrages à froid d’environ 2,2 s et deux démarrages à chaud de 33 et 63 ms.
L’écran « Metric » pour flutter.app.startup.duration, en carte de chaleur : trois démarrages à froid d’environ 2,2 s et deux démarrages à chaud de 33 et 63 ms.

Instabilité du réseau

Les traces filtrées sur dartastic.network.flaky = true : deux requêtes instables, l’une de 6,56 s et l’autre de 114 ms terminée en erreur.
Les traces filtrées sur dartastic.network.flaky = true : deux requêtes instables, l’une de 6,56 s et l’autre de 114 ms terminée en erreur.

Interaction to Next Paint

L’écran « Metric » pour flutter.experience.inp, en carte de chaleur : huit interactions, deux sous 16 ms et six entre 200 et 250 ms.
L’écran « Metric » pour flutter.experience.inp, en carte de chaleur : huit interactions, deux sous 16 ms et six entre 200 et 250 ms.

First Contentful Paint

L’écran « Metric » pour flutter.experience.fcp : un seul First Contentful Paint, à 2,67 s.
L’écran « Metric » pour flutter.experience.fcp : un seul First Contentful Paint, à 2,67 s.

App Not Responding, sous forme d’événements

Les logs filtrés sur les événements dartastic.app.anr de anr_demo_flutter : trois ANR, comptés sous « Unspecified » car un événement n’a pas de sévérité, chaque ligne affichant son nom d’événement.
Les logs filtrés sur les événements dartastic.app.anr de anr_demo_flutter : trois ANR, comptés sous « Unspecified » car un événement n’a pas de sévérité, chaque ligne affichant son nom d’événement.

App Not Responding, durée

Les trois mêmes ANR sur l’écran « Metric » pour flutter.anr.duration : de 6,0 à 6,6 s chacun, au moment de leur export.
Les trois mêmes ANR sur l’écran « Metric » pour flutter.anr.duration : de 6,0 à 6,6 s chacun, au moment de leur export.

Sorties d’application iOS MetricKit

L’écran « Metric » pour dartastic.app.exit.count, en barres : 50 sorties sur un pas de cinq minutes, dont 43 normales, 3 par manque de mémoire, 3 par le watchdog et 1 par timeout.
L’écran « Metric » pour dartastic.app.exit.count, en barres : 50 sorties sur un pas de cinq minutes, dont 43 normales, 3 par manque de mémoire, 3 par le watchdog et 1 par timeout.