Visualizar perfis na interface do Perfetto

Depois de recuperar um perfil de um dispositivo de teste ou fazer o download dele do seu back-end, você pode abrir o arquivo na interface do Perfetto para inspecionar linhas do tempo, estados de linhas de execução e gráficos de retenção de memória. Nesta página, descrevemos como navegar por rastreamentos do sistema e heap dumps do Java encobertos capturados com o ProfilingManager.

Visualizar rastreamentos do sistema

Abra o arquivo .perfetto-trace na interface do Perfetto para inspecionar a atividade da CPU e da linha de execução ao longo do tempo.

Linha do tempo de um rastreamento do sistema editado na interface do Perfetto
Figura 1. Exemplo de trace editado.

Para proteger a privacidade do usuário, o ProfilingManager oculta os rastreamentos do sistema combinando a atividade da CPU de todos os outros processos em uma única faixa OtherProcesses. A inspeção dessa faixa combinada ainda permite determinar se a lentidão no app foi causada por um gargalo interno ou pela carga geral do dispositivo.

A Figura 2 destaca as principais seções de um rastreamento do sistema editado:

Seções numeradas de um rastreamento do sistema editado na interface do Perfetto
Figura 2. Seções de um rastro editado.
  1. Lista de CPUs: mostra todos os processadores disponíveis no dispositivo.
  2. Tarefas da CPU: mostra quais linhas de execução cada CPU estava executando.
  3. Visualização de outros processos: mostra os recursos de CPU consumidos por outros processos.
  4. Visualização de processos: mostra o processo do app.
  5. Visualização de linhas de execução: mostra as linhas de execução em execução no processo e os estados delas (Executável (R), Em execução (R), Em suspensão (S), Em suspensão ininterrupta (D)), que são mapeados diretamente para os estados do processo do Linux.
  6. Frações de trace: essa seção mostra as anotações de trace adicionadas por desenvolvedores de apps ou pelo framework. Essas anotações abrangem cálculos entre Trace.beginSection e Trace.endSection.

Para mais informações sobre a interface do Perfetto e a visualização de rastros, consulte a documentação do Perfetto (em inglês).

Visualizar heap dumps do Java

Depois de capturar um heap dump do Java usando PROFILING_TYPE_JAVA_HEAP_DUMP, abra o arquivo .perfetto-java-heap-dump resultante na interface do Perfetto para identificar vazamentos de memória ou otimizar o uso da memória. No Heapdump Explorer, é possível analisar o gráfico de heap, inspecionar gráficos de chama de tamanhos de objetos cumulativos e navegar por classes, objetos e dominadores, como mostrado na Figura 3.

O Heapdump Explorer da interface do Perfetto mostrando um gráfico de chama dos tamanhos de objetos de heap do Java.
Figura 3. Gráfico de chama do heap dump do Java na interface do Perfetto.

Como os heap dumps do ProfilingManager são diferentes dos dumps HPROF

Ao contrário dos heap dumps padrão do .hprof (como os capturados com Debug.dumpHprofData ou no Android Studio), o ProfilingManager captura um heap dump do ART do Perfetto (.perfetto-java-heap-dump). Em vez de despejar o conteúdo bruto da memória, o ProfilingManager registra o gráfico de retenção de objetos e os metadados de dimensionamento, omitindo os dados brutos armazenados dentro dos objetos:

  • O que é coletado:
    • Classes e tipos: nomes de classes, hierarquias de superclasses, carregadores de classes, tamanhos de instâncias e tipos de referência (como classes normais, matrizes, strings ou referências fracas, suaves, finalizadoras e fantasmas).
    • Instâncias e tamanhos de objetos: o tamanho superficial de cada objeto (self_size), a região de heap (HEAP_TYPE_APP, HEAP_TYPE_ZYGOTE ou HEAP_TYPE_BOOT_IMAGE) e a memória nativa associada registrada por meio de NativeAllocationRegistry.
    • Referências e raízes de GC: raízes de coleta de lixo (como globais e locais de JNI, frames de pilha Java e objetos de linha de execução) e cadeias de referência no nível do campo que mostram qual objeto retém outro e por qual nome de campo.
    • Selecionar metadados de dimensionamento: metadados não sensíveis para tipos de framework específicos, como dimensões de Bitmap (mWidth e mHeight).
  • O que é omitido: valores reais de campos primitivos, conteúdo de caracteres String e payloads de matriz brutos (byte[], char[] e outras matrizes primitivas). Omitir o conteúdo bruto de objetos protege a privacidade do usuário em dispositivos de produção e mantém os arquivos dump significativamente menores.

Próximas etapas

Além da inspeção visual na interface do Perfetto, é possível consultar perfis com o PerfettoSQL, analisar traces em massa ou analisar perfis com IA.