Skip to content

Commit 688727c

Browse files
authored
Merge pull request #231650 from halkazwini/nw-capture
Network Watcher: Freshness: Introduction to packet capture in Azure Network Watcher
2 parents d460d11 + 21a1d69 commit 688727c

File tree

2 files changed

+21
-22
lines changed

2 files changed

+21
-22
lines changed
Binary file not shown.
Lines changed: 21 additions & 22 deletions
Original file line numberDiff line numberDiff line change
@@ -1,39 +1,39 @@
11
---
2-
title: Introduction to packet capture in Azure Network Watcher
3-
description: Learn about the Network Watcher packet capture capability.
2+
title: Packet capture overview
3+
titleSuffix: Azure Network Watcher
4+
description: Learn about Azure Network Watcher packet capture capability.
45
services: network-watcher
56
author: halkazwini
67
ms.service: network-watcher
78
ms.topic: conceptual
89
ms.workload: infrastructure-services
9-
ms.date: 06/07/2022
10+
ms.date: 03/22/2023
1011
ms.author: halkazwini
11-
ms.custom: engagement-fy23
12+
ms.custom: template-concept, engagement-fy23
1213
---
1314

14-
# Introduction to packet capture in Azure Network Watcher
15-
16-
> [!Important]
17-
> Packet capture is now also available for **virtual machine scale sets**. To check it out, visit [Manage packet captures in virtual machine scale sets with Azure Network Watcher using the Azure portal](network-watcher-packet-capture-manage-portal-vmss.md).
15+
# Packet capture overview
1816

19-
Network Watcher packet capture allows you to create packet capture sessions to track traffic to and from a virtual machine. Packet capture helps to diagnose network anomalies both reactively and proactively. Other uses include gathering network statistics, gaining information on network intrusions, to debug client-server communications and much more.
17+
Azure Network Watcher packet capture allows you to create packet capture sessions to track traffic to and from a virtual machine (VM) or a scale set. Packet capture helps to diagnose network anomalies both reactively and proactively. Other uses include gathering network statistics, gaining information on network intrusions, to debug client-server communications and much more.
2018

21-
Packet capture is an extension that is remotely started through Network Watcher. This capability eases the burden of running a packet capture manually on the desired virtual machine or virtual machine scale set instance(s), which saves valuable time. Packet capture can be triggered through the portal, PowerShell, CLI, or REST API. One example of how packet capture can be triggered is with Virtual Machine alerts. Filters are provided for the capture session to ensure you capture traffic you want to monitor. Filters are based on 5-tuple (protocol, local IP address, remote IP address, local port, and remote port) information. The captured data is stored in the local disk or a storage blob.
19+
Packet capture is an extension that is remotely started through Network Watcher. This capability eases the burden of running a packet capture manually on the desired virtual machine or virtual machine scale set instance(s), which saves valuable time. Packet capture can be triggered through the portal, PowerShell, Azure CLI, or REST API. One example of how packet capture can be triggered is with virtual machine alerts. Filters are provided for the capture session to ensure you capture traffic you want to monitor. Filters are based on 5-tuple (protocol, local IP address, remote IP address, local port, and remote port) information. The captured data can be stored in the local disk or a storage blob.
2220

2321
> [!IMPORTANT]
24-
> Packet capture requires a virtual machine extension `AzureNetworkWatcherExtension`. For installing the extension on a Windows VM visit [Azure Network Watcher Agent virtual machine extension for Windows](../virtual-machines/extensions/network-watcher-windows.md) and for Linux VM visit [Azure Network Watcher Agent virtual machine extension for Linux](../virtual-machines/extensions/network-watcher-linux.md).
22+
> Packet capture requires a virtual machine extension `AzureNetworkWatcherExtension`.
23+
- To install the extension on a Windows virtual machine, see [Network Watcher Agent VM extension for Windows](../virtual-machines/extensions/network-watcher-windows.md).
24+
- To install the extension on a Linux virtual machine, see [Network Watcher Agent VM extension for Linux](../virtual-machines/extensions/network-watcher-linux.md).
2525

26-
To reduce the information in order to capture only required information, following options are available for a packet capture session:
26+
To control the size of captured data and only capture required information, use the following options:
2727

28-
**Capture configuration**
28+
#### Capture configuration
2929

3030
|Property|Description|
3131
|---|---|
32-
|**Maximum bytes per packet (bytes)** | The number of bytes from each packet that are captured, all bytes are captured if left blank. If you need only the IPv4 header – indicate 34 here |
32+
|**Maximum bytes per packet (bytes)** | The number of bytes from each packet. All bytes are captured if left blank. Enter 34 if you only need to capture IPv4 header.|
3333
|**Maximum bytes per session (bytes)** | Total number of bytes that are captured, once the value is reached the session ends.|
34-
|**Time limit (seconds)** | Sets a time constraint on the packet capture session. The default value is 18000 seconds or 5 hours.|
34+
|**Time limit (seconds)** | Packet capture session time limit. The default value is 18000 seconds or 5 hours.|
3535

36-
**Filtering (optional)**
36+
#### Filtering (optional)
3737

3838
|Property|Description|
3939
|---|---|
@@ -45,13 +45,12 @@ To reduce the information in order to capture only required information, followi
4545

4646

4747
## Considerations
48-
There's a limit of 10,000 parallel packet capture sessions per region per subscription. This limit applies only to the sessions and doesn't apply to the saved packet capture files either locally on the VM or in a storage account. See the [Network Watcher service limits page](../azure-resource-manager/management/azure-subscription-service-limits.md#network-watcher-limits) for a full list of limits.
4948

50-
### Next steps
49+
There's a limit of 10,000 parallel packet capture sessions per region per subscription. This limit applies only to the sessions and doesn't apply to the saved packet capture files either locally on the VM or in a storage account. See the [Network Watcher service limits page](../azure-resource-manager/management/azure-subscription-service-limits.md#network-watcher-limits) for a full list of limits.
5150

52-
Learn how you can manage packet captures through the portal by visiting [Manage packet capture in the Azure portal for VM](network-watcher-packet-capture-manage-portal.md)and [Manage packet capture in the Azure portal for Virtual Machine Scale Sets](network-watcher-packet-capture-manage-portal-vmss.md) or with PowerShell by visiting [Manage Packet Capture with PowerShell for VM](network-watcher-packet-capture-manage-powershell.md)and [Manage Packet Capture with PowerShell for Virtual Machine Scale Sets](network-watcher-packet-capture-manage-powershell-vmss.md)
51+
## Next steps
5352

54-
Learn how to create proactive packet captures based on virtual machine alerts by visiting [Create an alert triggered packet capture](network-watcher-alert-triggered-packet-capture.md)
53+
- To learn how to manage packet captures using the Azure portal, see [Manage packet captures in virtual machines using the Azure portal](network-watcher-packet-capture-manage-portal.md) and [Manage packet captures in Virtual Machine Scale Sets using the Azure portal](network-watcher-packet-capture-manage-portal-vmss.md).
54+
- To learn how to manage packet captures using Azure PowerShell, see [Manage packet captures in virtual machines using PowerShell](network-watcher-packet-capture-manage-powershell.md) and [Manage packet captures in Virtual Machine Scale Sets using PowerShell](network-watcher-packet-capture-manage-powershell-vmss.md).
55+
- To learn how to create proactive packet captures based on virtual machine alerts, see [Create an alert triggered packet capture](network-watcher-alert-triggered-packet-capture.md).
5556

56-
<!--Image references-->
57-
[1]: ./media/network-watcher-packet-capture-overview/figure1.png

0 commit comments

Comments
 (0)