Executar um diagnóstico de desempenho pode ajudar os programadores a identificar as causas do elevado uso do CPU, abrandamentos ou consumo excessivo de memória no Thunderbird. Antes de começar, verifique se o problema desaparece quando o Thunderbird é iniciado no Modo de Resolução de Problemas. Também pode ser útil rever a lista de verificação de desempenho.

Alguns tipos de diagnósticos requerem a utilização de uma versão de desenvolvimento do Thunderbird, disponível na página de transferências do Thunderbird.

Os diagnósticos de desempenho utilizam uma ferramenta chamada gerador de perfis de desempenho. O Thunderbird utiliza o gerador de perfis do Firefox, pelo que algumas janelas de diálogo podem referir-se ao Firefox. A documentação do gerador de perfis do Firefox é excelente, mas geralmente não é necessária, a menos que encontre dificuldades ou precise de executar tarefas especiais, como a criação de perfis de arranque. Na documentação, cada instância da palavra “Firefox” deve ser entendida como “Thunderbird”.

Preparar o Gerador de Perfis de Desempenho

O gerador de perfis de desempenho faz parte das Ferramentas do Programador.

Abrir as Ferramentas do Programador

Na janela principal do Thunderbird, abra as ferramentas do programador:

1. Utilize o atalho de teclado Ctrl + Shift + Icommand + option + I, ou clique no botão do menu no Thunderbird e escolha Tools.
2. No menu, selecione Developer Tools. Irá aparecer um pedido de ligação de entrada.
   
   

   Importante! Para permitir que as ferramentas do programador se liguem ao Thunderbird, tem de aprovar a ligação no pedido.
   A janela do pedido pode estar oculta atrás de outras janelas do Thunderbird.

3. Clique em OK. A janela Ferramentas do Programador será aberta. Nas versões atuais do Thunderbird, o separador Performance está visível e, ao clicar nele, é apresentado o botão Start Recording.
   Se o separador não estiver visível:

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

   • ative-a e, em seguida, clique no separador Performance que aparece na parte superior da janela das ferramentas do programador.

Configurar as definições do gerador de perfis

Para configurar as definições do gerador de perfis:

1. Na parte inferior do separador Desempenho, clique em Editar Definições…. Será aberta uma janela do Thunderbird com o separador de definições do gerador de perfis ativo.
2. Na secção Definições do Gerador de Perfis, ative o botão de rádio Thunderbird (nas versões nightly/trunk, o botão Daily). Depois de alterar outras opções, este botão será desativado automaticamente e o botão Custom ficará ativo.
3. Na secção Funcionalidades, ative a caixa de verificação All File IO.
4. Para proteger a privacidade ou reduzir a utilização de memória, desloque-se para baixo e desative a caixa de verificação Screenshots.
5. Ajuste outras definições, se necessário. Por exemplo:
   • Altere a opção Alocações Nativas disponível no Thunderbird Daily se estiver a diagnosticar uma elevada utilização de memória.
   • Aumente o tamanho da memória intermédia de 1 GB para 2 GB e aumente 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 estiverem ativadas recolhas de dados adicionais.
6. Feche a janela de definições do gerador de perfis utilizando os controlos da janela – não existe um botão OK ou Save.

Gravar um diagnóstico de desempenho

Quando o gerador de perfis e o cenário de teste estiverem prontos, pode começar a gravar e a guardar o diagnóstico de desempenho.

1. No separador Performance da janela das ferramentas do programador, clique no botão Start Recording.

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

2. Depois de a gravação começar, volte rapidamente para a janela principal do Thunderbird e execute as ações do seu cenário de teste.
3. Quando terminar, volte imediatamente para a janela das ferramentas do programador e clique em Capture recording para parar a recolha de dados. Aparecerá uma breve mensagem A capturar perfil, seguida da janela do gerador de perfis do Firefox a apresentar os dados gravados.

Guardar e partilhar os resultados do diagnóstico de desempenho

Para guardar e partilhar os resultados do diagnóstico de desempenho:

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

   

2. No painel “Partilhar Perfil de Desempenho”, selecione as caixas de verificação de qualquer informação privada que queira incluir. Por predefinição, nenhuma informação privada é incluída no perfil de desempenho.

   

3. Clique no botão para guardar um ficheiro JSON localmente. Pode depois enviá-lo por e-mail ou anexá-lo a um relatório de erro.
4. Clique no botão para carregar o perfil para o repositório do gerador de perfis do Firefox e gerar uma ligação direta (permalink). A ligação fica disponível depois de clicar no botão Permalink na janela do gerador de perfis. Pode copiá-la e partilhá-la com os programadores ou outras pessoas que possam ajudar a diagnosticar o problema, ou anexá-la a um relatório de erro novo ou existente no Bugzilla (BMO).

   

5. Feche a janela do gerador de perfis de desempenho.
6. Feche a janela das ferramentas do programador.

Diagnosticar o arranque e o encerramento do Thunderbird

Os diagnósticos de arranque ou encerramento requerem que siga instruções especiais, mas muito simples. Como anteriormente, cada instância da palavra “Firefox” deve ser entendida como “Thunderbird”.