Identify and optimize code hotspots using the Arm Performix MCP server
Introduction
Understand AI-driven profiling with the Arm Performix MCP server
Build the Mandelbrot example on Arm Neoverse
Run Code Hotspots with an AI agent
Optimize code with AI-driven profiling feedback
Next Steps
Identify and optimize code hotspots using the Arm Performix MCP server
Who is this for?
This is an advanced topic for developers who want to use AI-powered tools to automate performance profiling and optimization of C++ applications on Arm Neoverse servers.
What will you learn?
Upon completion of this Learning Path, you will be able to:
- Describe how the dedicated Arm Performix MCP server enables AI-driven profiling workflows
- Run the Code Hotspots recipe on a configured remote Arm target through an AI agent
- Use an AI agent to interpret profile evidence and identify the hottest functions in a C++ application
- Apply AI-suggested optimizations to reduce application runtime on Arm Neoverse
Prerequisites
Before starting, you will need the following:
- Completion of the Generate Arm Performix AI insights in Visual Studio Code with Codex Learning Path, or equivalent familiarity with configuring the Arm Performix MCP server in an AI coding assistant
- Access to an Arm-based cloud instance running Linux, such as an AWS Graviton3 instance
- Access to Arm Performix configured with the remote Arm target. See the Arm Performix install guide for setup instructions
- Basic understanding of C++
Summary
This summary was 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.
You’ll combine the dedicated Arm Performix MCP server with an AI agent to run the complete Code Hotspots workflow on an Arm Neoverse target. First, you’ll build an intentionally unoptimized Mandelbrot C++ application on a remote Arm Linux target, then use an AI agent to run the Performix Code Hotspots recipe. The agent confirms the configured target, executes collection, and returns a run ID. You’ll use that run ID to generate AI insights with structured hotspot data to pinpoint the hottest functions. Guided by the agent, you’ll apply concrete code changes, such as math simplifications and enabling a higher optimization level, through your source and build environment. Then, you’ll re-run the recipe to compare results. The end-to-end flow keeps profiling, interpretation, and edits within a single AI-assisted loop.
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.
Follow the
Generate Arm Performix AI insights in Visual Studio Code with Codex
Learning Path to start the installed
apx executable with the mcp start arguments and verify that your AI coding assistant can list Performix recipes and configured targets.Expect a completed run status and a run ID. Use that run ID to request an AI insight with a hotspot summary that highlights the hottest functions in the Mandelbrot application. Use this output to guide which code changes to apply first.
No. The single-threaded, unoptimized build is intentional so the hotspot analysis produces a clear signal. The agent later proposes enabling
-O3 as part of the optimization pass.The agent explicitly confirms your configured Performix target name and workload before running the Code Hotspots recipe. Review this confirmation and proceed only if it matches your intended Arm target.
Confirm that Arm Performix is configured with your remote Arm target and that the target connection succeeds. Also verify that the Mandelbrot application builds on the target system. You can test the connection with
apx target test --target <target-name>.