Check frames, memory, or native profiles
perfCollect frame health, memory diagnostics, and CPU profiling artifacts from devices with compact agent-readable summaries. Start and stop capture raw profiles; report returns readable native CPU evidence.
Instructions
Collect frame health, memory diagnostics, and platform profiling artifacts with compact agent-readable summaries. For CPU profiles, start and stop write the raw artifact while report writes a compact summary for readable native CPU evidence. Profiling output is evidence only: compact state, artifact path, and size. Times out after 90s.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"area": "<area>"
},
"name": "perf"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| out | No | Output artifact path. | |
| area | Yes | ||
| kind | No | ||
| udid | No | Apple device or simulator UDID. | |
| action | No | ||
| device | No | Device name; ids go in udid or serial. | |
| serial | No | Android, HarmonyOS, or Vega VVD serial. | |
| session | No | Session name. | |
| subject | No | ||
| noRecord | No | Do not record this action. | |
| platform | No | Device platform. | |
| template | No | xctrace template name, for example Time Profiler. | |
| tracePath | No | Existing .trace path to report, defaults to the latest session trace. | |
| deviceTarget | No | Device form factor. |