dmtracedump

dmtracedump est un outil qui génère des diagrammes graphiques de piles d'appel à partir des fichiers journaux de trace. L'outil utilise l'utilitaire Graphviz Dot pour créer les graphiques. Vous devez donc installer Graphviz avant d'exécuter dmtracedump. Si vous n'avez pas encore généré de journaux de trace et que vous les avez enregistrés sur votre appareil local depuis votre appareil connecté, accédez à la page Générer des journaux de trace en instrumentant votre application.

L'outil dmtracedump génère les données de la pile d'appel sous forme d'arborescence, où chaque nœud représente un appel de méthode. Il montre le flux d'appel (du nœud parent aux nœuds enfants) à l'aide de flèches. Le schéma ci-dessous présente un exemple de sortie de dmtracedump.

L'outil dmtracedump est fourni dans le package SDK Tools pour Android et se trouve dans android-sdk/platform-tools/.

Syntaxe

L'utilisation de dmtracedump est la suivante :

dmtracedump [-ho] [-s sortable] [-d trace-base-name] [-g outfile] trace-base-name

L'outil charge ensuite les données de journal de trace à partir de trace-base-name.data et de trace-base-name.key.

Options globales

Options générales Description
-h Activer la sortie HTML
-o Vider le fichier de suivi au lieu de profiler

Commandes et options de commande

Commandes et options Description
-d trace-base-name Différences avec ce nom de trace
-g outfile Générer le résultat dans outfile
-s sortable URL de base vers l'emplacement du fichier JavaScript triable
-t percent Seuil minimal d'inclusion des nœuds enfants dans le graphique (temps inclusif pour les nœuds enfants, sous la forme d'un pourcentage du temps du nœud parent). Si vous n'utilisez pas cette option, le seuil par défaut est de 20 %.

Sortie

Figure 1 : Capture d'écran de dmtracedump

Pour chaque nœud du graphique, dmtracedump affiche les informations suivantes :

ref callname (inc-ms, exc-ms,numcalls)
  • ref : numéro de référence d'appel, tel qu'il est utilisé dans les journaux de suivi
  • inc-ms : temps inclusif écoulé (millisecondes passées dans la méthode, y compris toutes les méthodes enfants)
  • exc-ms : temps exclusif écoulé (millisecondes passées dans la méthode, à l'exclusion des méthodes enfants)
  • numcalls : nombre d'appels