Aller au contenu

Tracer avec quoin-devtools

Guide pratique1 min de lecture
Modifier cette page

Vous instrumenterez une application en cours d’exécution pour voir ce que fait son cœur réactif : créations de signaux, mutations déclenchant une lecture, demandes de mise à jour, et lancements, complétions et abandons de tâches. quoin-devtools enveloppe le contexte de n’importe quel adaptateur — GPUI, Leptos, Dioxus, Xilem, Floem, ou le contexte testkit.

Prérequis : la fonctionnalité devtools (ou une dépendance directe sur quoin-devtools).

Instrumented::wrap est une enveloppe transparente : continuez d’utiliser le contexte enveloppé partout où vous utilisiez le brut.

use quoin_devtools::Instrumented;
let raw_ctx = /* n'importe quel contexte d'adaptateur */;
let ctx = Instrumented::wrap(raw_ctx, "app");

L’enregistrement est conditionné pour que le câblage n’ait aucun coût en livraison quand il est désactivé — avec le traçage éteint, chaque appel est un simple chargement atomique relâché et rien n’est alloué.

Terminal
QUOIN_TRACE=1 ./myapp # ou QUOIN_TRACE=on

Alternativement, activez-le par programme : quoin_devtools::enable() (et disable() / enabled() pour inspecter l’état).

L’EventLog global est un tampon circulaire (capacité par défaut 4096 événements) avec trois vues agrégées :

quoin_devtools::global_log().dump(); // tableau sur stderr
quoin_devtools::global_log().hot_signals(); // comptes de mutations classés
quoin_devtools::global_log().events(); // instantané brut des valeurs Event

Appelez-les depuis un raccourci de débogage, un panneau déroulant, ou à la sortie. Chaque événement porte un EventKind (mises à jour, lancements, mutations, …) et l’étiquette que vous avez passée à Instrumented::wrap.

L’exemple counter-xilem rend les comptes de trace à côté du compteur et vide la session à la fermeture de la fenêtre :

Terminal
cargo run --manifest-path examples/counter-xilem/Cargo.toml

Pour une visite sans tête de la session de traçage elle-même, exécutez just trace-demo (cela pilote devtools-demo avec QUOIN_TRACE=1).

La fonctionnalité optionnelle tracing transfère les événements dans l’écosystème tracing au lieu de (ou en plus de) le journal intégré.