You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
# Perform packet capture on a packet core instance
14
14
15
-
Packet capture for control or data plane packets is performed using the **UPF Trace** tool. UPF Trace is similar to **tcpdump**, a data-network packet analyzer computer program that runs on a command line interface (CLI). You can use UPF Trace to monitor and record packets on any user plane interface on the access network (N3 interface) or data network (N6 interface) on your device, as well as the control plane (N2 interface). You can access UPF Trace using the Azure portal or the Azure CLI.
15
+
Packet capture for control or data plane packets is performed using the **MEC-Dataplane Trace** tool. MEC-Dataplane (MEC-DP) Trace is similar to **tcpdump**, a data-network packet analyzer computer program that runs on a command line interface (CLI). You can use MEC-DP Trace to monitor and record packets on any user plane interface on the access network (N3 interface) or data network (N6 interface) on your device, as well as the control plane (N2 interface). You can access MEC-DP Trace using the Azure portal or the Azure CLI.
16
16
17
17
Packet capture works by mirroring packets to a Linux kernel interface, which can then be monitored using tcpdump. In this how-to guide, you'll learn how to perform packet capture on a packet core instance.
18
18
@@ -58,16 +58,16 @@ To perform packet capture using the command line, you must:
58
58
59
59
## Performing packet capture using the Azure CLI
60
60
61
-
1. In a command line with kubectl access to the Azure Arc-enabled Kubernetes cluster, enter the UPF-PP troubleshooter pod:
61
+
1. In a command line with kubectl access to the Azure Arc-enabled Kubernetes cluster, enter the MEC-DP troubleshooter pod:
1. View the list of configured user plane interfaces:
68
68
69
69
```azurecli
70
-
upft list
70
+
mect list
71
71
```
72
72
73
73
This should report a single interface on the control plane network (N2), a single interface on the access network (N3) and an interface for each attached data network (N6). For example:
@@ -80,9 +80,9 @@ To perform packet capture using the command line, you must:
80
80
n6trace2 (Data Network: test)
81
81
```
82
82
83
-
1. Run `upftdump` with any parameters that you would usually pass to tcpdump. In particular, `-i` to specify the interface, and `-w` to specify where to write to. Close the UPFT tool when done by pressing <kbd>Ctrl + C</kbd>. The following examples are common use cases:
84
-
- To run capture packets on all interfaces run `upftdump -i any -w any.pcap`
85
-
- To run capture packets for the N3 interface and the N6 interface for a single data network, enter the UPF-PP troubleshooter pod in two separate windows. In one window run `upftdump -i n3trace -w n3.pcap` and in the other window run `upftdump -i <N6 interface> -w n6.pcap` (use the N6 interface for the data network as identified in step 2).
83
+
1. Run `mectdump` with any parameters that you would usually pass to tcpdump. In particular, `-i` to specify the interface, and `-w` to specify where to write to. Close the tool when finished by pressing <kbd>Ctrl + C</kbd>. The following examples are common use cases:
84
+
- To run capture packets on all interfaces, run `mectdump -i any -w any.pcap`
85
+
- To run capture packets for the N3 interface and the N6 interface for a single data network, enter the MEC-DP troubleshooter pod in two separate windows. In one window run `mectdump -i n3trace -w n3.pcap` and in the other window run `mectdump -i <N6 interface> -w n6.pcap` (use the N6 interface for the data network as identified in step 2).
86
86
87
87
> [!IMPORTANT]
88
88
> Packet capture files might be large, particularly when running packet capture on all interfaces. Specify filters when running packet capture to reduce the file size - see the tcpdump documentation for the available filters.
@@ -96,15 +96,15 @@ To perform packet capture using the command line, you must:
96
96
1. Copy the output files:
97
97
98
98
```azurecli
99
-
kubectl cp -n core core-upf-pp-0:<path to output file> <location to copy to> -c troubleshooter
99
+
kubectl cp -n core core-mec-dp-0:<path to output file> <location to copy to> -c troubleshooter
100
100
```
101
101
102
102
The `tcpdump` might have been stopped in the middle of writing a packet, which can cause this step to produce an error stating `unexpected EOF`. However, your file should have copied successfully, but you can check your target output file to confirm.
1. View the list of configured user plane interfaces:
37
37
38
38
```azurecli
39
-
upft list
39
+
mect list
40
40
```
41
41
42
42
This should report a single interface on the control plane network (N2), a single interface on the access network (N3) and an interface for each attached data network (N6). For example:
0 commit comments