Trazas

La herramienta Traces graba lo que hicieron el sistema y una app durante unos segundos, y luego te ayuda a descubrir por qué fue lento. Reúne tres herramientas oficiales y guarda su salida en una sola biblioteca:

Inicio rápido#

1. Abre Traces (⌘7) y elige tu dispositivo. Elige una app en la barra de herramientas si quieres centrarte en una.
2. Elige qué grabar, define la duración (de 1 a 300 segundos) y pulsa Record. Stop la termina antes y conserva lo grabado hasta ese momento.
3. La grabación se abre sola. Cada grabación se conserva en la lista Recordings hasta que la eliminas.

Desde una terminal:

emulabzip trace record --preset frames --duration 15 -o frames.pftrace
emulabzip trace summary frames.pftrace
emulabzip trace query frames.pftrace "select name, count(*) n from slice group by name order by n desc limit 10"
emulabzip trace cpu --app com.example.app --duration 10 --folded stacks.txt

Trazas del sistema (Perfetto)#

Cuatro presets cubren las preguntas habituales. Son configuraciones de texto normales de Perfetto, así que Custom acepta las tuyas.

La pestaña Summary muestra:

• la duración de la traza, lo ocupada que estuvo la CPU, el número de fotogramas y el tiempo de fotograma en los percentiles 50, 90 y 99;
• el tiempo de CPU por proceso y por hilo;
• para los fotogramas: los tipos de jank (como los nombra SurfaceFlinger) y, por capa, cuántos fotogramas llegaron tarde. Un fotograma cuenta como tardío cuando la app o el compositor no cumplió su plazo; Prediction Error y Buffer Stuffing por sí solos no;
• memoria: los contadores del sistema más bajos y más altos y la memoria residente máxima por proceso;
• los slices con más tiempo en total.

Una sección se omite cuando la traza no tiene datos para ella. Una traza de memoria no tiene planificación, y una traza de CPU no tiene fotogramas. Usa la pestaña SQL para todo lo demás: ejecuta PerfettoSQL (⌘/Ctrl + Enter) con tablas como slice, sched, thread, process y counter, y muestra hasta 5.000 filas.

El trace processor#

Leer una traza de Perfetto necesita el trace_processor_shell de Google. EmuLabZip no lo incluye. La primera vez que abres una traza de Perfetto explica la descarga y pregunta antes:

• viene del release oficial de Perfetto en GitHub (versión fijada en el código fuente, de 12 a 81 MB según la plataforma);
• el archivo se comprueba contra un SHA-256 fijado en el código fuente, y se descarta si no coincide;
• se guarda en tools/ dentro de la carpeta de datos de EmuLabZip, y se inicia solo en 127.0.0.1, en un puerto libre, cuando abres una traza. Se detiene cuando abres otra traza o cierras.

Abrir en la UI de Perfetto#

Open in Perfetto UI sirve el archivo una vez desde 127.0.0.1 con los headers que necesita ui.perfetto.dev, y luego abre tu navegador. La página carga la traza desde tu propio ordenador: el archivo nunca se sube. El servidor solo responde por ese archivo y se detiene después de que se haya descargado o pasados dos minutos.

Perfiles de CPU (simpleperf)#

simpleperf muestrea la CPU con call stacks. EmuLabZip lo ejecuta en el dispositivo, convierte su informe en el dispositivo y recoge el resultado, así que no hace falta el NDK en tu ordenador.

• Una app: la app tiene que estar en ejecución, y ser debuggable o profileable. Si no, simpleperf se niega y EmuLabZip lo dice. No espera a una app que no está en ejecución.
• Whole system: muestrea todos los procesos. Necesita adb root, así que usa una imagen de emulador sin Google Play.

El flame graph es un icicle: la llamada más externa arriba, con un ancho proporcional al tiempo de CPU. Haz clic en un fotograma para acercarte, usa el breadcrumb para alejarte, escribe para resaltar una función y elige otro proceso o hilo encima. Los colores indican de quién es el código de un fotograma:

Bajo el gráfico, Hot functions lista dónde se gastó el tiempo en una función misma y no en lo que llamó. Folded stacks guarda el árbol de llamadas para flamegraph.pl y speedscope. El perf.data sin procesar se conserva junto a la grabación; Show in folder lo revela.

Instruments (simulador de iOS)#

EmuLabZip ejecuta xcrun xctrace record para cualquier plantilla que informe xctrace list templates, asociado a la app que elegiste (o a todos los procesos). El resultado es un documento .trace: Open in Instruments lo abre. Para Time Profiler y CPU Profiler, EmuLabZip también exporta las muestras (xctrace export) y dibuja el mismo flame graph.

Requisitos:

• Xcode, con xcrun xctrace disponible.
• Developer Mode en el Mac. Sin él, xctrace espera una aprobación que nadie puede dar. EmuLabZip comprueba DevToolsSecurity -status primero y te dice qué hacer: ejecuta sudo DevToolsSecurity -enable en una terminal.
• Para una sola app, tiene que estar en ejecución en el simulador.

El lector de la exportación de Time Profiler sigue la forma que documenta xctrace (filas con un hilo, un peso y un stack, con los elementos repetidos escritos una vez y referenciados por id). Está cubierto por pruebas sobre una exportación escrita a mano; no había grabaciones de un Mac con Developer Mode disponibles mientras se escribió. Si una grabación se abre sin flame graph, el .trace sigue intacto y se abre en Instruments. Abre un issue con la versión de Xcode.

Dónde viven las grabaciones#

Cada grabación es una carpeta en traces/ dentro de la carpeta de datos de EmuLabZip (EMULABZIP_HOME la mueve):

traces/20261023-184501-3f2a/
    meta.json          what was recorded, where and when
    trace.pftrace      or profile.pb (+ perf.data), or recording.trace (+ time-profile.xml)

emulabzip trace list las imprime. Eliminar una en la app borra su carpeta. Nada que se escriba en un dispositivo se queda sin eliminar: las configuraciones, las grabaciones sin procesar y los informes se borran del dispositivo cuando termina una grabación, haya funcionado, fallado o se haya detenido.

Límites#

• Como máximo 300 segundos por grabación, y 1 GB por traza de Perfetto.
• Perfetto necesita Android 9 (API 28) o posterior. En Android 9 y 10, EmuLabZip activa persist.traced.enable, ya que la imagen del sistema lo trae desactivado.