|
| 1 | +--- |
| 2 | +title: Use NetLog to capture network traffic |
| 3 | +description: Provides guidance about using the Network Logs (NetLog) tool as an alternative to Fiddler and HTTP Archive (HAR) captures. |
| 4 | +ms.reviewer: bachoang, v-weizhu |
| 5 | +ms.date: 04/08/2025 |
| 6 | +ms.service: entra-id |
| 7 | +ms.topic: how-to |
| 8 | +ms.custom: sap:Enterprise Applications |
| 9 | +--- |
| 10 | +# Use NetLog as an alternative to Fiddler and HAR captures |
| 11 | + |
| 12 | +This article provides guidance on using the Network Logs (NetLog) tool as an alternative to Fiddler and HTTP Archive (HAR) captures for diagnosing network issues in Microsoft Entra. NetLog is built into in Chromium-based browsers like Microsoft Edge, Chrome, and Electron. When standard Fiddler captures are unavailable or HAR captures from developer tools truncate necessary information, you can use it to capture network traffic. |
| 13 | + |
| 14 | +## Known limitations |
| 15 | + |
| 16 | +Before using NetLog, be aware of the following limitations: |
| 17 | + |
| 18 | +- POST request bodies aren't captured. |
| 19 | +- Sites running in compatibility mode for Internet Explorer aren't captured. |
| 20 | + |
| 21 | +Depending on the information you need, you might still need to use Fiddler or HAR captures. |
| 22 | + |
| 23 | +## Use NetLog in browsers |
| 24 | + |
| 25 | +Follow these steps to capture network traffic using NetLog: |
| 26 | + |
| 27 | +1. (Optional but helpful) Close all browser tabs except one. |
| 28 | +1. Navigate to NetLog: |
| 29 | + - For Chrome: Open a new tab and go to `chrome://net-export`. |
| 30 | + - For Microsoft Edge: Open a new tab and go to `edge://net-export`. |
| 31 | +1. In the **Options** section, select **Include raw bytes (will include cookies and credentials)**. |
| 32 | +1. Leave the **Maximum log size** field blank. |
| 33 | +1. Select **Start Logging to Disk**. |
| 34 | +1. Select a file and a location (such as **Desktop**) to save the log file. |
| 35 | +1. Within the same browser window, open a new tab. |
| 36 | +1. Reproduce the issue. |
| 37 | + |
| 38 | + > [NOTE] |
| 39 | + > If you close or navigate away from the NetLog tab, the logging will stop automatically. |
| 40 | +1. After reproducing the issue, return to the NetLog tab and select the **Stop Logging** button. |
| 41 | +1. Locate the NetLog file (*NetLog.json*) saved in step 6. |
| 42 | + |
| 43 | +## Use NetLog on mobile devices |
| 44 | + |
| 45 | +NetLog is supported on mobile versions of Edge and Chrome: |
| 46 | + |
| 47 | +- Android: NetLog works in Edge and Chrome for Android. |
| 48 | +- iOS: NetLog works in Chrome for iOS. |
| 49 | + |
| 50 | +On mobile devices, you will have an email option to send the log. |
| 51 | + |
| 52 | +### Capture traffic in Android WebView |
| 53 | + |
| 54 | +For capturing network traffic in Android WebView, see [Debug WebView network traffic](https://chromium.googlesource.com/chromium/src/+/HEAD/android_webview/docs/net-debugging.md). |
| 55 | + |
| 56 | +## Use Fiddler to review NetLog captures |
| 57 | + |
| 58 | +Fiddler Classic can be used to review NetLog captures by installing the NetLog plugin. To do so, follow these steps: |
| 59 | + |
| 60 | +1. Download and install the NetLog plugin for Fiddler Classic from [this link](https://bayden.com/dl/FiddlerImportNetLog.exe). |
| 61 | +2. Open Fiddler. |
| 62 | +3. Navigate to **File > Import Sessions**. |
| 63 | +4. Select **NetLog JSON** to import and analyze the NetLog file. |
| 64 | + |
| 65 | +> [!NOTE] |
| 66 | +> The NetLog plugin is only available for Fiddler Classic. There is no known plugin for Fiddler Everywhere. |
| 67 | +
|
| 68 | + :::image type="content" source="media/use-netlog-capture-network-traffic/import-netlog-json.png" alt-text="Screenshot that shows the Fiddler interface for importing NetLog files." border="false"::: |
| 69 | + |
| 70 | +## More information |
| 71 | + |
| 72 | +- [Providing network details with NetLog](https://dev.chromium.org/for-testers/providing-network-details) |
| 73 | +- [Online NetLog viewer](https://netlog-viewer.appspot.com/#import) |
| 74 | + |
| 75 | +The online NetLog viewer provides additional details that Fiddler doesn't provide, such as: |
| 76 | + |
| 77 | +- DNS resolution data |
| 78 | +- Timeline graph |
| 79 | +- Browser proxy configuration |
| 80 | +- Installed browser extensions |
| 81 | + |
| 82 | +[!INCLUDE [Azure Help Support](../../../includes/azure-help-support.md)] |
0 commit comments