Analyze allocations from a .trace bundle
analyzeAllocationsParse Allocations .trace files to obtain per-category memory aggregates, top allocators by size and count, and a one-liner diagnosis of the dominant allocator.
Instructions
[mg.trace] Parse the allocations schema from a .trace recorded with the Allocations Instruments template. Returns per-category aggregates (cumulative bytes, allocation count, lifecycle = transient/persistent/mixed), top allocators by size and by count, and a one-liner diagnosis identifying the dominant allocator.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| tracePath | Yes | Absolute path to a `.trace` bundle recorded with the Allocations template (`xcrun xctrace record --template Allocations --attach <app|pid>`). | |
| topN | No | Return the top N allocators by aggregated size (default 15). | |
| minBytes | No | Filter out individual allocations smaller than this size in bytes (default 0). Use 1024 to focus on >1KB allocations. | |
| outputFormat | No | Response format. Omitted or `json` (default, preserves v1.8 behavior) returns JSON.stringify of the result. `markdown` renders a human-readable view of the same data. `both` returns both content items in one response, so a client can display markdown to the user and parse JSON for the agent loop without a second call. `verify-fix-table` (v1.10, applies to `analyzeAbandonedMemory` and `diffMemgraphs`) emits a focused 4-column markdown comparison table (Class | Before | After | Delta) of the actionable rows; other tools fall back to `markdown` for this value. |