Troubleshooting

Common Issues

"Counter sampling not supported"

• Your GPU doesn't support Metal's performance counter sampling API
• Try on a different machine with a supported GPU (Apple Silicon, modern discrete GPUs)

"Missing baseline"

• Run Metal-Performance-Tracker --update-baseline first
• Ensure the Data/ directory is writable

"Performance varies between runs"

• This is normal behavior - the tool handles variance through statistical analysis
• Consider thermal throttling, background processes, and system load

"High-resolution tests fail or crash"

• Try lower resolution presets (--moderate instead of --high-res)
• Ensure adequate system memory (16GB+ recommended)
• Use external GPU if testing on MacBook with integrated graphics