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

Vue d’ensemble

Dartastic vous montre ce que font réellement vos applications Dart et Flutter entre les mains de vos utilisateurs, et vous aide à corriger ce qui ne va pas. Cette page est la carte. Lisez-la une fois, puis suivez le guide Premiers pas étape par étape.

La plateforme

Chaque page d’aide montre ce même schéma, avec les parties qu’elle couvre mises en évidence : vous savez toujours où vous êtes.

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
  1. Vous développez sur votre ordinateur et dans votre CI. Votre application obtient les packages Dartastic depuis Dartastic Pub, comme elle obtient ceux de pub.dev.
  2. Votre application s’exécute sur des téléphones et des ordinateurs, dans des navigateurs et en tant que serveurs Dart. Les packages Dartastic OTel qu’elle contient enregistrent ce qui se passe et l’envoient à l’Observatory.
  3. Quand quelque chose casse, le Symbolizer ramène le crash à votre fichier et à votre ligne, grâce aux symboles que vous avez publiés sur Pub avec votre application.
  4. Quand vous voulez savoir pourquoi, vous interrogez Dartastic AI. Elle lit la télémétrie et votre code source sur Pub, puis répond avec la cause et un correctif.
  5. Le Control Room est l’endroit où vous configurez tout cela : il génère les jetons qui ouvrent chaque flèche du schéma.

Les éléments

ÉlémentRôleOù le trouver
Control RoomVotre compte. Vous y générez des jetons, invitez des coéquipiers, choisissez votre offre et téléchargez la Reference Demo.dartastic.io/control-room, une fois connecté
Dartastic PubUn registre de packages privé qui fonctionne comme pub.dev. Vous y récupérez les packages Dartastic, y conservez vos propres packages privés et y publiez le code source de votre application.dart pub get, dart pub publish
Dartastic OTelLes packages que vous ajoutez à votre application. Ils enregistrent ce qui s’y passe (écrans, taps, appels réseau, erreurs, crashs, performances) au format OpenTelemetry et l’envoient.Votre pubspec.yaml et votre main()
ObservatoryL’endroit où vous regardez. Sessions avec replay, traces, logs, métriques, crashs, tableaux de bord et alertes pour tout ce que vos applications envoient.S’ouvre depuis le Control Room
SymbolizerRetransforme les piles d’appels illisibles d’un build release obfusqué en noms de fichiers et numéros de ligne. Il s’exécute de lui-même à l’arrivée des crashs.Rien à appeler : il lit les symboles que vous publiez sur Pub
Dartastic AIRépond en langage courant à vos questions sur votre application. Elle lit votre télémétrie et votre code source sur Pub, trouve la cause et propose le correctif.Le bouton « Ask » dans l’Observatory et le Control Room

Ce que vous voyez

Voici l’Observatory. Chaque session de vos utilisateurs y figure avec ses écrans, ses taps, ses erreurs et ses signaux de frustration :

La liste « Sessions » de l’Observatory, une ligne par session utilisateur

Ouvrez-en une et rejouez-la. Sous la tête de lecture, vous voyez la trace, les logs et l’erreur de cet instant, et vous pouvez aller directement à la ligne de code :

Un replay de session avec sa chronologie, la trace sous la tête de lecture et ses logs

Les jetons relient les éléments

Chaque flèche du schéma demande son propre type de jeton. Vous les générez dans le Control Room, et chacun ne vous est montré qu’une seule fois : copiez-le au moment où vous le générez. La plupart des développeurs n’ont jamais utilisé de jeton avec dart pub ; la page Pub vous guide pas à pas.

JetonDeVersPermet
Jeton PubVotre ordinateurDartastic Pubdart pub get peut télécharger les packages Dartastic et vos packages privés ; dart pub publish peut publier.
Échange CIVotre CIDartastic PubVotre CI lit et publie des packages sans qu’aucun jeton n’y soit stocké.
Jeton OTLPVotre application sur un téléphone ou un ordinateur, votre serveur DartObservatoryVotre application peut envoyer de la télémétrie.
Jeton Browser OTLPVotre application Flutter webObservatoryVotre application web peut envoyer de la télémétrie, uniquement depuis les sites web que vous indiquez.

Tous vos jetons sont listés sur un seul écran. La page Tokens explique chaque type, et comment révoquer ou remplacer un jeton.

Où tout s’exécute : votre offre

  • Cloud s’exécute sur une infrastructure que Dartastic mutualise entre ses clients. Votre Pub est pub.dartastic.io.
  • Dedicated donne à votre organisation son propre serveur, sur un sous-domaine de votre choix : votre Pub est pub.<subdomain>.dartastic.io.
  • Self-Hosted exécute toute la plateforme dans votre propre réseau.

Les étapes sont les mêmes pour toutes les offres. Quand une URL diffère, ces pages montrent les deux. Comparer les offres.

Ce qu’il vous faut

  • Flutter 3.44 et Dart 3.12 ou plus récent pour toutes les fonctionnalités ; Flutter 3.22 et Dart 3.4 pour toutes sauf les métriques Flutter. Les versions requises par chaque package.
  • Un compte Dartastic : l’inscription est gratuite. L’inscription démarre votre organisation sur Cloud Free, sans carte.
  • Pour le backend météo de la Reference Demo uniquement : Docker.

Comment apprendre

Choisissez la méthode qui vous convient : elles couvrent le même contenu.

  • Lisez ces pages dans l’ordre. Les liens Précédent et Suivant en bas de chaque page vous guident.
  • Lancez la Dartastic OTel Reference Demo. C’est la version commerciale enrichie de la Dart OTel Reference Demo open source : bien plus de démos, des applications Flutter fonctionnelles qui montrent comment utiliser chaque fonctionnalité de Dartastic, avec la configuration déjà faite. Lisez son code, reprenez-en des extraits ou donnez-la à votre assistant de code IA. Obtenir la Reference Demo.
  • Demandez : le support répond à vos questions.

Les termes de ces pages

OpenTelemetry (OTel)
Le standard ouvert pour enregistrer ce que fait un logiciel. Dartastic le parle de bout en bout : rien de ce que vous écrivez n’est lié à Dartastic.
OTLP
Le format de transmission d’OpenTelemetry : la façon dont votre application envoie ce qu’elle a enregistré.
Trace et span
Un span est une unité de travail chronométrée (un tap, un appel réseau, une requête en base de données). Une trace est l’arbre des spans d’une opération, y compris d’un bout à l’autre entre votre application et votre serveur.
Log
Une ligne de texte écrite par votre application, liée à la trace dans laquelle elle s’est produite.
Métrique
Un nombre mesuré dans le temps : durées des frames, mémoire, nombre de requêtes.
Session
La visite d’une personne dans votre application, du lancement à la sortie, avec chaque écran, tap, erreur et trace qu’elle contient.
Replay
Revoir une session. Vous choisissez ce qui est capturé : une chronologie d’événements, un wireframe ou les vrais pixels.
RUM
Real User Monitoring (monitoring des utilisateurs réels) : la télémétrie des personnes qui utilisent vraiment votre application, par opposition aux tests.
Obfuscation et symboles
Un build release peut brouiller ses noms (flutter build --obfuscate). Le fichier de symboles qu’il écrit (--split-debug-info) est la clé pour les retrouver.
Jeton
Une longue chaîne secrète qui permet à un élément de communiquer avec un autre. Chaque type ouvre un chemin du schéma ci-dessus.