Debug Your App

Open Beta Documentation Amazon offers this technical documentation as part of a pre-release, open beta. The features described might change as Amazon receives feedback and iterates on the features. For the most current feature information, see the Release Notes.

This section provides instructions on how to debug your Vega apps using various tools and techniques.

Each of these guides provides detailed steps and explanations to help you effectively debug your Vega apps. Whether you're dealing with crashes, need line-by-line debugging capabilities, or want to use in-app developer tools, these resources assist you in identifying and resolving issues in your apps.

Crash analysis and debugging

Debug App Crash Using Vega Studio

Learn how to collect and analyze aggregated crash reports (ACRs) for your app running on your targeted device or simulator. This guide covers:

Copying an ACR
Symbolicating an ACR
Troubleshooting common issues during the process

Detect Where the App Crash Originates

Determine whether a crash in your app originates from your code or Amazon's code.

Line-by-line debugging

Perform Line-by-Line Debugging with Vega Studio

Discover how to use Vega Studio for detailed debugging of your applications. This guide includes:

Setting up debugging for Turbo Modules
Configuring the debugger (automatic and manual methods)
Setting breakpoints
Running the app in debug mode
Using the debug toolbar
Targeting a Fire TV Stick for debugging

In-app developer tools

Explore the in-app developer menu that provides access to various debugging tools. This guide covers:

Setting up port forwarding
Starting the Metro bundler
Launching your app for debugging
Using the developer menu options (Element Inspector, Performance Monitor, etc.)
Troubleshooting app debugging issues

Logs

View and Copy Logs

Learn how to view logs messages in Vega Studio.

Manage System Logs

Use the Logging Control CLI (LoggingCtl) to manage, view, and test logging data.

Last updated: Sep 30, 2025