steipete/instruments-profiling

Perfilamiento con Instruments/xctrace: Trazas de macOS/iOS, binarios, argumentos y exportaciones.

¿Qué es instruments-profiling?

Este skill proporciona una guía completa para usar Instruments y la herramienta de línea de comandos `xctrace` para perfilar aplicaciones nativas en macOS e iOS. Está diseñado para ayudar a desarrolladores e ingenieros a capturar trazas de rendimiento, analizar pilas de llamadas y exportar datos para su procesamiento posterior. El skill cubre el uso del Time Profiler, la selección correcta del binario o aplicación a perfilar (evitando errores comunes como perfilizar la app incorrecta), y la exportación de datos en formatos como XML para análisis automatizados. Es compatible con plataformas macOS e iOS, y proporciona consejos prácticos, soluciones a problemas frecuentes y un checklist de verificación para garantizar la calidad de las trazas.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/steipete/agent-scripts/tree/main/skills/instruments-profiling

Installed? Explore more Investigación y análisis de datos skills: affaan-m/uspto-database, affaan-m/scholar-evaluation, affaan-m/literature-review · View all 6 →

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Perfilamiento con Instruments (macOS/iOS)

Usa este skill cuando el usuario necesite perfilamiento de rendimiento o análisis de pilas para aplicaciones nativas. Enfoque: Time Profiler, xctrace CLI y seleccionar la instancia correcta de binario/aplicación.

Inicio Rápido (CLI)

  • Listar plantillas: xcrun xctrace list templates
  • Grabar Time Profiler (lanzamiento):
    • xcrun xctrace record --template 'Time Profiler' --time-limit 60s --output /tmp/App.trace --launch -- /ruta/App.app
  • Grabar Time Profiler (adjuntar):
    • Lanza la aplicación tú mismo, obtén el PID, luego:
    • xcrun xctrace record --template 'Time Profiler' --time-limit 60s --output /tmp/App.trace --attach <pid>
  • Abrir traza en Instruments:
    • open -a Instruments /tmp/App.trace

Nota: xcrun xctrace --help no es un subcomando válido. Usa xcrun xctrace help record.

Seleccionar el Binario Correcto (Crítico)

Problema común: Instruments puede perfilar la aplicación equivocada (por ejemplo, una en /Applications) si LaunchServices resuelve un paquete diferente. Usa estas reglas:

  • Prefiere la ruta directa al binario para un lanzamiento determinista:
    • xcrun xctrace record ... --launch -- /ruta/App.app/Contents/MacOS/App
  • Si lanzas .app, asegúrate de que sea el paquete correcto:
    • open -n /ruta/App.app
    • Verifica con ps -p <pid> -o comm= -o command=
  • Si existen tanto /Applications/App.app como una compilación local, apunta explícitamente a la ruta de compilación local.
  • Después del lanzamiento, confirma la ruta del proceso antes de confiar en la traza.

Argumentos de Comando (xctrace)

  • --template 'Time Profiler': nombre de la plantilla tomado de xctrace list templates.
  • --launch -- <comando>: todo después de -- es el comando objetivo (binario o paquete de app).
  • --attach <pid|nombre>: adjuntarse a un proceso en ejecución.
  • --output <ruta>: salida .trace. Si se omite, el archivo se guarda en el directorio de trabajo actual.
  • --time-limit 60s|5m: establecer duración de captura.
  • --device <nombre|UDID>: requerido para ejecuciones en dispositivos iOS.
  • --target-stdout -: transmite la salida estándar del proceso lanzado al terminal (útil para herramientas CLI).

Exportación de Pilas (CLI)

  • Inspeccionar tablas de la traza:
    • xcrun xctrace export --input /tmp/App.trace --toc
  • Exportar muestras sin procesar de time-profile:
    • xcrun xctrace export --input /tmp/App.trace --xpath '/trace-toc/run[@number="1"]/data/table[@schema="time-profile"]' --output /tmp/time-profile.xml
  • Postprocesar en un script (Python/Rust) para agregar pilas.

Flujo de Trabajo en la Interfaz de Instruments

  • Plantilla: Time Profiler
  • Usa “Record” y captura la ruta lenta (inicio vs estado estable)
  • Consejos de Call Tree:
    • Ocultar Bibliotecas del Sistema
    • Invertir Call Tree
    • Separar por Hilo
    • Enfocarse en marcos calientes y recuentos de llamadas

Problemas Comunes y Soluciones

  • Aplicación equivocada perfilada: LaunchServices resuelve la aplicación instalada en lugar de la compilación local.
    • Solución: usa la ruta directa al binario o --attach con un PID conocido.
  • Sin muestras / traza vacía: La aplicación sale rápidamente o nunca ejecuta la carga de trabajo.
    • Solución: captura más larga, dispara la carga de trabajo durante la grabación.
  • Solicitudes de privacidad: xctrace puede necesitar permiso de Herramientas de Desarrollo.
    • Solución: Configuración del Sistema → Privacidad y Seguridad → Herramientas de Desarrollo → permitir Terminal/Xcode.
  • Exportaciones XML grandes: las exportaciones de time-profile son enormes.
    • Solución: filtrar con XPath y agregar sin conexión; no imprimir en el terminal.

Notas Específicas de iOS

  • Dispositivo: usa xcrun xctrace list devices y --device <UDID>.
  • Lanza mediante Xcode si es necesario; adjunta con xctrace --attach.
  • Asegura símbolos de depuración para pilas significativas.

Lista de Verificación

  • Confirmar que la ruta del proceso en la traza coincida con la compilación objetivo.
  • Confirmar que las pilas muestren los marcos de aplicación esperados.
  • La captura cubre la operación lenta (inicio/actualización).
  • Exportar pilas para diferenciación automatizada si se está optimizando.

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

steipete/agent-transcript

GitHub PR/issue agent transcripts: redact, preview, and insert safely.

steipete/beeper

Beeper cache: contact hints, room lookup, WhatsApp/iMessage traces, FTS.

steipete/browser-use

Existing Chrome automation: Chrome plugin first, mcporter fallback.

steipete/clawsweeper-status

ClawSweeper status: URLs, workflow health, active workers, ops snapshot.

steipete/clickclack

ClickClack ops: chat app, Hetzner deploy, DNS/docs/app, Docker rollout.

steipete/cloudflare-registrar

Cloudflare Registrar: domain availability, prices, registration via mcporter.

steipete/codex-debugging

Codex debugging: codex-rs core/tui/exec/cli/app-server/config.

steipete/create-cli

CLI UX/spec: args, flags, help, output, errors, config, dry-run.

steipete/discord-clawd

Discord-backed OpenClaw agent/session relay; not archive search.

steipete/domain-dns-ops

DNS/domain ops: registrars, zones, redirects, DNS/HTTP verify, manager truth.

steipete/frontend-design

Frontend UI: pages, apps, components, polished non-generic design.

steipete/github-author-context

GitHub contributor context: identity, activity, trust, company/team signal.

steipete/github-cache-hygiene

GitHub quota/cache hygiene: gh, ghx, xcache, gitcrawl, mirrors, limits.

steipete/github-deep-review

GitHub deep review: bugs, PRs, best fix, stale-or-real, read code first.

steipete/github-project-triage

GitHub issue/PR triage: queues, CI, blockers, risk, proof, next actions.

steipete/hopper-debugger

Hopper debugging: macOS/iOS binaries, ObjC/Swift symbols, dyld, LLDB.

steipete/mac-maintenance

Mac upkeep: brew update/upgrade, pull clean repos, empty Trash.

steipete/maintainer-orchestrator

Open-source maintainer orchestration: Codex app workers, work recovery, dependencies, vision, releases.

steipete/markdown-converter

Markdown conversion: PDF, Office, HTML, data, OCR, audio, ZIP, YouTube.

steipete/nano-banana-pro

Nano Banana/Gemini image gen/edit: text/image input, 512-4K workflows.

Skills relacionados