Skip to main content
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.
  1. Open the page in Lightdash where you’re experiencing the issue
  2. Open Chrome DevTools: press F12, or Cmd + Option + I (Mac) / Ctrl + Shift + I (Windows/Linux)
  3. Click the Network tab
  4. Make sure the record button (top-left circle) is red — this means recording is active
  5. Check the Preserve log checkbox to keep requests across page navigations
  6. Click the clear button (circle with a line through it) to remove any existing logs
  7. Reproduce the issue you’re troubleshooting
  8. Right-click anywhere in the network request list and select Save all as HAR with Content
  9. 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.

​
Sending the HAR file to Lightdash support

  1. Sanitize the file using Cloudflare’s HAR sanitizer to remove sensitive headers and cookies
  2. 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)
  3. 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.