Realizar un diagnóstico de rendimiento puede ayudar a los desarrolladores a identificar las causas de un alto uso de la CPU, ralentizaciones o un consumo excesivo de memoria en Thunderbird. Antes de comenzar, comprueba si el problema desaparece cuando Thunderbird se inicia en Modo de resolución de problemas. También puede ser útil revisar la lista de verificación de rendimiento.

Algunos tipos de diagnósticos requieren el uso de una versión de desarrollo de Thunderbird, disponible en la página de descarga de Thunderbird.

Los diagnósticos de rendimiento utilizan una herramienta llamada perfilador de rendimiento. Thunderbird utiliza el perfilador de Firefox, por lo que algunas ventanas de diálogo pueden hacer referencia a Firefox. La documentación del perfilador de Firefox es excelente, pero normalmente no es necesaria a menos que encuentres dificultades o necesites realizar tareas especiales como el perfilado de inicio. En la documentación, cada instancia de la palabra “Firefox” debe entenderse como “Thunderbird”.

Preparando el perfilador de rendimiento

El perfilador de rendimiento es parte de las Herramientas para desarrolladores (Developer Tools).

Abrir las Herramientas para desarrolladores

En la ventana principal de Thunderbird, abre las herramientas para desarrolladores:

1. Usa el atajo de teclado Ctrl + Shift + Icommand + option + I, o haz clic en el botón de menú en Thunderbird y elige Tools.
2. En el menú, selecciona Developer Tools. Aparecerá un aviso de conexión entrante.
   
   

   ¡Importante! Para permitir que las herramientas para desarrolladores se conecten a Thunderbird, debes aprobar la conexión en el aviso.
   La ventana del aviso puede estar oculta detrás de otras ventanas de Thunderbird.

3. Haz clic en OK. Se abrirá la ventana de Herramientas para desarrolladores. En las versiones actuales de Thunderbird, la pestaña Performance está visible, y al hacer clic en ella se muestra el botón Start Recording.
   Si la pestaña no está visible:

   • Pulsa F1 o haz clic en el botón en la esquina superior derecha de la ventana y elige Settings. Se abrirá la ventana de configuración de las herramientas para desarrolladores.
   • Asegúrate de que la sección Herramientas para desarrolladores predeterminadas (Default Developer Tools) tenga habilitada la opción [✓] Performance. Si no está habilitada:

   • habilítala y luego haz clic en la pestaña Performance que aparece en la parte superior de la ventana de herramientas para desarrolladores.

Configurar los ajustes del perfilador

Para configurar los ajustes del perfilador:

1. En la parte inferior de la pestaña Rendimiento (Performance), haz clic en Editar ajustes… (Edit Settings…). Se abrirá una ventana de Thunderbird con la pestaña de configuración del perfilador activa.
2. En la sección Ajustes del perfilador (Profiler Settings), activa el botón de opción Thunderbird (en las versiones nightly/trunk, el botón Daily). Después de cambiar otras opciones, este botón se desactivará automáticamente y se activará el botón Custom.
3. En la sección Características (Features), activa la casilla de verificación All File IO.
4. Para proteger la privacidad o reducir el uso de memoria, desplázate hacia abajo y desactiva la casilla de verificación Screenshots.
5. Ajusta otros parámetros si es necesario. Por ejemplo:
   • Cambia la opción Asignaciones nativas (Native Allocations) disponible en Thunderbird Daily si estás diagnosticando un alto uso de memoria.
   • Aumenta el tamaño del búfer de 1 GB a 2 GB y amplía el intervalo de muestreo más allá del valor predeterminado de 1 ms si la reproducción del problema requiere más de un minuto de grabación o si se han habilitado recopilaciones de datos adicionales.
6. Cierra la ventana de configuración del perfilador utilizando los controles de la ventana; no hay ningún botón OK o Save.

Grabar un diagnóstico de rendimiento

Cuando el perfilador y el escenario de prueba estén listos, puedes empezar a grabar y guardar el diagnóstico de rendimiento.

1. En la pestaña Performance de la ventana de herramientas para desarrolladores, haz clic en el botón Start Recording.

   Nota. Puede aparecer un icono de advertencia en la barra de herramientas. Al hacer clic en él se abre una consola en la parte inferior de la ventana con el mensaje "Failed to get the active browserId while starting the profiler", que puede ignorarse.

2. Después de que comience la grabación, vuelve rápidamente a la ventana principal de Thunderbird y realiza las acciones de tu escenario de prueba.
3. Cuando termines, vuelve inmediatamente a la ventana de herramientas para desarrolladores y haz clic en Capture recording para detener la recopilación de datos. Aparecerá un breve mensaje Capturing profile (Capturando perfil), seguido de la ventana del perfilador de Firefox que muestra los datos grabados.

Guardar y compartir los resultados del diagnóstico de rendimiento

Para guardar y compartir los resultados del diagnóstico de rendimiento:

1. Haz clic en el botón Upload Local Profile en la esquina superior derecha de la ventana del perfilador.

   

2. En el panel "Compartir perfil de rendimiento" ("Share Performance Profile"), selecciona las casillas de verificación de cualquier información privada que desees incluir. Por defecto, no se incluye información privada en el perfil de rendimiento.

   

3. Haz clic en el botón para guardar un archivo JSON localmente. A continuación, puedes enviarlo por correo electrónico o adjuntarlo a un informe de error.
4. Haz clic en el botón para subir el perfil al repositorio del perfilador de Firefox y generar un enlace directo (permalink). El enlace estará disponible después de hacer clic en el botón Permalink en la ventana del perfilador. Puedes copiarlo y compartirlo con los desarrolladores u otras personas que puedan ayudar a diagnosticar el problema, o adjuntarlo a un informe de error nuevo o existente en Bugzilla (BMO).

   

5. Cierra la ventana del perfilador de rendimiento.
6. Cierra la ventana de herramientas para desarrolladores.

Diagnosticar el inicio y el cierre de Thunderbird

El diagnóstico de inicio o cierre requiere seguir unas instrucciones especiales, pero muy sencillas. Como antes, cada instancia de la palabra "Firefox" debe entenderse como "Thunderbird".