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

Premiers pas

D’un premier aperçu d’OpenTelemetry à votre propre trace dans l’Observatory. Chaque étape s’appuie sur la précédente : suivez-les dans l’ordre.

À propos d’OpenTelemetry

Commencer par OpenTelemetry

Dartastic repose sur OpenTelemetry (OTel), le standard ouvert pour enregistrer ce que fait un logiciel. Dartastic suit de près la spécification OpenTelemetry : les noms, les données et leur mode d’envoi sont ceux du standard. Ce que vous apprenez sur OpenTelemetry s’applique à Dartastic, et ce que vous construisez avec Dartastic reste de l’OpenTelemetry standard.

La spécification est accessible. Avant d’aller plus loin, consacrez une heure à la documentation OpenTelemetry pour en acquérir les bases :

Les trois signaux

OpenTelemetry enregistre trois types de données, appelés signaux :

Traces
Ce qui s’est passé, étape par étape, et la durée de chaque étape. Une trace est un arbre de spans : un tap, l’appel réseau qu’il a déclenché, le travail du serveur derrière cet appel, la requête en base de données en dessous. Une même trace peut passer de votre application à votre serveur.
Métriques
Des nombres mesurés dans le temps : durées des frames, mémoire, requêtes par minute, erreurs par version. Peu coûteuses à conserver, elles montrent les tendances et déclenchent les alertes.
Logs
Des lignes de texte avec une heure et une sévérité. Dans OpenTelemetry, un log porte la trace dans laquelle il a été écrit : depuis un log, vous pouvez ouvrir tout ce qui s’est passé au même moment.

Les trois portent une ressource : quelle application les a envoyés, quelle version, sur quel appareil. Dartastic y ajoute le monitoring des utilisateurs réels (sessions, écrans, taps et replay), lui aussi enregistré sous forme de signaux standard. La page Vue d’ensemble explique les autres termes de ces pages.

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. Se connecter

Connectez-vous à dartastic.io. La première fois, vous configurez votre organisation : le compte auquel appartiennent vos jetons, vos coéquipiers et votre offre. Si un coéquipier vous a invité, connectez-vous avec l’adresse e-mail invitée : vous rejoignez alors son organisation.

L’inscription démarre votre organisation sur Cloud Free, sans carte. On vous demande :

  • Nom de l’organisation et sous-domaine : son nom, et le sous-domaine auquel vos applications envoient la télémétrie. Le sous-domaine est à vous pour de bon.
  • Région : l’endroit où votre télémétrie est stockée. Il ne peut pas être modifié ensuite.
  • Limite RUM : le niveau de replay le plus élevé que votre moteur peut enregistrer. Cloud Free va jusqu’à Wireframe ; Shadow et Pixel sont dans les offres payantes. Votre moteur est forgé avec votre choix, et rien sur l’appareil ne peut aller au-delà.
  • Dartastic AI : fonctionne avec votre propre clé de modèle, que vous pouvez ajouter à ce moment-là ou plus tard.

Pour Dartastic Pub seul, choisissez une offre Pub sur la page Tarifs avant de vous inscrire. Vous nommez votre organisation et choisissez sa région, et rien de plus n’est demandé.

Vous arrivez dans le Control Room. L’écran Organization affiche le nom et l’identifiant de votre organisation.

2. Télécharger la Reference Demo

Appuyez sur Reference Demo en haut du Control Room, puis décompressez l’archive. Vous la lancez à l’étape 5 : c’est le moyen le plus rapide de voir Dartastic fonctionner, et son code montre comment utiliser chaque fonctionnalité. En savoir plus sur la Reference Demo.

3. Connecter dart pub à votre Dartastic Pub

Les packages Dartastic proviennent de votre Dartastic Pub, pas de pub.dev, et dart pub a besoin d’un jeton pour y lire. La plupart des développeurs ne l’ont jamais fait ; cela prend une minute, une fois par ordinateur.

Dartastic Pub sert aussi de relais vers pub.dev. Déclarez vos packages dans pubspec.yaml comme d’habitude : ceux de pub.dev sont résolus automatiquement depuis pub.dev, à côté des packages Dartastic et de vos packages privés.

  1. Dans le Control Room, allez dans Tokens :
    L’écran « Tokens » du Control Room : « Generate Token », avec « + Pub », « + Symbolizer », « + OTLP » et « + Browser OTLP »
  2. Générez un jeton Pub : appuyez sur + Pub. La fenêtre de dialogue s’ouvre :
    La fenêtre « Generate Pub Token » : « Name », ce que le jeton accorde, l’organisation, et « Allow write (publish) access »
    • Name : un nom qui distingue vos jetons ; nous recommandons pub-org-read-write.
    • Organization : l’organisation dont ce jeton lit et publie les packages.
    • Allow write (publish) access : cochez cette case pour publier sur votre Dartastic Pub avec ce jeton. Sans elle, le jeton ne peut que lire, ce qui suffit à toute la Reference Demo sauf symbolizer_demo_flutter et crash_demo_flutter, qui publient sur votre Pub.
  3. Cliquez sur Generate. Votre jeton n’est affiché qu’une fois :
    Le nouveau jeton Pub : son « Token ID », le jeton secret avec un bouton de copie, la commande dart pub token add, et « Granted scopes: Pub »
    Copiez le jeton avec son bouton de copie dès maintenant : une fois cette fenêtre fermée, il ne peut plus être affiché. Granted scopes: Pub signifie que ce jeton sert uniquement à Pub : il ne peut ni envoyer de télémétrie ni appeler un autre service.
  4. Dans un terminal, donnez le jeton à dart pub :
    shell
    dart pub token add https://pub.dartastic.io
    Quand il affiche Enter secret token:, collez le jeton et appuyez sur Entrée. Rien ne s’affiche pendant le collage ; c’est normal. Il répond :
    terminal
    Enter secret token:
    Requests to "https://pub.dartastic.io" will now be authenticated using the secret token.
  5. Dans le dossier de la Reference Demo, récupérez ses packages :
    shell
    flutter pub get
    Si la commande réussit, votre Pub et votre jeton fonctionnent.

dart pub conserve le jeton pour cet hôte et ne l’envoie qu’à lui. La page Pub explique comment lister, remplacer et supprimer des jetons, et comment publier.

Les packages accessibles avec un jeton Pub

Un jeton Pub donne accès aux packages que son propriétaire peut utiliser, et à rien de plus.

  • Les administrateurs de l’organisation ont accès à tous les packages de l’organisation, et leurs jetons aussi.
  • Les autres coéquipiers ne peuvent générer de jetons que pour les packages qui leur ont été attribués. Un administrateur attribue des packages à un coéquipier.

Consultez Inviter des coéquipiers pour les rôles, et Pub pour attribuer des packages aux membres de l’organisation.

4. Permettre à votre application d’envoyer de la télémétrie

Dans Tokens, générez un jeton OTLP, puis exportez-le dans votre shell sous la forme standard d’OpenTelemetry. Gardez authorization en minuscules :

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

5. Lancer la démo

Avec Docker en marche, lancez la démo météo depuis le dossier de la Reference Demo et choisissez un appareil :

shell
tool/launch.sh weather_flutter

Appuyez pour récupérer la météo. Ce tap démarre une trace qui traverse l’application, l’API météo, son cache et le service météo externe.

6. La voir dans l’Observatory

Votre tap arrive dans l’Observatory en quelques secondes. L’application affiche un lien vers ce qu’elle a envoyé : suivez-le pour ouvrir la trace et voir chaque étape et sa durée.

Ensuite