dmtracedump

O dmtracedump é uma ferramenta que gera diagramas gráficos de pilha de chamadas a partir de arquivos de registros de rastreamento. Como a ferramenta usa o utilitário Graphviz Dot para criar a saída gráfica, é necessário instalar o Graphviz antes de executar o dmtracedump. Se você ainda não gerou registros de rastreamento e os transferiu do seu dispositivo conectado para a máquina local, acesse Gerar registros de rastreamento com a instrumentação do app.

A ferramenta dmtracedump gera os dados da pilha de chamadas como um diagrama de árvore, em que cada nó representa uma chamada de método. Ele mostra o fluxo de chamadas (do nó pai para os nós filhos) usando setas. O diagrama abaixo mostra um exemplo de saída de dmtracedump.

O comando dmtracedump é fornecido no pacote Ferramentas do SDK do Android e está localizado em android-sdk/platform-tools/.

Sintaxe

O uso para o dmtracedump é:

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

Em seguida, a ferramenta carrega dados de registro de rastreamento de trace-base-name.data e trace-base-name.key.

Opções globais

Opções globais Descrição
-h Ativa a saída HTML
-o Descarrega o arquivo de rastreamento, em vez de criar um perfil

Comandos e opções de comando

Comandos e opções Descrição
-d trace-base-name Comparação com este nome de rastreamento
-g outfile Gerar saída para outfile
-s sortable URL base para a localização do arquivo javascript classificável
-t percent Limite mínimo para inclusão de nós filhos no gráfico (tempo inclusivo do filho como porcentagem do tempo inclusivo do pai). Se esta opção não for usada, o limite padrão será de 20%.

Saída

Figura 1. Captura de tela do dmtracedump

Para cada nó do gráfico, o dmtracedump mostra as seguintes informações:

ref callname (inc-ms, exc-ms,numcalls)
  • ref: número de referência da chamada, como usado em registros de rastreamento
  • inc-ms: tempo inclusivo decorrido (milissegundos gastos no método, incluindo todos os métodos filhos)
  • exc-ms: tempo exclusivo decorrido (milissegundos gastos no método, sem incluir os métodos filhos)
  • numcalls: número de chamadas