dmtracedump
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
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 suiviinc-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
Le contenu et les exemples de code de cette page sont soumis aux licences décrites dans la Licence de contenu. Java et OpenJDK sont des marques ou des marques déposées d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/07/27 (UTC).
[null,null,["Dernière mise à jour le 2025/07/27 (UTC)."],[],[],null,["# dmtracedump\n\n`dmtracedump` is a tool that generates\ngraphical call-stack diagrams from trace log files. The tool uses the Graphviz\nDot utility to create the graphical output, so you need to install Graphviz\nbefore running `dmtracedump`. If you haven't yet generated trace logs and\nsaved them from your connected device to your local machine, go to\n[Generate trace logs by instrumenting your app](/studio/profile/generate-trace-logs).\n\nThe `dmtracedump` tool generates the call stack data as a tree diagram, where each\nnode represents a method call. It shows call flow (from parent node to child nodes)\nusing arrows. The diagram below shows a sample output of `dmtracedump`.\n\nThe `dmtracedump` tool is provided in the Android SDK Tools package and is\nlocated in \u003cvar translate=\"no\"\u003eandroid-sdk\u003c/var\u003e`/platform-tools/`.\n\nSyntax\n------\n\nThe usage for dmtracedump is: \n\n```\ndmtracedump [-ho] [-s sortable] [-d trace-base-name] [-g outfile] trace-base-name\n```\n\nThe tool then loads trace log data from \u003cvar translate=\"no\"\u003etrace-base-name\u003c/var\u003e`.data` and\n\u003cvar translate=\"no\"\u003etrace-base-name\u003c/var\u003e`.key`.\n\n### Global options\n\n| Global options | Description |\n|----------------|------------------------------------------|\n| `-h` | Turn on HTML output |\n| `-o` | Dump the trace file instead of profiling |\n\n### Commands and command options\n\n| Commands and options | Description |\n|------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `-d `\u003cvar translate=\"no\"\u003etrace-base-name\u003c/var\u003e | Diff with this trace name |\n| `-g `\u003cvar translate=\"no\"\u003eoutfile\u003c/var\u003e | Generate output to \u003cvar translate=\"no\"\u003eoutfile\u003c/var\u003e |\n| `-s `\u003cvar translate=\"no\"\u003esortable\u003c/var\u003e | URL base to the location of the sortable javascript file |\n| `-t `\u003cvar translate=\"no\"\u003epercent\u003c/var\u003e | Minimum threshold for including child nodes in the graph (child's inclusive time as a percentage of parent inclusive time). If this option is not used, the default threshold is 20%. |\n\nOutput\n------\n\n\n**Figure 1.** Screenshot of dmtracedump\n\n\u003cbr /\u003e\n\nFor each node in the graph, `dmtracedump` shows the following\ninformation: \n\n```\nref callname (inc-ms, exc-ms,numcalls)\n```\n\n- \u003cvar translate=\"no\"\u003eref\u003c/var\u003e --- Call reference number, as used in trace logs\n- \u003cvar translate=\"no\"\u003einc-ms\u003c/var\u003e --- Inclusive elapsed time (milliseconds spent in method, including all child methods)\n- \u003cvar translate=\"no\"\u003eexc-ms\u003c/var\u003e --- Exclusive elapsed time (milliseconds spent in method, not including any child methods)\n- \u003cvar translate=\"no\"\u003enumcalls\u003c/var\u003e --- Number of calls"]]
