Skip to content

Commit cf6f67c

Browse files
authored
Merge pull request #312236 from halkazwini/nw-managecapture
Manage capture udpate
2 parents 4e8c372 + ce6ce31 commit cf6f67c

2 files changed

Lines changed: 17 additions & 11 deletions

File tree

14.7 KB
Loading

articles/network-watcher/packet-capture-manage.md

Lines changed: 17 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -6,9 +6,8 @@ author: halkazwini
66
ms.author: halkazwini
77
ms.service: azure-network-watcher
88
ms.topic: how-to
9-
ms.date: 03/21/2025
9+
ms.date: 02/24/2026
1010

11-
#CustomerIntent: As an administrator, I want to capture IP packets to and from a virtual machine (VM) so I can review and analyze the data to help diagnose and solve network problems.
1211
# Customer intent: As a network administrator, I want to manage packet captures on Azure virtual machines so that I can analyze network traffic and troubleshoot issues effectively.
1312
---
1413

@@ -97,18 +96,23 @@ To start a capture session, use the following steps:
9796
| Subscription | Select the Azure subscription of the virtual machine. |
9897
| Resource group | Select the resource group of the virtual machine. |
9998
| Target type | Select **Virtual machine** or **Virtual machine scale set**. |
99+
| Target virtual machine | Select the virtual machine. <br> This option is available if you select **Virtual machine** as the target type. |
100100
| Target virtual machine scale set | Select the virtual machine scale set. <br> This option is available if you select **Virtual machine scale set** as the target type. |
101-
| Target instance | Select the virtual machine or scale set instance. |
101+
| Target instance | Select the virtual machine scale set instance. <br> This option is available if you select **Virtual machine scale set** as the target type. |
102102
| Packet capture name | Enter a name or leave the default name. |
103+
| **Packet capture storage** | |
104+
| Capture location | Select **in storage account** (default option), **in local file storage**, or **Both**. |
105+
| Storage accounts | Select your **Standard** storage account<sup>1</sup>. <br> This option is available if you select **in storage account** or **Both** as the capture location. <br> The storage account must be in the same region as the target instance. |
106+
| Local file path | Enter a valid local file path where you want the capture to be saved in the target virtual machine. <br>If you're using a Linux machine, the path can start with `/var/captures`. <br>If you're using a Windows machine, the path can start with `C:\Captures`. <br> This option is available if you select **in local file storage** or **Both** as the capture location. |
103107
| **Packet capture configuration** | |
104-
| Capture location | Select **Storage account** (default option), **File**, or **Both**. |
105-
| Storage account | Select your **Standard** storage account<sup>1</sup>. <br> This option is available if you select **Storage account** or **Both** as a capture location. <br> The storage account must be in the same region as the target instance. |
106-
| Local file path | Enter a valid local file path where you want the capture to be saved in the target virtual machine. <br>If you're using a Linux machine, the path can start with `/var/captures`. <br>If you're using a Windows machine, the path can start with `C:\Captures`. <br> This option is available if you select **File** or **Both** as a capture location. |
108+
| Enable continuous capture<sup>3</sup> | Check this checkbox if you want to enable continuous packet capture. For more information, see [Continuous packet capture](packet-capture-overview.md#continuous-packet-capture-preview). |
107109
| Maximum bytes per packet | Enter the maximum number of bytes to be captured per each packet. All bytes are captured if left blank or 0 entered. |
108-
| Maximum bytes per session | Enter the total number of bytes that are captured. Once the value is reached the packet capture stops. Up to 1 GB is captured if left blank. |
109-
| Time limit (seconds) | Enter the time limit of the packet capture session in seconds. Once the value is reached the packet capture stops. Up to 5 hours (18,000 seconds) is captured if left blank. |
110-
| **Filtering (optional)** | |
111-
| Add filter criteria | Select **Add filter criteria** to add a new filter. You can define as many filters as you need. |
110+
| New files created<sup>3</sup> | Enter the maximum number of files created. The default value is 100 MB and the maximum value is 4 GB. <br> This option is available if you enable **continuous capture**. |
111+
| Bytes per file<sup>3</sup> | Enter the number of bytes per file. Once the value is reached, a new file is created. |
112+
| Time limit (seconds) | Enter the time limit of the packet capture session in seconds. Once the value is reached the packet capture stops. <br>If left blank: <br> - Up to 5 hours (18,000 seconds) is captured without enabling continuous capture. <br> - Up to 1 day (86,400 seconds) is captured if you enable continuous capture. The maximum value is 604,800 seconds (7 days). |
113+
| **Packet filtering (optional)** | |
114+
| Packet filtering | Select **Enable packet filtering** to enable packet filtering. |
115+
| Add a filter | Select **Add filter criteria** to add a new filter. You can define as many filters as you need. |
112116
| Protocol | Filters the packet capture based on the selected protocol. Available values are **TCP**, **UDP**, or **Any**. |
113117
| Local IP address<sup>2</sup> | Filters the packet capture for packets where the local IP address matches this value. |
114118
| Local port<sup>2</sup> | Filters the packet capture for packets where the local port matches this value. |
@@ -118,12 +122,14 @@ To start a capture session, use the following steps:
118122
<sup>1</sup> Premium storage accounts are currently not supported for storing packet captures.
119123

120124
<sup>2</sup> Port and IP address values can be a single value, a range such as 80-1024, or multiple values such as 80, 443.
125+
126+
<sup>3</sup> Continuous capture is currently in preview. For more information, see [Continuous packet capture](packet-capture-overview.md#continuous-packet-capture-preview).
121127

122128
1. Select **Start packet capture**.
123129

124130
:::image type="content" source="./media/packet-capture-manage/add-packet-capture.png" alt-text="Screenshot of Add packet capture in the Azure portal showing available options." lightbox="./media/packet-capture-manage/add-packet-capture.png":::
125131

126-
1. The packet capture stops once the time limit or the file size (maximum bytes per session) is reached.
132+
1. The packet capture stops once the time limit is reached.
127133

128134
# [**PowerShell**](#tab/powershell)
129135

0 commit comments

Comments
 (0)