blob: aff6dc7beba18f1ac1272abf3d5a81a58256961d (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
|
---
breadcrumbs:
- - /for-testers
- For Testers
page_name: providing-network-details
title: How to capture a NetLog dump
---
A *NetLog dump* is a log file of the browser's network-level events and state.
You may be asked to provide this log when experiencing page load or performance
problems.
***Note:** if you want to take a netlog for **Android WebView**, [read this
guide](https://chromium.googlesource.com/chromium/src/+/HEAD/android_webview/docs/net-debugging.md)
instead.*
To create a *NetLog dump*, open a new tab and navigate to:
> chrome://net-export/
[<img alt="image" src="/for-testers/providing-network-details/net-export-61.png"
height=321 width=400>](/for-testers/providing-network-details/net-export-61.png)
You can then follow the instructions on that page.
**Step-by-step guide**
1. Open a new tab and go to chrome://net-export/
2. Click the **Start Logging To Disk** button.
3. Reproduce the network problem **in a different tab** (the
chrome://net-export/ tab needs to stay open or logging will
automatically stop.)
4. Click **Stop Logging** button.
5. Provide the resulting log file to the bug investigator.
* Either attach the file to your existing or [new bug
report](https://crbug.com/new), or send email to the bug
investigator.
* Provide the **entire** log file. Snippets are rarely sufficient
to diagnose problems.
* **Include any relevant URLs or details to focus on.**
> **PRIVACY**: When attaching log files to bug reports, note that Chrome bug
> reports are **publicly visible** by default. If you would prefer it be only
> visible to Google employees, mention this on the bug and wait for a Google
> engineer to restrict visibility of the bug before you attach the file.
**Advanced: Byte-level captures**
By default, NetLog dumps do not include all of the raw bytes (encrypted or
otherwise) that were transmitted over the network.
To include this data in the log file, select the **Include raw bytes** option at
the bottom of the chrome://net-export/ page:
> **PRIVACY:** Captures with this level of detail may include personal
> information and should generally be emailed rather than posted on public
> forums or public bugs.
[<img alt="image"
src="/for-testers/providing-network-details/net-export-raw-bytes-61.png"
height=108
width=400>](/for-testers/providing-network-details/net-export-raw-bytes-61.png)
**Advanced: Logging on startup**
If the problem that you want to log happens very early and you cannot start
chrome://net-export in time, you can add a command line argument to Chrome that
will start logging to a file from startup:
> --log-net-log=C:\\some_path\\some_file_name.json
If a granularity for capture other than the default of "Strip private
information" is needed, one of the following flags can be used:
* --net-log-capture-mode=IncludeSensitive
* --net-log-capture-mode=Everything
For info about adding command line options, see
[command-line-flags](/developers/how-tos/run-chromium-with-flags).
**Advanced: Viewing the NetLog dump file**
The log file can be loaded using the
[netlog_viewer](https://chromium.googlesource.com/catapult/+/HEAD/netlog_viewer/).
|