Skip to content

Commit 9fd5c40

Browse files
committed
AB#4500: Convert blog posts to articles
1 parent 8eefff1 commit 9fd5c40

3 files changed

Lines changed: 84 additions & 0 deletions

File tree

10.9 KB
Loading
Lines changed: 82 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,82 @@
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)]

support/entra/entra-id/toc.yml

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -136,6 +136,8 @@
136136
href: app-integration/application-delegated-permission-access-tokens-identity-platform.md
137137
- name: Troubleshoot consent issues
138138
href: app-integration/troubleshoot-consent-issues.md
139+
- name: Use NetLog as an alternative to Fiddler and HAR captures
140+
href: app-integration/use-netlog-capture-network-traffic.md
139141
- name: Business To Consumer (B2C) Tenants
140142
items:
141143
- name: Problem with app or API integration

0 commit comments

Comments
 (0)