CommunityRecherche & Datenanalysegithub.com

Instruments-Profiling

Performance-Profiling und Stack-Analyse für native macOS-/iOS-Apps mit Instruments, xctrace und dem Time Profiler.

Was ist Instruments-Profiling?

Dieses Skill ermöglicht die Performance-Profilerstellung und Stack-Analyse für native macOS- und iOS-Anwendungen mithilfe von Instruments und dem `xctrace`-CLI-Tool. Es konzentriert sich auf den Time Profiler und die korrekte Auswahl des zu profilierenden Binär-/App-Instanz. Das Skill deckt die Aufzeichnung von Traces (sowohl durch App-Start als auch durch Anhängen an einen laufenden Prozess), das Öffnen der Traces in Instruments, den Export von Rohdaten für die Skriptverarbeitung und die Navigation in der Instruments-Benutzeroberfläche ab. Besondere Aufmerksamkeit wird häufigen Fallstricken gewidmet, wie z. B. der Profilerstellung der falschen App (z. B. einer installierten Version statt eines lokalen Builds), sowie Lösungen dafür. Es enthält auch iOS-spezifische Hinweise und eine Verifikations-Checkliste zur Sicherstellung der Datenqualität. Das Skill ist für Entwickler gedacht, die Flaschenhälse in nativen Apps identifizieren und beheben möchten, und es unterstützt die Plattformen macOS und iOS.

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

Installed? Explore more Recherche & Datenanalyse skills: affaan-m/uspto-database, affaan-m/scholar-evaluation, affaan-m/literature-review · View all 6 →

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Instruments-Profiling (macOS/iOS)

Verwenden Sie dieses Skill, wenn der Nutzer Performance-Profiling oder Stack-Analyse für native Apps wünscht. Fokus: Time Profiler, xctrace CLI, und die Auswahl der richtigen Binär-/App-Instanz.

Schnellstart (CLI)

  • Vorlagen auflisten: xcrun xctrace list templates
  • Time Profiler aufzeichnen (starten):
    • xcrun xctrace record --template 'Time Profiler' --time-limit 60s --output /tmp/App.trace --launch -- /path/To/App.app
  • Time Profiler aufzeichnen (anhängen):
    • App selbst starten, PID ermitteln, dann:
    • xcrun xctrace record --template 'Time Profiler' --time-limit 60s --output /tmp/App.trace --attach <pid>
  • Trace in Instruments öffnen:
    • open -a Instruments /tmp/App.trace

Hinweis: xcrun xctrace --help ist kein gültiger Unterbefehl. Verwenden Sie xcrun xctrace help record.

Die richtige Binärdatei auswählen (entscheidend)

Achtung: Instruments profiliert möglicherweise die falsche App (z. B. eine in /Applications), wenn LaunchServices ein anderes Bundle auflöst. Beachten Sie diese Regeln:

  • Bevorzugen Sie den direkten Binärpfad für deterministisches Starten:
    • xcrun xctrace record ... --launch -- /path/App.app/Contents/MacOS/App
  • Wenn Sie .app starten, stellen Sie sicher, dass es das gewünschte Bundle ist:
    • open -n /path/App.app
    • Überprüfen mit ps -p <pid> -o comm= -o command=
  • Wenn sowohl /Applications/App.app als auch ein lokaler Build existieren, zielen Sie explizit auf den lokalen Build-Pfad.
  • Bestätigen Sie nach dem Start den Prozesspfad, bevor Sie dem Trace vertrauen.

Befehlsargumente (xctrace)

  • --template 'Time Profiler': Vorlagenname aus xctrace list templates.
  • --launch -- <cmd>: Alles nach -- ist der Zielbefehl (Binärdatei oder App-Bundle).
  • --attach <pid|name>: An einen laufenden Prozess anhängen.
  • --output <path>: .trace-Ausgabe. Wenn nicht angegeben, wird die Datei im aktuellen Arbeitsverzeichnis gespeichert.
  • --time-limit 60s|5m: Aufzeichnungsdauer festlegen.
  • --device <name|UDID>: Erforderlich für iOS-Geräteausführungen.
  • --target-stdout -: Standardausgabe des gestarteten Prozesses an das Terminal streamen (nützlich für CLI-Tools).

Stacks exportieren (CLI)

  • Trace-Tabellen inspizieren:
    • xcrun xctrace export --input /tmp/App.trace --toc
  • Rohdaten des Time-Profils exportieren:
    • xcrun xctrace export --input /tmp/App.trace --xpath '/trace-toc/run[@number="1"]/data/table[@schema="time-profile"]' --output /tmp/time-profile.xml
  • Nachbearbeitung in einem Skript (Python/Rust), um Stacks zu aggregieren.

Instruments-Benutzeroberfläche (Workflow)

  • Vorlage: Time Profiler
  • „Aufzeichnen“ verwenden und den langsamen Pfad erfassen (Start vs. stationärer Zustand)
  • Call-Tree-Tipps:
    • Systembibliotheken ausblenden
    • Call-Tree invertieren
    • Nach Thread trennen
    • Fokus auf heiße Frames und Aufrufzahlen

Fallstricke und Lösungen

  • Falsche App profiliert: LaunchServices löst die installierte App anstelle des lokalen Builds auf.
    • Lösung: den direkten Binärpfad verwenden oder mit --attach und bekannter PID anhängen.
  • Keine Samples/leerer Trace: App beendet sich schnell oder erreicht nie die Arbeitslast.
    • Lösung: längere Aufzeichnung, Arbeitslast während der Aufzeichnung auslösen.
  • Datenschutzaufforderungen: xctrace benötigt möglicherweise die Berechtigung für Entwicklerwerkzeuge.
    • Lösung: Systemeinstellungen → Datenschutz & Sicherheit → Entwicklerwerkzeuge → Terminal/Xcode erlauben.
  • Große XML-Exporte: time-profile-Exporte sind sehr groß.
    • Lösung: mit XPath filtern und offline aggregieren; nicht im Terminal ausgeben.

iOS-spezifische Hinweise

  • Gerät: xcrun xctrace list devices und --device <UDID> verwenden.
  • Bei Bedarf über Xcode starten; mit xctrace --attach anhängen.
  • Debugsymbole für aussagekräftige Stacks sicherstellen.

Verifikations-Checkliste

  • Den Trace-Prozesspfad mit dem Ziel-Build abgleichen.
  • Sicherstellen, dass die Stacks die erwarteten App-Frames zeigen.
  • Die Aufzeichnung sollte die langsame Operation (Start/Aktualisierung) abdecken.
  • Stacks für automatisierte Differenzprüfung exportieren, wenn optimiert wird.

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.

Verwandte Skills