as

Settings
Sign out
Notifications
Alexa
Amazon Appstore
AWS
Documentation
Support
Contact Us
My Cases
Get Started
Design and Develop
Publish
Reference
Support

Manage Files, Crash Reports, and Logs

Vega Studio, an extension in the Visual Studio Code (VS Code), enhances app debugging by providing comprehensive management of device files, crash reports, and logs. Through Vega Studio, you can monitor app behavior, investigate crashes, and analyze system logs from a centralized location. These debugging capabilities help you identify issues and verify how your app behaves during development.

Prerequisites

Before you begin, complete these steps:

  1. Open your app project in VS Code.
  2. Connect your device through USB or network.

  3. Your device appears in Vega Studio's device list.

Manage crash reports

Use the Device Files view in the Explorer sidebar to manage crash reports. This view automatically detects and displays crash reports from your connected devices.

Screenshot of VS Code Explorer sidebar showing Device Files view with connected devices and crash reports listed in a tree structure
Device Files view

Open and symbolicate crash reports

  1. Click the corresponding item from the list to open crash reports.
  2. Right-click and select Symbolicate ACR to convert crash reports into readable format.

Screenshot of right-click context menu in Device Files view showing Symbolicate ACR option highlighted
Symbolicate ACR context menu

Filter crash reports

Click the funnel icon next to Crash Reports to display the Filter Crash Reports user interface.

Screenshot of crash reports list with funnel filter icon highlighted next to Crash Reports heading
Crash reports filter icon

You can filter by name or using regular expressions.

Screenshot of Filter Crash Reports dialog box with fields for name, date range, and regular expression filtering options
Filter Crash Reports

Configure automatic crash detection

Vega Studio automatically detects new crash reports and shows notifications. You can customize this behavior:

Screenshot of automatic crash detection notification popup with options to view crash report or dismiss
Automatic crash detection notification

To disable notifications or configure filters, go to Vega Studio extension settings (Kepler > Features > Acr Notifications).

Screenshot of VS Code settings page showing Kepler extension ACR Notifications configuration options
ACR notification settings

View live logs

Use the live log streaming for real-time debugging during active development. The Show Logs button in the VS Code status bar is the recommended method.

  1. Run your app in VS Code.
  2. Click Show Logs in the status bar.

    Screenshot of VS Code status bar with Show Logs button highlighted in blue
    Show Logs button in status bar
  3. Choose your device: Vega Virtual Device or Fire TV Stick.

    If you use a Fire TV Stick, connect it through USB. If you have multiple projects, select the target project when prompted.

    Logs stream to the App Logs channel while your app runs. For idle apps, check the Output channel.

    Screenshot of VS Code Output panel showing App Logs channel with streaming log messages from connected device
    App Logs output channel
  4. Click Stop Logs in the status bar to end streaming.

    Screenshot of VS Code status bar with Stop Logs button highlighted, showing active log streaming session
    Stop Logs button

Configure log streaming settings

Adjust log streaming behavior in Vega Studio extension settings, including log facilities, format, and level. You must stop and restart log streaming for changes to take effect. See Manage System Logs for advanced configuration.

Screenshot of VS Code settings showing Kepler extension device logs configuration with facility, format, and level options
Device logs settings

Copy device logs

Copy logs to analyze historical data, share logs with team members, or investigate issues. Use one of these options:

Option 1: Device Files view (Recommended)

Right-click your device in the Device Files view and select Copy logs. The system saves logs to <projectDir>/logs/<deviceName>/<logKind>/var_log/

Screenshot of right-click context menu on device in Device Files view with Copy logs option highlighted
Copy logs context menu

Option 2: Command palette

  1. Click the K icon in VS Code activity bar.
  2. Go to Devices section and choose your device, or enter Kepler Device Management: copy logs from device in the command palette.
  3. Select the logs you want to copy from the list.

    Screenshot of log collection dialog showing checkboxes for different log types like system, application, and crash logs
    Log collection
  4. Check the Output channel for completion status and file paths.

    Screenshot of VS Code Output panel showing completion status and file paths for copied device logs
    Log copy completion status

View console logs

Use console logs for React Native debugging to view your console.log() statements in real-time. These logs appear in VS Code's Output window under the React Native channel.

  1. Press Shift + Cmd + P (Mac) or Shift + Ctrl + P (Linux) to open the Command Palette.
  2. Enter Output: Show Output Channels….
  3. Select React Native to view your app's console logs.

Once your app runs, any console.log statements appear in this channel in real-time.


Last updated: Sep 30, 2025