[docs] creating a HAR file (#40734)

* add link

* create HAR

* formatting

* periods

* more formatting

* feedback

docs/troubleshooting-guide/create-har-file.md

+---
+title: Creating a HAR file for troubleshooting
+---
+
+# Creating a HAR file for troubleshooting
+
+HAR (short for _HTTP Archive_) files record network requests generated by your browser. HAR files can be helpful when troubleshooting issues with Metabase performance.
+
+> HAR files can contain sensitive information that you submit during the recording, like passwords and API keys. Before sharing the HAR file with anyone, review the file contents in a text editor.
+
+To create the HAR file, follow the instructions for your web browser:
+
+- [Chrome](#create-a-har-file-in-chrome)
+- [Edge](#create-a-har-file-in-edge)
+- [Firefox](#create-a-har-file-in-firefox)
+- [Safari](#create-a-har-file-in-safari)
+
+## Create a HAR file in Chrome
+
+1. Open Chrome **Developer tools**.
+   You can right-click anywhere on the page and select "Inspect".
+
+2. In Developer tools, switch to the **Network** tab.
+   The network log recording should start automatically.
+
+3. With the Network tab open and recording in progress, repeat the steps to reproduce the issue.
+
+4. Once you're finished reproducing the issue, right-click anywhere in the table of network calls and select **Save all as HAR with content**.
+
+## Create a HAR file in Edge
+
+1. Open Edge **Developer tools**. You can right-click anywhere on the page and select "Inspect".
+
+2. In Developer tools, switch to the **Network** tab (look for the Wi-Fi icon). The network log recording should start automatically.
+
+3. With the Network tab open and recording in progress, repeat the steps to reproduce the issue.
+
+4. Once you're finished reproducing the issue, right-click anywhere in the table and select **Save all as HAR with content**
+
+## Create a HAR file in Firefox
+
+1. Open Firefox **Developer tools**. You can right-click anywhere on the page and select "Inspect".
+
+2. In Developer tools, switch to the **Network** tab.
+
+3. With the Network tab open and recording in progress, repeat the steps to reproduce the issue.
+
+4. Once you're finished reproducing the issue, right-click anywhere in the table of network calls and select **Save All As HAR**.
+
+## Create a HAR file in Safari
+
+1. If you haven't yet, enable the **Develop** menu by going to **Safari > Settings > Advanced**, and select **Show features for web developers**.
+
+2. Open the Safari developer tools by going to **Develop > Show Web Inspector**.
+
+3. In Developer tools, switch to the **Network** tab. The network log recording should start automatically.
+
+4. With the Network tab open and recording in progress, repeat the steps to reproduce the issue.
+
+5. Once you're finished reproducing the issue, click on **Export** in the top right of the Network tab.

docs/troubleshooting-guide/index.md

@@ -76,6 +76,8 @@ Metabase will log errors, both on the server and in the browser console, dependi
 - [Safari][safari]
 - [Edge][edge]
 
+**Creating a HAR file**: HAR files record network requests generated by your browser. HAR files can be helpful when troubleshooting issues with Metabase performance. Check out [Creating HAR files for troubleshooting](./create-har-file.md).
+
 ## Metabase tutorials
 
 For tutorials that walk you through how to use Metabase features, check out [Learn Metabase][learn].
@@ -86,7 +88,7 @@ To see if someone else has run into a similar issue, check out [our forum on Dis
 
 ## Upgrading Metabase
 
-Metabase adds new features and squashes bugs with each release. [Upgrading to the latest and greatest][upgrade] may resolve your issue. If you're using [Metabase Cloud][cloud], we'll handle the upgrades for you. You can checkout the [release notes][releases] to see what's new.
+Metabase adds new features and squashes bugs with each release. [Upgrading to the latest and greatest][upgrade] may resolve your issue. If you're using [Metabase Cloud][cloud], we'll handle the upgrades for you. To see what's new, check out the [release notes][releases].
 
 [appdb]: ./loading-from-h2.md
 [bugs]: ./bugs.md