Skip to content

Commit 0a170c4

Browse files
WalshyDevOxyjun
authored andcommitted
[Support] Updated instructions to export HAR with recent updates to Chrome (#18440)
* Replace special chars with real spaces * Update instructions to export * Apply suggestions from code review Co-authored-by: Jun Lee <[email protected]> --------- Co-authored-by: Jun Lee <[email protected]>
1 parent c69fa0b commit 0a170c4

File tree

2 files changed

+54
-48
lines changed

2 files changed

+54
-48
lines changed
74.8 KB
Loading

src/content/docs/support/troubleshooting/general-troubleshooting/gathering-information-for-troubleshooting-sites.mdx

Lines changed: 54 additions & 48 deletions
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@ title: Gathering information for troubleshooting sites
66

77
## Overview
88

9-
It is important to capture as much information as possible to diagnose an issue and to [provide adequate details to Cloudflare support](/support/contacting-cloudflare-support/). This article explains how to gather troubleshooting information commonly requested by Cloudflare Support.
9+
It is important to capture as much information as possible to diagnose an issue and to [provide adequate details to Cloudflare support](/support/contacting-cloudflare-support/). This article explains how to gather troubleshooting information commonly requested by Cloudflare Support.
1010

1111
:::note
1212

@@ -33,49 +33,55 @@ Some browsers either require a browser extension or cannot generate a HAR. When
3333

3434
### In Chrome
3535

36-
1. In a browser page viewed in Incognito Mode, right-click anywhere and select **Inspect Element**.
36+
1. In a browser page viewed in Incognito Mode, right-click anywhere and select **Inspect Element**.
3737

38-
2. The developer tools either appear at the bottom or left side of the browser. Click the **Network** tab.
38+
2. The Chrome DevTools appear either at the bottom, or left side of the browser. Click the **Network** tab.
3939

4040
![HAR network tab screenshot from Chrome developer tools](~/assets/images/support/gathering_har_file_network.png)
4141

42-
3. Check **Preserve log**. Please also check ***Disable cache*** if you are reporting a Cloudflare Cache issue.
42+
3. Check **Preserve log**. Please also check **Disable cache** if you are reporting a Cloudflare Cache issue.
4343

4444
4. Click record.
4545

4646
![HAR record button in chrome dev tools.](~/assets/images/support/gathering_har_file_record.png)
4747

48-
5. Browse to the URL that causes issues. Once the issue is experienced, right click on any of the items within the **Network** tab and select **Save all as HAR with Content**.
48+
5. Browse to the URL that causes issues. Once the issue is experienced, click the "Export HAR" option at the top of DevTools.
4949

50-
![HAR save menu in Chrome developer tools.](~/assets/images/support/gathering_har_file_save.png)
50+
![`export HAR` option in Chrome DevTools](~/assets/images/support/export_har_chrome.png).
5151

5252
6. Attach the HAR file to your support ticket.
5353

54+
:::note
55+
56+
As of Chrome 130, this exports a sanitized HAR with redacted cookies and personalised data. To disable this, go to DevTools **Settings** > **Preferences** > **Network** > **Allow to generate HAR with sensitive data**.
57+
58+
:::
59+
5460
### In Firefox
5561

56-
1. While using a Private Window, use the application menu and select **Tools** > **Web Developer** > **Network** or press *Ctrl+Shift+I* (Windows/Linux) or *Cmd+Option+I* (OS X).
62+
1. While using a Private Window, use the application menu and select **Tools** > **Web Developer** > **Network** or press _Ctrl+Shift+I_ (Windows/Linux) or _Cmd+Option+I_ (OS X).
5763

5864
2. Browse to the URL that causes issues.
5965

60-
3. After duplicating the issue, right-click and choose **Save All As HAR**.
66+
3. After duplicating the issue, right-click and choose **Save All As HAR**.
6167

6268
### In Microsoft Edge
6369

64-
1. In a Private window, navigate to **Developer tools** (use *F12* as a shortcut) and select the **Network** tab.
70+
1. In a Private window, navigate to **Developer tools** (use `F12` as a shortcut) and select the **Network** tab.
6571

6672
2. Browse to the URL that causes issues.
6773

68-
3. After duplicating the issue, click on **Export as HAR** followed by **Save As...**.
74+
3. After duplicating the issue, click on **Export as HAR** followed by **Save As...**.
6975

7076
### In Safari
7177

72-
1. In Safari, ensure a **Develop** menu appears at the top of a Private Window in the browser window. Otherwise, go to **Safari** > **Preferences** > **Advanced** and select **Show Develop Menu in menu bar**
78+
1. In Safari, ensure a **Develop** menu appears at the top of a Private Window in the browser window. Otherwise, go to **Safari** > **Preferences** > **Advanced** and select **Show Develop Menu in menu bar**
7379

74-
2. Navigate to **Develop** > **Show Web Inspector**.
80+
2. Navigate to **Develop** > **Show Web Inspector**.
7581

7682
3. Browse to the URL that causes issues.
7783

78-
4. Ctrl + click on a resource within Web Inspector and click **Export HAR**.
84+
4. Ctrl + click on a resource within Web Inspector and click **Export HAR**.
7985

8086
### In Mobile
8187

@@ -93,7 +99,7 @@ Some browsers either require a browser extension or cannot generate a HAR. When
9399

94100
5. Select the **Network** tab in the DevTools window.
95101

96-
6. Check **Preserve log**. Please also check ***Disable cache*** if you are reporting a Cloudflare Cache issue.
102+
6. Check **Preserve log**. Please also check **_Disable cache_** if you are reporting a Cloudflare Cache issue.
97103

98104
7. Click **record**.
99105

@@ -103,7 +109,7 @@ Some browsers either require a browser extension or cannot generate a HAR. When
103109

104110
![How to save HAR content. ](~/assets/images/support/step_3.png)
105111

106-
9. Attach the HAR file to your support ticket alongside a screen recording from the affected Samsung device. Instructions on how to do this from Samsung devices can be found in [Samsung's documentation here](https://www.samsung.com/au/support/mobile-devices/screen-recorder/).
112+
9. Attach the HAR file to your support ticket alongside a screen recording from the affected Samsung device. Instructions on how to do this from Samsung devices can be found in [Samsung's documentation here](https://www.samsung.com/au/support/mobile-devices/screen-recorder/).
107113

108114
---
109115

@@ -119,36 +125,36 @@ In certain situations when request is not issued or cancelled by the browser (fo
119125

120126
### In Chrome
121127

122-
1. Go to the **Console** tab from the Developer Tools bar.
123-
2. Go to the Console Settings and select **Preserve Log**.
128+
1. Go to the **Console** tab from the DevTools bar.
129+
2. Go to the Console Settings and select **Preserve Log**.
124130
3. Leave the console open and perform the steps that reproduce the issue.
125-
4. Right click on any of the items within the **Console** tab and select **Save as** log file.
131+
4. Right-click on any of the items within the **Console** tab and select **Save as** log file.
126132
5. Attach the log file to your support ticket.
127133

128134
![How to find the console tab in Chrome's developer tools.](~/assets/images/support/console_snapshot.png)
129135

130136
### In Firefox
131137

132-
1. Go to the **Console** tab from the Web Developer Tools bar.
133-
2. Go to the Console Settings and select **Persist Log** and **Show Timestamps**.
138+
1. Go to the **Console** tab from the Web Developer Tools bar.
139+
2. Go to the Console Settings and select **Persist Log** and **Show Timestamps**.
134140
3. Leave the console open and perform the steps that reproduce the issue.
135-
4. Right click, **Select All** messages and **Export Visible Messages to File**.
141+
4. Right click, **Select All** messages and **Export Visible Messages to File**.
136142
5. Attach the log file to your support ticket.
137143

138144
### In Microsoft Edge
139145

140-
1. Go to the **Console** tab from the Developer Tools bar.
141-
2. Go to the Console Settings and select **Preserve Log**.
146+
1. Go to the **Console** tab from the Developer Tools bar.
147+
2. Go to the Console Settings and select **Preserve Log**.
142148
3. Leave the console open and perform the steps that reproduce the issue.
143-
4. Right click on any of the items within the **Console** tab and select **Save as** log file.
149+
4. Right click on any of the items within the **Console** tab and select **Save as** log file.
144150
5. Attach the log file to your support ticket.
145151

146152
### In Safari
147153

148-
1. Go to the **Console** tab from the Web Inspector bar.
149-
2. Tick the box **Preserve Log**.
154+
1. Go to the **Console** tab from the Web Inspector bar.
155+
2. Tick the box **Preserve Log**.
150156
3. Leave the console open and perform the steps that reproduce the issue.
151-
4. Select all the messages, right click and **Save Selected** to a log file.
157+
4. Select all the messages, right click and **Save Selected** to a log file.
152158
5. Attach the log file to your support ticket.
153159

154160
---
@@ -178,12 +184,12 @@ You can only generate a NetLog dump on the Google Chrome, Opera or Microsoft Edg
178184

179185
## Identify the Cloudflare data center serving your request
180186

181-
[A map of our data centers](https://www.cloudflare.com/network-map) is listed on the [Cloudflare status page](https://www.cloudflarestatus.com/), sorted by continent.
182-
The three-letter code in the data center name is the [IATA code](http://en.wikipedia.org/wiki/IATA_airport_code) of the nearest major international airport.
187+
[A map of our data centers](https://www.cloudflare.com/network-map) is listed on the [Cloudflare status page](https://www.cloudflarestatus.com/), sorted by continent.
188+
The three-letter code in the data center name is the [IATA code](http://en.wikipedia.org/wiki/IATA_airport_code) of the nearest major international airport.
183189
Determine the Cloudflare data center serving requests for your browser by visiting:
184190
`http://``_www.example.com_``/cdn-cgi/trace.`
185191

186-
Replace `www.example.com` with your domain and hostname.  Note the `colo` field from the output.
192+
Replace `www.example.com` with your domain and hostname. Note the `colo` field from the output.
187193

188194
---
189195

@@ -204,13 +210,13 @@ If you are using Windows, you can find more details on how to use curl on Window
204210
](/fundamentals/api/how-to/make-api-calls/#making-api-calls-on-windows) article.
205211
:::
206212

207-
Run the following command to send a standard HTTP GET request to your website (replace `www.example.com` with your hostname):
213+
Run the following command to send a standard HTTP GET request to your website (replace `www.example.com` with your hostname):
208214

209215
```
210216
curl -svo /dev/null http://www.example.com/
211217
```
212218

213-
This example curl command returns output detailing the HTTP response and request headers but discards the page body output. curl output confirms the HTTP response and whether Cloudflare is currently proxying traffic for the site.
219+
This example curl command returns output detailing the HTTP response and request headers but discards the page body output. curl output confirms the HTTP response and whether Cloudflare is currently proxying traffic for the site.
214220

215221
:::note
216222

@@ -237,7 +243,7 @@ assistance.
237243

238244
### Performance
239245

240-
curl measures latency or performance degradation for HTTP/HTTPS requests via the [*-w* or *--write-out* curl option](https://curl.haxx.se/docs/manpage.html#-w). The example curl below measures several performance vectors in the request transaction such as duration of the TLS handshake, DNS lookup, redirects, transfers, etc:
246+
curl measures latency or performance degradation for HTTP/HTTPS requests via the [`-w` or `--write-out` curl option](https://curl.haxx.se/docs/manpage.html#-w). The example curl below measures several performance vectors in the request transaction such as duration of the TLS handshake, DNS lookup, redirects, transfers, etc:
241247

242248
```
243249
curl -svo /dev/null https://example.com/ -w "\nContent Type: %{content_type} \
@@ -259,7 +265,7 @@ curl -svo /dev/null https://example.com/ -w "\nContent Type: %{content_type} \
259265
\nEffective URL: %{url_effective}\n" 2>&1
260266
```
261267

262-
[Explanation of this timing output](https://blog.cloudflare.com/a-question-of-timing/) is found on the Cloudflare blog.
268+
[Explanation of this timing output](https://blog.cloudflare.com/a-question-of-timing/) is found on the Cloudflare blog.
263269

264270
:::note
265271

@@ -287,7 +293,7 @@ You can refer to the [Cloudflare Cache documentation](/cache/get-started/) for m
287293

288294
#### Reviewing Certificates with curl
289295

290-
The following curl command shows the SSL certificate served by Cloudflare during an HTTPS request (replace `www.example.com` with your hostname):
296+
The following curl command shows the SSL certificate served by Cloudflare during an HTTPS request (replace `www.example.com` with your hostname):
291297

292298
```sh
293299
curl -svo /dev/null https://www.example.com/ 2>&1 | egrep -v "^{.*$|^}.*$|^* http.*$"
@@ -299,7 +305,7 @@ curl -svo /dev/null https://www.example.com/ 2>&1 | egrep -v "^{.*$|^}.*$|^* htt
299305
parses the TLS handshake and certificate information.
300306
:::
301307

302-
To display the origin certificate (assuming one is installed), replace `203.0.113.34` below with the actual IP address of your origin web server and replace `www.example.com` with your domain and hostname:
308+
To display the origin certificate (assuming one is installed), replace `203.0.113.34` below with the actual IP address of your origin web server and replace `www.example.com` with your domain and hostname:
303309

304310
```sh
305311
curl -svo /dev/null https://www.example.com --connect-to ::203.0.113.34 2>&1 | egrep -v "^{.*$|^}.*$|^* http.*$"
@@ -324,25 +330,25 @@ For more details, refer to [Pause Cloudflare](/fundamentals/setup/manage-domains
324330

325331
## Perform a traceroute
326332

327-
Traceroute is a network diagnostic tool that measures the route latency of packets across a network. Most operating systems support the *traceroute* command. If you experience connectivity issues with your Cloudflare-proxied website and [ask Cloudflare Support for assistance](/support/contacting-cloudflare-support/), ensure to provide output from a traceroute.
333+
Traceroute is a network diagnostic tool that measures the route latency of packets across a network. Most operating systems support the `traceroute` command. If you experience connectivity issues with your Cloudflare-proxied website and [ask Cloudflare Support for assistance](/support/contacting-cloudflare-support/), ensure to provide output from a traceroute.
328334

329335
:::note
330336

331337
Timeouts are possible for ping results because Cloudflare limits ping
332338
requests.
333339
:::
334340

335-
Review the instructions below for running traceroute on different operating systems. Replace `www.example.com` with your domain and hostname in the examples below:
341+
Review the instructions below for running traceroute on different operating systems. Replace `www.example.com` with your domain and hostname in the examples below:
336342

337343
### Run traceroute on Windows
338344

339-
1. Open the **Start** menu.
345+
1. Open the **Start** menu.
340346

341-
2. Click **Run**.
347+
2. Click **Run**.
342348

343-
3. To open the command line interface, type **cmd** and then click **OK**.
349+
3. To open the command line interface, type **cmd** and then click **OK**.
344350

345-
4. At the command line prompt, type:
351+
4. At the command line prompt, type:
346352

347353
For IPv4 -
348354

@@ -382,18 +388,18 @@ traceroute -6 www.example.com
382388

383389
### Run traceroute on Mac OS
384390

385-
1. Open the **Network Utility** application.
386-
2. Click the **Traceroute** tab.
387-
3. Type the *domain* or *IP address* in the appropriate input field and press **Trace**.
391+
1. Open the **Network Utility** application.
392+
2. Click the **Traceroute** tab.
393+
3. Type the _domain_ or _IP address_ in the appropriate input field and press **Trace**.
388394
4. You can copy the results to save in a file or paste in another program.
389395

390-
Alternatively, follow the same Linux traceroute instructions above when using the Mac OS terminal program.
396+
Alternatively, follow the same Linux traceroute instructions above when using the Mac OS terminal program.
391397

392398
---
393399

394400
## Add the CF-RAY header to your logs
395401

396-
The **CF-RAY** header traces a website request through Cloudflare's network. Provide the **CF-RAY** of a web request to Cloudflare support when troubleshooting an issue. You can also add **CF-RAY** to your logs by editing your origin web server configuration with the snippet below that corresponds to your brand of web server:
402+
The **CF-RAY** header traces a website request through Cloudflare's network. Provide the **CF-RAY** of a web request to Cloudflare support when troubleshooting an issue. You can also add **CF-RAY** to your logs by editing your origin web server configuration with the snippet below that corresponds to your brand of web server:
397403

398404
### For Apache web servers, add `%{CF-Ray}i` to LogFormat
399405

@@ -465,7 +471,7 @@ packet capture is running, it will be recorded.
465471
Cloudflare suggests [Wireshark](https://www.wireshark.org/download.html) for running packet captures. For instructions on how to use the _tcpdump_ command line, refer to [this](https://www.wireshark.org/docs/wsug_html_chunked/AppToolstcpdump.html) article.
466472

467473
1. Close all programs/browser tabs that could be sending data in the background to avoid having to use a lot of display filters later.
468-
2. Create your Wireshark capture filter (refer to [this](https://wiki.wireshark.org/CaptureFilters) article for more information).
474+
2. Create your Wireshark capture filter (refer to [this](https://wiki.wireshark.org/CaptureFilters) article for more information).
469475
3. Select the appropriate interface (e.g. Wi-Fi: en0). If you're not sure which interface to use, Wireshark provides an I/O graph of each interface to give you a hint.
470476
4. Click the blue shark fin icon in the top left-hand corner to start your packet capture.
471477
5. Reproduce the issue while running capture.

0 commit comments

Comments
 (0)