Profile Android game performance in Godot with Arm Performance Studio
Introduction
Profile your Godot game with Arm Performance Studio
Install the Arm Performance Studio extension in Godot
Annotate Game Events for Profiling in Godot
Define performance regions in Godot
Use channels for threaded performance annotations
Create and track custom counters in Godot
Use custom activity maps in Godot profiling
Next Steps
Profile Android game performance in Godot with Arm Performance Studio
Introduction
Profile your Godot game with Arm Performance Studio
Install the Arm Performance Studio extension in Godot
Annotate Game Events for Profiling in Godot
Define performance regions in Godot
Use channels for threaded performance annotations
Create and track custom counters in Godot
Use custom activity maps in Godot profiling
Next Steps
Review frequently asked questions
These FAQs were drafted with an approved AI-assisted workflow and reviewed by Arm contributors before publication. Human technical review remains part of the process so the final page reflects engineering rigor, accuracy, and Arm editorial standards.
The extension is compatible with Godot 4.3 and later.
Add a script that creates
PerformanceStudio.new() and call marker("Test"). If the project runs without script errors, the extension is available and your annotations can be captured.Create a PerformanceStudio instance and call
marker("Game Started") to emit a timestamped label. This label appears in the Streamline timeline for correlation with performance data.Emit a pair of markers prefixed with
Region Start <name> and Region End <name> around the code of interest. Performance Advisor shows these regions on the frame rate analysis chart and in dedicated per‑region charts.Use channels to annotate durations on specific threads, such as asset loading or enemy spawning. Channels provide labeled spans that make it easier to trace long‑running operations alongside other events.