Troubleshooting Toolkit: Collecting a HAR file and Trace information in HubSpot

[jennysowyrda]

For the most up-to-date instructions, please check out this article: "Collect a HAR file for troubleshooting".

When it comes to websites, we all know there is more information than what is on the page level. Sometimes in order to troubleshoot a specific issue, HubSpot Support needs a deeper level of information than the error message on the screen, or a screenshot of what isn’t loading. A CDN trace, traceroute, and HAR file  can be valuable content to assist with troubleshooting complex website issues. It is important to collect all these at the same time to get the best view of what the issues might be.

How to collect CDN Trace information

CDN trace information provides data about your connection to the website. This can be collected by using the 

/cdn-cgi/trace

endpoint.

1. Enter example.com/cdn-cgi/trace from a web browser and replace example.com with the the domain name shown in the browser url bar when you use HubSpot. (for example, "app.hubspot.com/cdn-cgi/trace", "app-eu1.hubspot.com/cdn-cgi/trace", or "app-ap1.hubspot.com/cdn-cgi/trace")

2. Copy the information and add it to your Support ticket.

How to collect a Traceroute

A traceroute provides information about the network path your requests are taking over the internet. 

On Windows: Open "Command Prompt", type "tracert " followed by the domain name shown in the browser url bar when you use HubSpot. (for example, "tracert app.hubspot.com", "tracert app-eu1.hubspot.com", or "tracert app-ap1.hubspot.com")

On Mac: Open "Terminal", type "traceroute " followed by the domain name shown in the browser url bar when you use HubSpot. (for example, "traceroute app.hubspot.com", "traceroute app-eu1.hubspot.com", or "traceroute app-ap1.hubspot.com")

Collect the output and include it in the support ticket. 

How to collect a HAR file

A HAR file is a log of activity between an internet browser and a website, and can be accessed through the inspector tool within your web browser.

If you are requested to get a HAR file, please follow the steps below. These steps are specific to Google Chrome, which is available for download here.

1. Open Chrome and navigate to the page where the issue is occurring.

2. Right-click on your screen and choose “inspect”.

3. Select the “network” tab.

4. Ensure the “preserve log” and “disable cache” checkboxes are checked. (In some cases, your support representative may specifically ask you to leave "disable cache" unchecked.)

NOTE: if you are creating a screen recording of the issue, please begin recording now. This will allow the support team to align your video with the information recorded in the HAR file.

5. You will want to ensure that your network tab is recording by looking for the red record button:

If it is grey or black, click it to begin recording.

6. Clear any network traffic already collected by clicking the clear button

next to the record button.

7. Perform the action, or reload the page, that is causing the issue, with the network tab open and recording. Please pause around two seconds between any page interactions.

8. Once you have completed the action and the network tab has loaded all the content, click on the "Export HAR" icon in the network tab.

Screenshot & updated instruction courtesy of @MarcEngelmann 

9. Save the file to the desired location on your computer and then attach it to your Support ticket.

Spanish translation available here.

Portuguese translation available here.

French translation available here.

German translation available here.

Japanese translation available here.

How to collect a HAR when connecting with an OAuth integration

When connecting with an OAuth integration, such as Gmail or O365, there are additional steps needed to collect a HAR file.

1. Navigate to Settings > Integrations > Email Integrations > Connect your inbox.

2. Select Gmail or O365, depending on your email provider. A new tab will open.

3. Close original HubSpot tab.

4. Right-click on the new tab that is opened, choose “inspect”.

5. Select the “network” tab.

6. Check the “preserve log” and “disable cache” checkboxes.

7. Continue through the step of entering your Gmail or O365 information.

8. Once you have completed the action and the network tab has loaded all the content, right click within the inspector tool, and select “save as har with content”.

 9. Save the file to the desired location on your computer and then attach it to your Support ticket.

If you experience any issues gathering this information, please post your question in the Community.

[Moderator Note: this post was reviewed for relevancy and optimized for clarity on October 21, 2025. Thank you for your contributions to the HubSpot Community!]

[SSiow]

Hi all,

For Chrome users - in case you're unable to save your HAR file using the steps above, looks like Chrome has shifted the button to save your HAR file and you'll need to use the export button to do so now. 

See instructions here on this update, and see screenshot below from Chrome's documentation: 

[HelenaLatimer]

Directions for Safari

To gather a HAR file in Safari you will need access to the Developer Tools for Safari. This Apple help doc shows how to enable the Developer Tools.

1. Navigate to the page where the issue is occurring
2. Right click on the page and choose Inspect Element
3. Click the Network tab
4. Click the trash can icon to clear any existing logs in the Network tab
5. Refresh the page and reproduce the issue

Click Export HAR to save the HAR file

[HelenaLatimer]

Directions for Edge

To gather a HAR file in Edge:

1. Navigate to the page where the issue is occurring
2. Click on the menu in the top right hand corner (three dots)
3. Choose Developer Tools
4. Click the Network tab
5. Click the three bars with an X over them () to clear existing logs
6. Refresh the page and reproduce the issue

Click the save button to save the HAR file

[HelenaLatimer]

Directions for Firefox

Hi all! To gather a HAR file in Firefox:

1. Navigate to the page where the error is occurring
2. Right click on the page and click Inspect Element
3. In the panel that opens, click the Network tab
4. Ensure that the boxes for Persist Logs and Disable Cache are checked
5. Click the trash can icon on the left to remove any logs that are already visible in the Network tab
6. Refresh the page and reproduce the issue
7. Once you have reproduced the issue, you will see logs loading in the Network tab. After they have finished loading, right click on one of the requests and select Save all as HAR