Captura un registro del sistema en un dispositivo

Organiza tus páginas con colecciones Guarda y categoriza el contenido según tus preferencias.

Los dispositivos que ejecutan Android 9 (nivel de API 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 capturar registros 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 registros con tu equipo de desarrollo.

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

Cómo capturar un registro del sistema

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

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

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

Cómo configurar el mosaico

Figura 2: Interruptor 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 tu dispositivo de prueba o si no ves el mosaico de Registro del sistema en el panel de 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 abrirá la app de Registro del sistema y se mostrará el menú de la app.
  4. Desde el menú de la app, habilita la opción de Mostrar el mosaico de Configuración rápida, como se muestra en la Figura 2. El sistema agregará el mosaico de Registro del sistema al panel de Configuración rápida, que se muestra en la Figura 1:

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

    Nota: De manera predeterminada, el sistema agrega el mosaico de Registro del sistema como primer mosaico en el panel de 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 la captura de un registro del sistema

A fin de capturar un registro del sistema con el panel de Configuración rápida, completa los siguientes pasos:

  1. Presiona el mosaico de Registro del sistema, en el que se muestra la etiqueta "Registrar seguimiento". Se habilitará el mosaico y aparecerá una notificación persistente para informarte que el sistema ahora está capturando un registro, como se muestra en la Figura 3:

    Notificación con el mensaje "Se están registrando seguimientos. Presiona para detener el registro".
    Figura 3: Notificación persistente que se muestra después de iniciar un registro 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 registro. Para ello, presiona el mosaico de Registro del sistema en el panel de Configuración rápida o en la notificación de Registro del sistema.

    El sistema mostrará una notificación nueva con el mensaje "Guardando seguimiento". Cuando se termine de guardar, el sistema descartará la notificación y mostrará una tercera notificación, que confirma que se guardó el registro y que ya puedes compartir el registro del sistema, como se muestra en la Figura 4:

    Notificación con el mensaje "Se guardó el seguimiento. Toca para compartir el seguimiento".
    Figura 4: Notificación persistente que se muestra una vez que el sistema termina de guardar un registro capturado

Cómo grabar usando el menú de la app

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

Si deseas capturar un registro 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 Registro del sistema.

    Alternativamente, si configuraste el mosaico de 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 registro del sistema.

  4. De manera alternativa, 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 de uso que estés probando, como la categoría Audio para probar las operaciones de 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 a fin de habilitar los registros 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 Grabar seguimiento, destacado en la Figura 5. Se habilitará el mosaico y aparecerá una notificación persistente con el fin de informarte que el sistema ahora está capturando un registro (Figura 3).

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

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

    El sistema mostrará 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 registro y que ya puedes compartir el registro del sistema, como se muestra en la Figura 4.

Cómo compartir un registro del sistema

La app de Registro del sistema te ayuda a compartir los resultados del registro del sistema como parte de varios flujos de trabajo diferentes. En un dispositivo que ejecuta Android 10 (nivel de API 29) o una versión posterior, se guardan los archivos de registro 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, estos archivos se guardan 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 registro que recopilaste con otras apps en tu dispositivo. Al hacerlo, puedes enviar el registro a tu equipo de desarrollo por correo electrónico o mediante una app de seguimiento de errores sin necesidad de conectar un dispositivo a tu máquina de desarrollo.

Después de haber capturado un registro 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 registro mediante la app de mensajería que desees.

Cómo compartir desde la app de Archivos

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

Cómo descargar un informe con ADB

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

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

Cómo convertir archivos a otros formatos de registro

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

Cómo crear un informe HTML

Cuando compartes el registro, 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 registro 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 registro 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 de terminal a fin de generar un informe HTML a partir del archivo de registro:

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.