When troubleshooting issues with Lightdash, our support team may ask you to provide a HAR (HTTP Archive) file. A HAR file records all network requests between your browser and Lightdash, helping us diagnose loading failures, slow queries, API errors, and other issues.
Before you start
HAR files contain sensitive data including cookies, session tokens, and the content of pages you visited during the recording. Anyone with access to a HAR file could use this information to impersonate your session.Before sharing a HAR file:
- Only record the minimum steps needed to reproduce the issue
- Do not share HAR files publicly (e.g. in GitHub issues) — send them directly to the support team
- If possible, use Cloudflare’s HAR sanitizer to strip cookies and authorization headers before sharing
Generating a HAR file
Select your browser below for step-by-step instructions.
Chrome
Firefox
Safari
Microsoft Edge
- Open the page in Lightdash where you’re experiencing the issue
- Open Chrome DevTools: press
F12, or Cmd + Option + I (Mac) / Ctrl + Shift + I (Windows/Linux)
- Click the Network tab
- Make sure the record button (top-left circle) is red — this means recording is active
- Check the Preserve log checkbox to keep requests across page navigations
- Click the clear button (circle with a line through it) to remove any existing logs
- Reproduce the issue you’re troubleshooting
- Right-click anywhere in the network request list and select Save all as HAR with Content
- Save the file to your computer
To also capture console errors: click the Console tab in DevTools, right-click in the console output, and select Save as… to download the console log.
- Open the page in Lightdash where you’re experiencing the issue
- Open Developer Tools: press
F12, or Cmd + Option + I (Mac) / Ctrl + Shift + I (Windows/Linux)
- Click the Network tab
- Reproduce the issue you’re troubleshooting
- Right-click any request in the network list and select Save All As HAR
- Save the file to your computer
To also capture console errors: click the Console tab in Developer Tools and take a screenshot of any errors shown.
- Enable the developer tools if you haven’t already: go to Safari > Settings > Advanced and check Show features for web developers
- Open the page in Lightdash where you’re experiencing the issue
- Open Web Inspector: press
Cmd + Option + I, or go to Develop > Show Web Inspector
- Click the Network tab
- Make sure Preserve Log is checked (click the filter icon in the toolbar if needed)
- Reproduce the issue you’re troubleshooting
- Click Export in the top-right of the Network tab to save the HAR file
To also capture console errors: click the Console tab in Web Inspector and take a screenshot of any errors shown.
- Open the page in Lightdash where you’re experiencing the issue
- Open Developer Tools: press
F12, or Ctrl + Shift + I
- Click the Network tab
- Make sure the record button is active (red circle)
- Check the Preserve log checkbox
- Click the clear button to remove any existing logs
- Reproduce the issue you’re troubleshooting
- Click the Export HAR button (down arrow icon) in the Network tab toolbar
- Save the file to your computer
To also capture console errors: click the Console tab in Developer Tools, right-click in the console output, and select Save as… to download the console log.
Sending the HAR file to Lightdash support
- Sanitize the file using Cloudflare’s HAR sanitizer to remove sensitive headers and cookies
- Compress the file — HAR files can be large, so zip the file before sending (right-click the file and select Compress on Mac or Send to > Compressed folder on Windows)
- Send the file to support@lightdash.com with a description of the issue, including:
- What you were trying to do
- What you expected to happen
- What actually happened
- The URL of the Lightdash page where the issue occurred
If the compressed HAR file is too large for email (over 25 MB), let the support team know and they’ll provide an alternative upload method.
