Executar um diagnóstico de desempenho pode ajudar desenvolvedores a identificar as causas de alto uso de CPU, lentidão ou consumo excessivo de memória no Thunderbird.

Antes de começar, verifique se o problema desaparece quando o Thunderbird é iniciado no Modo de solução de problemas. Também pode ser útil consultar a lista de verificação de desempenho na wiki.

Alguns tipos de diagnóstico exigem o uso de uma versão de desenvolvimento do Thunderbird, disponível na página de download do Thunderbird.

Diagnósticos de desempenho usam uma ferramenta chamada de analisador de desempenho. O Thunderbird usa o analisador do Firefox, então algumas janelas de diálogo podem se referir ao Firefox. A documentação do analisador do Firefox é excelente, mas geralmente não é necessária, a menos que você encontre dificuldades ou precise executar tarefas especiais, como análise de inicialização. Na documentação, toda instância da palavra “Firefox” deve ser entendida como “Thunderbird”.

Preparando o analisador de desempenho

O analisador de desempenho faz parte das Ferramentas de desenvolvedor.

Abrindo as ferramentas de desenvolvedor

Na janela principal do Thunderbird, abra as ferramentas de desenvolvedor:

1. Use o atalho de teclado Ctrl + Shift + Icommand + option + I, ou clique no botão de menu no Thunderbird e escolha Tools.
2. No menu, selecione Developer Tools. Uma solicitação de conexão de entrada aparecerá.
   
   

   Importante! Para permitir que as ferramentas de desenvolvedor se conectem ao Thunderbird, você deve aprovar a conexão na solicitação. A janela de solicitação pode estar oculta atrás de outras janelas do Thunderbird.

3. Clique em OK. A janela Ferramentas de desenvolvedor será aberta. Nas versões atuais do Thunderbird, a aba Performance está visível e, ao clicar nela, é exibido o botão Start Recording.
   Se a aba não estiver visível:

   • Pressione F1 ou clique no botão no canto superior direito da janela e escolha Settings. A janela de configurações das ferramentas de desenvolvedor será aberta.
   • Certifique-se de que a seção Ferramentas de desenvolvedor padrão tenha a opção [✓] Performance ativada. Se não estiver ativada:

   • ative-a e clique na aba Performance que aparece no topo da janela das ferramentas de desenvolvedor.

Configurando as definições do analisador

Para configurar as definições do analisador:

1. Na parte inferior da aba Desempenho, clique em Editar configurações…. Uma janela do Thunderbird será aberta com a aba de configurações do analisador ativa.
2. Na seção Configurações do analisador, ative o botão de opção Thunderbird (em versões nightly/trunk, o botão Daily). Após alterar outras opções, este botão será desativado automaticamente e o botão Custom se tornará ativo.
3. Na seção Recursos, ative a caixa de seleção All File IO.
4. Para proteger a privacidade ou reduzir o uso de memória, role para baixo e desative a caixa de seleção Screenshots.
5. Ajuste outras configurações, se necessário. Por exemplo:
   • Altere a opção Alocações nativas disponível no Thunderbird Daily se estiver diagnosticando alto uso de memória.
   • Aumente o tamanho do buffer de 1 GB para 2 GB e estenda o intervalo de amostragem para além do padrão de 1 ms se a reprodução do problema exigir mais de um minuto de gravação ou se coletas de dados adicionais estiverem ativadas.
6. Feche a janela de configurações do analisador usando os controles da janela – não há botão OK ou Save.

Gravando um diagnóstico de desempenho

Quando o analisador e o cenário de teste estiverem prontos, você pode começar a gravar e salvar o diagnóstico de desempenho.

1. Na aba Performance da janela de ferramentas de desenvolvedor, clique no botão Start Recording.

   Nota. Um ícone de aviso pode aparecer na barra de ferramentas. Clicar nele abre um console na parte inferior da janela com a mensagem “Failed to get the active browserId while starting the profiler” – isso pode ser ignorado.

2. Após o início da gravação, retorne rapidamente à janela principal do Thunderbird e execute as ações do seu cenário de teste.
3. Ao terminar, retorne imediatamente à janela de ferramentas de desenvolvedor e clique em Capture recording para parar a coleta de dados. Uma breve mensagem Capturando perfil aparecerá, seguida pela janela do analisador do Firefox exibindo os dados gravados.

Salvando e compartilhando os resultados do diagnóstico de desempenho

Para salvar e compartilhar os resultados do diagnóstico de desempenho:

1. Clique no botão Upload Local Profile no canto superior direito da janela do analisador.

   

2. No painel “Compartilhar perfil de desempenho”, selecione as caixas de seleção de qualquer informação privada que você queira incluir. Por padrão, nenhuma informação privada é incluída no perfil de desempenho.

   

3. Clique no botão para salvar um arquivo JSON localmente. Você pode então enviá-lo por e-mail ou anexá-lo a um relatório de bug.
4. Clique no botão para enviar o perfil para o repositório do analisador do Firefox e gerar um link direto (permalink). O link fica disponível após clicar no botão Permalink na janela do analisador. Você pode copiar e compartilhar com desenvolvedores ou outras pessoas que possam ajudar a diagnosticar o problema, ou anexá-lo a um relatório de bug novo ou existente no Bugzilla (BMO).

   

5. Feche a janela do analisador de desempenho.
6. Feche a janela de ferramentas de desenvolvedor.

Diagnosticando a inicialização e o encerramento do Thunderbird

Diagnósticos de inicialização ou encerramento exigem seguir instruções especiais, mas muito simples. Como antes, toda instância da palavra “Firefox” deve ser entendida como “Thunderbird”.