How-To: Collect a HAR File for Console Troubleshooting

Introduction

When you encounter an error in the Crusoe Cloud Console — such as a persistent "Internal Error" banner, a page that fails to load, or an action that silently fails — Crusoe Support may ask you to provide a HAR file. A HAR (HTTP Archive) file is a recording of all network requests your browser made while the problem was occurring. It gives Support visibility into the exact API calls, error codes, and responses that your browser received, which is often the fastest way to identify the root cause of a UI issue.

This guide walks you through capturing a HAR file in Chrome, Firefox, and Safari.

Prerequisites

• Access to the Crusoe Cloud Console at https://console.crusoecloud.com
• One of the following browsers: Google Chrome, Mozilla Firefox, or Apple Safari
• The ability to reproduce the error (or leave the console open while it is actively showing the problem)

Instructions

Google Chrome

Open Chrome DevTools

• Navigate to the Crusoe Cloud Console page where the error is occurring
• Open DevTools using one of these methods:
• Windows / Linux: Press F12 or Ctrl + Shift + I
• macOS: Press Cmd + Option + I
• Or: Right-click anywhere on the page and select Inspect

Go to the Network tab

• Click the Network tab at the top of the DevTools panel
• Make sure the red record button (circle) in the top-left of the Network panel is active (red). If it is grey, click it to start recording
• Check the Preserve log checkbox so that network activity is not cleared when the page navigates

Reproduce the error

• With the Network panel open and recording, perform the action that causes the error in the console — for example, clicking the button that triggers the "Internal Error" banner
• Wait for the error to appear, then stop — do not navigate away or refresh

Export the HAR file

• Right-click anywhere in the list of network requests in the Network panel
• Select Save all as HAR with content
• Choose a location on your computer and save the file. The file will have a .har extension

Attach the HAR file to your support ticket

• Reply to your Crusoe support ticket and attach the .har file
• Include a brief description of the steps you took to reproduce the error and the exact error message you saw

Privacy note:  HAR files can contain sensitive information including authentication tokens and session cookies. Only share them directly with Crusoe Support via your support ticket, not in public channels or forums. Crusoe Support will handle HAR files confidentially.

Mozilla Firefox

Open Firefox DevTools

• Navigate to the Crusoe Cloud Console page where the error is occurring
• Open DevTools:
• Windows / Linux: Press F12 or Ctrl + Shift + I
• macOS: Press Cmd + Option + I

Go to the Network tab

• Click the Network tab in the DevTools panel
• Confirm that the recording is active — the pause button should be visible, not a play button. If recording is paused, click the play button to resume it
• Check the Persist Logs option (click the gear icon in the Network panel to find it) to prevent logs from clearing on navigation

Reproduce the error

• Perform the action in the console that triggers the error
• Wait until the error is visible on screen before proceeding

Export the HAR file

• Right-click any request in the Network panel
• Select Save All As HAR
• Save the .har file to your computer

Attach the HAR file to your support ticket

• Reply to your Crusoe support ticket with the .har file attached
• Describe the steps that caused the error and what you observed

Apple Safari

Enable the Develop menu

• Open Safari Preferences (Cmd + comma) and go to the Advanced tab
• Check the box that says Show Develop menu in menu bar. If it is already checked, skip this step

Open the Web Inspector

• Navigate to the Crusoe Cloud Console page where the error is occurring
• From the menu bar, select Develop > Show Web Inspector, or press Cmd + Option + I
• Click the Network tab in the Web Inspector

Reproduce the error

• Make sure the Network tab is active and recording (the record button should be highlighted)
• Perform the action in the console that triggers the error and wait for it to appear

Export the HAR file

• Click the Export button (a downward arrow icon) in the top-right corner of the Network panel
• Save the .har file to your computer

Attach the HAR file to your support ticket

• Reply to your Crusoe support ticket with the .har file attached
• Include a description of what you did to trigger the error

Troubleshooting

Additional Resources

• Submit a Support Request