How to Generate a HAR File to Diagnose Playback Issues

HAR files are an archive of the browser's network output when the issue happened. It helps identify header issues, network problems, URI problems, protocol issues (HTTP/HTTPS), HLS/Dash segment sizes, download times, and many others. The best browser to use for generating a HAR file is Chrome/Chromium or Firefox as they both have the best tools to identify issues.

It's also important to remember that to have the data captured you must first open the browser console, then refresh the page and reproduce the issue while it is open. There are calls before video segments that may be telling as to what happened. The capture process is extensively documented so you can refer to the below if needed. 

Chrome

  1. Open your webpage containing the Player code in Chrome.
  2. Click the Chrome menu ( ) in the top-right of the browser window, and select More Tools, then Developer Tools.
  3. Click the Network tab, and select Preserve log.  A red circle on the left of the Developer Tools panel indicates that Chrome is capturing network requests. 
  4. Refresh the page, and perform steps to reproduce the issue with the Player.
  5. When you're done, click the red circle to stop capturing requests.
  6. Right-click within the list of network requests and select Save as HAR with Content.
  7. Save the HAR file.
  8. Click the Console tab, expand the panel so that you can see most of its contents, then take a screenshot.
  9. Upload the HAR file and console screenshot to your support ticket.

Safari

Note: If you don't have the Safari Develop menu enabled, see Use the developer tools in the Develop menu in Safari on Mac to set it up.
  1. Open your webpage containing the Player code in Safari.
  2. In the Safari navigation menu, click Develop and select Show Web Inspector.
  3. Click the Network tab. 
  4. Perform the steps to reproduce the issue with the Player.
  5. When you're done, click the Download Web Archive icon (down arrow).
  6. Save the HAR file.
  7. Click the Console tab, expand the panel so that you can see most of its contents, then take a screenshot.
  8. Upload the HAR file and console screenshot to your support ticket.

Firefox

  1. Open your webpage containing the Player code in Firefox.
  2. Click the Firefox menu ( ), click Web Developer, and select Network.
  3. Click the Network tab, and select Persist Logs
  4. Refresh the page, and perform steps to reproduce the issue with the Player.
  5. When you're done, right-click within the list of network requests, and select Save All As HAR.
  6. Save the HAR file.
  7. Click the Console tab, expand the panel so that you can see most of its contents, then take a screenshot.
  8. Upload the HAR file and console screenshot to your support ticket.

Microsoft Edge

  1. Open your webpage containing the Player code in Microsoft Edge.
  2. Click the Edge menu ( ), click More Tools, click Developer Tools, and select the Network tab.
  3. Clear the Clear entries on navigate option (blue arrow with red X).
  4. Ensure that the Start Profiling Session button is enabled.
  5. Refresh the page, and perform steps to reproduce the issue with the Player.
  6. When you're done, click the Export as HAR icon ( ).
  7. Save the HAR file.
  8. Click the Console tab, expand the panel so that you can see most of its contents, then take a screenshot.
  9. Upload the HAR file and console screenshot to your support ticket.