Skip to content

Commit 4a11931

Browse files
Merge pull request #228380 from JnHs/jh-portal-btrefe
separate and update Edge and Chrome
2 parents 35335f4 + 0b21dc8 commit 4a11931

8 files changed

+75
-27
lines changed

articles/azure-portal/capture-browser-trace.md

Lines changed: 75 additions & 27 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
title: Capture a browser trace for troubleshooting
33
description: Capture network information from a browser trace to help troubleshoot issues with the Azure portal.
4-
ms.date: 09/01/2022
4+
ms.date: 02/24/2023
55
ms.topic: how-to
66
---
77

@@ -12,11 +12,11 @@ If you're troubleshooting an issue with the Azure portal, and you need to contac
1212
> [!IMPORTANT]
1313
> Microsoft support uses these traces for troubleshooting purposes only. Please be mindful who you share your traces with, as they may contain sensitive information about your environment.
1414
15-
You can capture this information any [supported browser](azure-portal-supported-browsers-devices.md): Google Chrome, Microsoft Edge, Safari (on Mac), or Firefox. Steps for each browser are shown below.
15+
You can capture this information any [supported browser](azure-portal-supported-browsers-devices.md): Microsoft Edge, Google Chrome, Safari (on Mac), or Firefox. Steps for each browser are shown below.
1616

17-
## Google Chrome and Microsoft Edge
17+
## Microsoft Edge
1818

19-
Google Chrome and Microsoft Edge are both based on the [Chromium open source project](https://www.chromium.org/Home). The developer tools experience is very similar in the two browsers. The screenshots included here show the Google Chrome experience, but you'll see the same options in Microsoft Edge. For more information, see [Chrome DevTools](https://developers.google.com/web/tools/chrome-devtools) and [Microsoft Edge DevTools](/microsoft-edge/devtools-guide-chromium).
19+
The following steps show how to use the developer tools in Microsoft Edge. For more information, see [Microsoft Edge DevTools](/microsoft-edge/devtools-guide-chromium).
2020

2121
1. Sign in to the [Azure portal](https://portal.azure.com). It's important to sign in _before_ you start the trace so that the trace doesn't contain sensitive information related to your account.
2222

@@ -28,35 +28,83 @@ Google Chrome and Microsoft Edge are both based on the [Chromium open source pro
2828

2929
1. By default, the browser keeps trace information only for the page that's currently loaded. Set the following options so the browser keeps all trace information, even if your repro steps require going to more than one page:
3030

31+
1. Select the **Console** tab, select **Console settings**, then select **Preserve Log**.
32+
33+
:::image type="content" source="media/capture-browser-trace/edge-console-preserve-log.png" alt-text="Screenshot that highlights the Preserve log option on the Console tab in Edge.":::
34+
3135
1. Select the **Network** tab, then select **Preserve log**.
3236

33-
![Screenshot that highlights the Preserve log option on the Network tab.](media/capture-browser-trace/chromium-network-preserve-log.png)
37+
:::image type="content" source="media/capture-browser-trace/edge-network-preserve-log.png" alt-text="Screenshot that highlights the Preserve log option on the Network tab in Edge.":::
3438

35-
1. Select the **Console** tab, select **Console settings**, then select **Preserve Log**.
39+
1. On the **Network** tab, select **Stop recording network log** and **Clear**.
40+
41+
:::image type="content" source="media/capture-browser-trace/edge-stop-clear-session.png" alt-text="Screenshot showing the Stop recording network log and Clear options on the Network tab in Edge.":::
42+
43+
1. Select **Record network log**, then reproduce the issue in the portal.
3644

37-
![Screenshot that highlights the Preserve log option on the Console tab.](media/capture-browser-trace/chromium-console-preserve-log.png)
45+
:::image type="content" source="media/capture-browser-trace/edge-start-session.png" alt-text="Screenshot showing how to record the network log in Edge.":::
3846

39-
1. Select the **Network** tab, then select **Stop recording network log** and **Clear**.
47+
You'll see session output similar to the following image.
48+
49+
:::image type="content" source="media/capture-browser-trace/edge-browser-trace-results.png" alt-text="Screenshot showing session output in Edge.":::
50+
51+
1. After you have reproduced the unexpected portal behavior, select **Stop recording network log**, then select **Export HAR** and save the file.
52+
53+
:::image type="content" source="media/capture-browser-trace/edge-network-export-har.png" alt-text="Screenshot showing how to Export HAR on the Network tab in Edge.":::
54+
55+
1. Stop the Steps Recorder and save the recording.
4056

41-
![Screenshot of "Stop recording network log" and "Clear" on the Network tab.](media/capture-browser-trace/chromium-stop-clear-session.png)
57+
1. Back in the browser developer tools pane, select the **Console** tab. Right-click one of the messages, then select **Save as...**, and save the console output to a text file.
58+
59+
:::image type="content" source="media/capture-browser-trace/edge-console-select.png" alt-text="Sccreenshot showing how to save the console output in Edge.":::
60+
61+
1. Package the browser trace HAR file, console output, and screen recording files in a compressed format such as .zip.
62+
63+
1. Share the compressed file with Microsoft support by [using the **File upload** option in your support request](supportability/how-to-manage-azure-support-request.md#upload-files).
64+
65+
## Google Chrome
66+
67+
The following steps show how to use the developer tools in Google Chrome. For more information, see [Chrome DevTools](https://developers.google.com/web/tools/chrome-devtools).
68+
69+
1. Sign in to the [Azure portal](https://portal.azure.com). It's important to sign in _before_ you start the trace so that the trace doesn't contain sensitive information related to your account.
70+
71+
1. Start recording the steps you take in the portal, using [Steps Recorder](https://support.microsoft.com/windows/record-steps-to-reproduce-a-problem-46582a9b-620f-2e36-00c9-04e25d784e47).
72+
73+
1. In the portal, navigate to the step prior to where the issue occurs.
74+
75+
1. Press F12 to launch the developer tools. You can also launch the tools from the toolbar menu under **More tools** > **Developer tools**.
76+
77+
1. By default, the browser keeps trace information only for the page that's currently loaded. Set the following options so the browser keeps all trace information, even if your repro steps require going to more than one page:
78+
79+
1. Select the **Console** tab, select **Console settings**, then select **Preserve Log**.
80+
81+
![Screenshot that highlights the Preserve log option on the Console tab in Chrome.](media/capture-browser-trace/chromium-console-preserve-log.png)
82+
83+
1. Select the **Network** tab, then select **Preserve log**.
84+
85+
![Screenshot that highlights the Preserve log option on the Network tab in Chrome.](media/capture-browser-trace/chromium-network-preserve-log.png)
86+
87+
1. On the **Network** tab, select **Stop recording network log** and **Clear**.
88+
89+
![Screenshot of "Stop recording network log" and "Clear" on the Network tab in Chrome.](media/capture-browser-trace/chromium-stop-clear-session.png)
4290

4391
1. Select **Record network log**, then reproduce the issue in the portal.
4492

45-
![Screenshot that shows how to record the network log.](media/capture-browser-trace/chromium-start-session.png)
93+
![Screenshot that shows how to record the network log in Chrome.](media/capture-browser-trace/chromium-start-session.png)
4694

47-
You will see session output similar to the following image.
95+
You'll see session output similar to the following image.
4896

49-
![Screenshot that shows the session output.](media/capture-browser-trace/chromium-browser-trace-results.png)
97+
![Screenshot that shows the session output in Chrome.](media/capture-browser-trace/chromium-browser-trace-results.png)
5098

5199
1. After you have reproduced the unexpected portal behavior, select **Stop recording network log**, then select **Export HAR** and save the file.
52100

53-
![Screenshot that shows how to Export HAR on the Network tab.](media/capture-browser-trace/chromium-network-export-har.png)
101+
![Screenshot that shows how to Export HAR on the Network tab in Chrome.](media/capture-browser-trace/chromium-network-export-har.png)
54102

55103
1. Stop the Steps Recorder and save the recording.
56104

57105
1. Back in the browser developer tools pane, select the **Console** tab. Right-click one of the messages, then select **Save as...**, and save the console output to a text file.
58106

59-
![Screenshot that shows how to save the console output.](media/capture-browser-trace/chromium-console-select.png)
107+
![Screenshot that shows how to save the console output in Chrome.](media/capture-browser-trace/chromium-console-select.png)
60108

61109
1. Package the browser trace HAR file, console output, and screen recording files in a compressed format such as .zip.
62110

@@ -82,23 +130,23 @@ The following steps show how to use the developer tools in Apple Safari on Mac.
82130

83131
1. Select **Develop**, then select **Show Web Inspector**.
84132

85-
![Screenshot of the "Show Web Inspector" command.](media/capture-browser-trace/safari-show-web-inspector.png)
133+
![Screenshot of the "Show Web Inspector" command.](media/capture-browser-trace/safari-show-web-inspector.png)
86134

87135
1. By default, the browser keeps trace information only for the page that's currently loaded. Set the following options so the browser keeps all trace information, even if your repro steps require going to more than one page:
88136

89-
1. Select the **Network** tab, then select **Preserve Log**.
137+
1. Select the **Console** tab, then select **Preserve Log**.
90138

91-
![Screenshot that shows the Preserve Log option on the Network tab.](media/capture-browser-trace/safari-network-preserve-log.png)
139+
![Screenshot that shows the Preserve Log on the Console tab.](media/capture-browser-trace/safari-console-preserve-log.png)
92140

93-
1. Select the **Console** tab, then select **Preserve Log**.
141+
1. Select the **Network** tab, then select **Preserve Log**.
94142

95-
![Screenshot that shows the Preserve Log on the Console tab.](media/capture-browser-trace/safari-console-preserve-log.png)
143+
![Screenshot that shows the Preserve Log option on the Network tab.](media/capture-browser-trace/safari-network-preserve-log.png)
96144

97-
1. Select the **Network** tab, then select **Clear Network Items**.
145+
1. On the **Network** tab, select **Clear Network Items**.
98146

99147
![Screenshot of "Clear Network Items" on the Network tab.](media/capture-browser-trace/safari-clear-session.png)
100148

101-
1. Reproduce the issue in the portal. You will see session output similar to the following image.
149+
1. Reproduce the issue in the portal. You'll see session output similar to the following image.
102150

103151
![Screenshot that shows the output after you've reproduced the issue.](media/capture-browser-trace/safari-browser-trace-results.png)
104152

@@ -130,19 +178,19 @@ The following steps show how to use the developer tools in Firefox. For more inf
130178

131179
1. By default, the browser keeps trace information only for the page that's currently loaded. Set the following options so the browser keeps all trace information, even if your repro steps require going to more than one page:
132180

133-
1. Select the **Network** tab, select the **Settings** icon, and then select **Persist Logs**.
134-
135-
:::image type="content" source="media/capture-browser-trace/firefox-network-persist-logs.png" alt-text="Screenshot of the Network setting for Persist Logs.":::
136-
137181
1. Select the **Console** tab, select the **Settings** icon, and then select **Persist Logs**.
138182

139183
:::image type="content" source="media/capture-browser-trace/firefox-console-persist-logs.png" alt-text="Screenshot of the Console setting for Persist Logs.":::
140184

141-
1. Select the **Network** tab, then select **Clear**.
185+
1. Select the **Network** tab, select the **Settings** icon, and then select **Persist Logs**.
186+
187+
:::image type="content" source="media/capture-browser-trace/firefox-network-persist-logs.png" alt-text="Screenshot of the Network setting for Persist Logs.":::
188+
189+
1. On the **Network** tab, select **Clear**.
142190

143191
![Screenshot of the "Clear" option on the Network tab.](media/capture-browser-trace/firefox-clear-session.png)
144192

145-
1. Reproduce the issue in the portal. You will see session output similar to the following image.
193+
1. Reproduce the issue in the portal. You'll see session output similar to the following image.
146194

147195
![Screenshot showing example browser trace results.](media/capture-browser-trace/firefox-browser-trace-results.png)
148196

50.8 KB
Loading
24.4 KB
Loading
132 KB
Loading
4.29 KB
Loading
26.9 KB
Loading
2.88 KB
Loading
3.01 KB
Loading

0 commit comments

Comments
 (0)