Únete a ⁠ #Android11: The Beta Launch Show el 3 de junio.

Cómo capturar un registro del sistema en un dispositivo

Los dispositivos que ejecutan Android 9 (API nivel 28) o versiones posteriores incluyen una app a nivel del sistema llamada Registro del sistema. Esta app es similar a la utilidad de línea de comandos de systrace, pero te permite registrar seguimientos directamente desde un dispositivo de prueba, sin necesidad de conectar el dispositivo mediante ADB. Luego, puedes usar la app para compartir los resultados de estos seguimientos con tu equipo de desarrollo.

Es especialmente útil para registrar seguimientos cuando abordas errores relacionados con el rendimiento en tu app, como tiempos de inicio y transición lentos o bloqueos de IU.

Cómo registrar un seguimiento del sistema

La app Registro del sistema te permite registrar un seguimiento del sistema mediante el mosaico Configuración rápida o un menú dentro de la app. En las siguientes secciones, se describe cómo completar el proceso de registro usando estas interfaces.

Cómo grabar mediante el mosaico Configuración rápida

Por lo general, el mosaico Configuración rápida es la manera más conveniente de completar el proceso de seguimiento del sistema en el dispositivo.

Cómo configurar el mosaico

Figura 2: Interruptor de Mostrar el mosaico de Configuración rápida en la app de Registro del sistema

Si usas el Registro del sistema por primera vez en el dispositivo de prueba o si no ves el mosaico Registro del sistema en el panel Configuración rápida de tu dispositivo (figura 1), completa los siguientes pasos de configuración:

  1. Habilita las opciones para desarrolladores, si todavía no lo hiciste.
  2. Abre la pantalla de configuración Opciones para desarrolladores.
  3. En la sección Depuración, selecciona Registro del sistema. Se abre la app Registro del sistema y se muestra el menú de la app.
  4. Desde el menú de la app, habilita el mosaico Mostrar el mosaico de Configuración rápida, como se muestra en la figura 2. El sistema agrega el mosaico Registro del sistema al panel Configuración rápida, que se muestra en la figura 1:

    Figura 1: Mosaico Registro del sistema en el panel Configuración rápida

    Nota: De manera predeterminada, el sistema agrega el mosaico Registro del sistema como primer mosaico en el panel Configuración rápida. Si quieres que el mosaico se muestre en una posición diferente, usa el modo de edición del panel para mover el mosaico.

Cómo completar el registro de un seguimiento del sistema

Para registrar un seguimiento del sistema con el panel Configuración rápida, completa los siguientes pasos:

  1. Presiona el mosaico Registro del sistema, en el que se muestra la etiqueta "Grabar seguimiento". Se habilita el mosaico y aparece una notificación persistente para informarte que el sistema ahora está registrando un seguimiento, como se muestra en la figura 3:

    Notificación con el mensaje
    Figura 3: Notificación persistente que se muestra después de iniciar un seguimiento del sistema en el dispositivo
  2. En tu app, realiza las acciones que deseas que inspeccione el sistema.

  3. Una vez que hayas completado estas acciones, detén el seguimiento. Para ello, presiona el mosaico Registro del sistema en el panel Configuración rápida o en la notificación de Registro del sistema.

    El sistema muestra una notificación nueva con el mensaje "Guardando seguimiento". Cuando se termina de guardar, el sistema descarta la notificación y muestra una tercera notificación, que confirma que se guardó el seguimiento y que ya puedes compartir el seguimiento del sistema, como se muestra en la figura 4:

    Notificación con el mensaje
    Figura 4: Notificación persistente que se muestra una vez que el sistema termina de guardar un seguimiento registrado

Cómo registrar un seguimiento usando el menú de la app

El menú de la app te permite definir varias opciones de configuración avanzada relacionadas con el seguimiento del sistema y proporciona un interruptor para iniciar y detener el seguimiento del sistema.

Si deseas registrar un seguimiento del sistema con el menú de la app de Registro del sistema, completa los siguientes pasos:

  1. Habilita las opciones para desarrolladores, si todavía no lo hiciste.
  2. Abre la pantalla de configuración Opciones para desarrolladores. En la sección Depuración, selecciona Registro del sistema. Se abrirá la app de Registro del sistema.

    Alternativamente, si configuraste el mosaico Registro del sistema, puedes mantenerlo presionado para iniciar la app de Registro del sistema.

  3. Asegúrate de que esté seleccionada la opción Registrar aplicaciones depurables para incluir aplicaciones que tengan habilitada la depuración en el seguimiento del sistema.

  4. Como opción, elige las Categorías de llamadas del sistema y del sensor que quieras registrar, y selecciona un Tamaño del búfer por cada CPU (en KB). Elige las categorías que correspondan al caso práctico que estés probando, como la categoría Audio para probar las operaciones Bluetooth o la categoría Memoria para las asignaciones de montón.

    Figura 5: Interruptor Registrar seguimiento en la app de Registro del sistema
  5. De manera opcional, selecciona Registros largos para habilitar los seguimientos que se guardan de forma continua en el almacenamiento del dispositivo. En esta opción, debes establecer límites para el Tamaño máximo del registro largo y la Máxima duración del registro largo.

  6. Habilita el interruptor Registrar seguimiento, destacado en la figura 5. Se habilita el mosaico y aparece una notificación persistente para informarte que el sistema ahora está registrando un seguimiento (figura 3).

  7. En tu app, realiza las acciones que deseas que inspeccione el sistema.

  8. Cuando hayas completado estas acciones, detén el seguimiento. Para ello, inhabilita el interruptor Registrar seguimiento.

    El sistema muestra una notificación nueva con el mensaje "Guardando seguimiento". Cuando se termina de guardar, el sistema descarta la notificación y muestra una tercera notificación, que confirma que se guardó el seguimiento y que ya puedes compartir el seguimiento del sistema, como se muestra en la figura 4.

Cómo compartir un seguimiento del sistema

La app de Registro del sistema te ayuda a compartir los resultados del seguimiento del sistema como parte de varios flujos de trabajo diferentes. En un dispositivo que ejecuta Android 10 (API nivel 29) o una versión posterior, se guardan los archivos de seguimiento con la extensión de nombre .perfetto-trace y se pueden abrir en la IU de Perfetto. En un dispositivo que ejecuta una versión anterior de Android, se guardan los archivos de seguimiento con la extensión de nombre de archivo .ctrace, que denota el formato Systrace.

Cómo compartir como mensaje

Registro del sistema te permite compartir el seguimiento que recopilaste con otras apps en tu dispositivo. Al hacerlo, puedes enviar el seguimiento a tu equipo de desarrollo por correo electrónico o una app de seguimiento de errores sin necesidad de conectar un dispositivo a tu máquina de desarrollo.

Después de haber registrado un seguimiento del sistema, presiona la notificación que se muestra en el dispositivo (consulta la figura 4). Aparecerá el selector de intent de la plataforma, que te permite compartir tu seguimiento mediante la app de mensajería que desees.

Cómo compartir desde la app de Archivos

En los dispositivos que ejecutan Android 10 (API nivel 29), los seguimientos se muestran en la app de Archivos. Si lo deseas, puedes compartir un seguimiento desde esta app.

Cómo descargar un informe con ADB

Si lo deseas, también puedes usar ADB para extraer un seguimiento del sistema de un dispositivo. Conecta el dispositivo que registró el seguimiento a tu máquina de desarrollo y, luego, ejecuta los siguientes comandos en una ventana del terminal:

    cd /path-to-traces-on-my-dev-machine && \
      adb pull /data/local/traces/ .

Cómo convertir archivos a otros formatos de seguimiento

Puedes convertir archivos de registro de Perfetto al formato Systrace. Consulta Cómo convertir archivos a otros formatos de seguimiento para obtener más información.

Cómo crear un informe HTML

Cuando compartes el seguimiento, el informe reside en un archivo .perfetto-trace (en dispositivos que ejecutan Android 10 o versiones posteriores) o en un archivo .ctrace (para todas las demás versiones).

Crea un informe HTML a partir del archivo de seguimiento mediante una IU basada en la Web o desde la línea de comandos.

IU basada en la Web

Usa la IU de Perfetto para abrir el archivo de seguimiento y generar el informe.

Para un archivo de Perfetto, haz clic en Open trace file. En el caso de un archivo Systrace, haz clic en Open with legacy UI. La IU heredada tiene el mismo aspecto que el informe de Systrace.

Línea de comandos

Ejecuta los siguientes comandos en una ventana del terminal para generar un informe HTML a partir del archivo de seguimiento:

    cd /path-to-traces-on-my-dev-machine && \
      systrace --from-file trace-file-name{.ctrace | .perfetto-trace}

Si aún no tienes el programa de línea de comandos systrace, puedes descargarlo desde el proyecto Catapult en GitHub o directamente desde el proyecto de código abierto de Android.