This is an old revision of the document!
Table of Contents
Packet Captures
Data Plane Packet Capture
Base on this article and this article.
delta yesindicates I want to view counters that have incremented since the last time I executed this command.packet-filter yesindicates I want to see only global counters that match my filters.
show counter global filter packet-filter yes delta yes
Next you're going to configure the stages—there are 4:
- drop stage is where packets get discarded. The reasons may vary and, for this part, the global counters may help identify if the drop was due to a policy deny, a detected threat, or something else.
- receive stage captures the packets as they ingress the firewall before they go into the firewall engine. When NAT is configured, these packets will be pre-NAT.
- transmit stage captures packets how they egress out of the firewall engine. If NAT is configured, these will be post-NAT.
- firewall stage captures packets in the firewall stage.
Start packet captures
debug dataplane packet-diag set capture on
Stop packet captures
debug dataplane packet-diag set capture off
Managment Interface Packet Capture
To Troubleshoot connectivity issues with the management plane, the built-in tcpdump command can be used to capture useful information:
tcpdump filter "port 53"
tcpdump filter "host 10.16.0.106 and not port 22"
view-pcap mgmt-pcap mgmt.pcap
Flow Basic
First we're going to verify that nothing's been configured yet that could interfere with our new settings:
debug dataplane packet-diag show setting
If anything's still configured, we can clear out all filters and previous flow basic logs using these commands:
debug dataplane packet-diag clear all
debug dataplane packet-diag clear log log
We can now go ahead and create and enable the filters, making sure pre-parse is disabled. A second filter from the server to the NAT IP on the external interface of the firewall will help capture returning packets before they are NAT'ed in the 'ingress stage.' More about that below:
debug dataplane packet-diag set filter match source 192.168.0.34 destination 198.51.100.97 destination-port 80 protocol 6 non-ip exclude
debug dataplane packet-diag set filter match source 198.51.100.97 destination 198.51.100.230 source-port 80 protocol 6 non-ip exclude
debug dataplane packet-diag set filter on
debug dataplane packet-diag show setting
debug dataplane packet-diag set log feature flow basic
When you're ready to initiate traffic make sure any existing sessions have been terminated, then disable session offloading to ensure all packets are captured even if the session would normally be offloaded into hardware and finally go ahead and enable the logging feature.
show session all filter source 192.168.0.34 destination 198.51.100.97
If there are still active sessions you can clear them by using the clear session command:
clear session all filter source 192.168.0.34 destination 198.51.100.97
set session offload no
debug dataplane packet-diag set log on
You can now go ahead and start the session you want to capture, wait for it to gracefully end, then disable logging:
show session all filter source 192.168.0.34 destination 198.51.100.97
debug dataplane packet-diag set log off
set session offload yes
A nifty little tool is provided to aggregate these files into a single file:
debug dataplane packet-diag aggregate-logs
The final output file is then stored on the management plane as pan_packet_diag.log:
less mp-log pan_packet_diag.log
=Packet Filter=
debug dataplane packet-diag set filter match source 192.0.2.1 non-ip exclude
debug dataplane packet-diag set filter on
Then show your counters as a delta with just that filter:
show counter global filter delta yes packet-filter yes
