---
title: Understanding the Metal Performance HUD metrics
framework: xcode
role: article
role_heading: Article
path: xcode/understanding-metal-performance-hud-metrics
---

# Understanding the Metal Performance HUD metrics

Learn what each of the metrics reported by the heads-up display indicates.

## Overview

Overview The Metal Performance HUD provides a variety of performance metrics to help you spot performance issues, or find the perfect scope to capture in Xcode (see Capturing a Metal workload in Xcode) or in Instruments (see Analyzing the performance of your Metal app). note: To learn more about how to customize the Metal Performance HUD and enable various metrics, see Customizing the Metal Performance HUD. Below is a complete list of the Metal Performance HUD metrics: important: The metrics below require that you enable the encoder GPU time tracking feature. To learn more, see Customizing the Metal Performance HUD. important: The metrics below only appear when you use specific MetalFX effects in your app. To learn more about MetalFX, see MetalFX. important: The metrics below only appear when you evaluate your game through the Game Porting Toolkit evaluation environment. To learn more, see Game Porting Toolkit.

## See Also

### Runtime diagnostics

- [Inspecting live resources at runtime](xcode/inspecting-live-resources-at-runtime.md)
- [Validating your app’s Metal API usage](xcode/validating-your-apps-metal-api-usage.md)
- [Validating your app’s Metal shader usage](xcode/validating-your-apps-metal-shader-usage.md)
- [Monitoring your Metal app’s graphics performance](xcode/monitoring-your-metal-apps-graphics-performance.md)
- [Customizing the Metal Performance HUD](xcode/customizing-metal-performance-hud.md)
- [Gaining performance insights with the Metal Performance HUD](xcode/gaining-performance-insights-with-metal-performance-hud.md)
- [Generating performance reports with the Metal Performance HUD](xcode/generating-performance-reports-with-metal-performance-hud.md)