Esta página foi traduzida pela API Cloud Translation.

Visão geral do rastreamento do sistema

A gravação da atividade do dispositivo durante um curto período é conhecida como rastreamento do sistema. O rastreamento do sistema produz um arquivo que pode ser usado para gerar um relatório do sistema. Esse relatório ajuda a identificar a melhor forma de melhorar o desempenho do app ou jogo.

Para uma introdução abrangente a rastreamento e criação de perfil, consulte a página Noções básicas de rastreamento (em inglês) na documentação do Perfetto.

A plataforma Android oferece várias opções para a captura de rastros como:

O Memory Profiler e CPU Profiler do Android Studio
A ferramenta de linha de comando Perfetto (Android 10 e mais recentes)
O utilitário de rastreamento do sistema
A ferramenta de linha de comando Systrace

O CPU Profiler do Android Studio inspeciona o uso da CPU e a atividade das linhas de execução do app em tempo real durante sua interação com ele. Também é possível inspecionar os detalhes nos rastreamentos de métodos, funções e sistema gravados. Já o Memory Profiler oferece uma visão geral do uso da memória em relação a eventos de toque, mudanças de Activity e eventos de coleta de lixo.

O Perfetto é a ferramenta de rastreamento para toda a plataforma lançada no Android 10. É um projeto de rastreamento de código aberto sofisticado para Android, Linux e Chrome. Em comparação com o Systrace, ele oferece um superconjunto de origens de dados e permite gravar rastros arbitrariamente longos em um fluxo binário de buffer de protocolo. Você pode abrir esses rastros na interface do Perfetto.

O utilitário de rastreamento do sistema é uma ferramenta do Android que salva a atividade do dispositivo em um arquivo de rastreamento. Em um dispositivo com o Android 10 (nível 29 da API) ou mais recente, os arquivos de rastreamento são salvos no formato do Perfetto, conforme mostrado mais adiante neste documento. Nos dispositivos com uma versão anterior do Android, os arquivos de rastreamento são salvos no formato do Systrace.

O Systrace é uma ferramenta de linha de comando legada fornecida pela plataforma que registra a atividade do dispositivo durante um curto período em um arquivo de texto compactado. Ele gera um relatório que combina dados do kernel do Android, como o programador de CPU, a atividade do disco e as linhas de execução do app. O Systrace funciona em todas as versões da plataforma Android, mas recomendamos o Perfetto para dispositivos com o Android 10 e mais recentes.

Captura de tela da visualização de
rastreamento do Perfetto — **Figura 1**. Exemplo da visualização de rastreamento do Perfetto, que mostra cerca de 20 segundos de interação com um app.

Captura de tela do relatório do
Systrace — **Figura 2**. Exemplo do relatório HTML do Systrace, que mostra cinco segundos de interação com um app.

Os dois relatórios fornecem uma visão geral dos processos do sistema de um dispositivo Android para um determinado período. O relatório também avalia as informações de rastreamento coletadas para destacar os problemas observados, como instabilidade da interface ou alto consumo de energia.

O Perfetto e o Systrace são interoperáveis:

Abra os arquivos do Perfetto e do Systrace na interface do Perfetto. Clique no link Open with legacy UI para abrir os arquivos do Systrace com o visualizador legado na interface do Perfetto.
Converta um rastro do Perfetto para o formato de texto legado do Systrace usando a ferramenta traceconv.

Guias de rastreamento do sistema

Para saber mais sobre as ferramentas de rastreamento do sistema, consulte os seguintes guias:

Inspecionar atividades de CPU com o CPU Profiler: Mostra como criar o perfil de uso da CPU e de atividade das linhas de execução do seu app no Android Studio.
Capturar um rastreamento do sistema em um dispositivo: Explica como capturar um rastreamento do sistema diretamente em qualquer dispositivo com o Android 9 (nível 28 da API) ou mais recente.
Capturar um rastreamento do sistema na linha de comando: Define as diferentes opções e flags que podem ser transmitidas para a interface de linha de comando do Systrace.
Executar o Perfetto usando o adb: Descreve como executar a ferramenta de linha de comando perfetto para capturar rastros.
Guia de início rápido: gravar rastros no Android: Documentação externa que descreve como criar e executar a ferramenta de linha de comando perfetto para capturar rastros.
Guia de início rápido: gravar rastros no Android: O leitor de rastros baseado na Web do Perfetto abre o rastreamento dessa ferramenta e mostra um relatório completo. Também é possível abrir os rastros do Systrace nesse visualizador usando a opção de interface legada.
Navegar por um relatório do Systrace: Lista os elementos de um relatório típico, apresenta atalhos de teclado para navegar pelo relatório e descreve como identificar os tipos de problemas de desempenho.
Definir eventos personalizados: Descreve como aplicar rótulos personalizados a seções específicas do seu código, facilitando a análise de causas raiz no Systrace.