iperf-grpc-tcpdump

Automate synchronized iperf3 traffic generation and tcpdump packet capture across distributed firewall nodes.

8|2|Updated Feb 8, 2026
One-click install
npx skills add https://github.com/psaab/xpf --skill iperf-grpc-tcpdump
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: iperf-grpc-tcpdump
Source: https://github.com/psaab/xpf/tree/main/.codex/skills/iperf-grpc-tcpdump
Command: npx skills add https://github.com/psaab/xpf --skill iperf-grpc-tcpdump

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires grpcurl, incus, iperf3, python3, and includes scripts (resource) components.

What problem does it solve?

This skill solves the difficulty of diagnosing throughput collapses and packet corruption in a complex userspace firewall environment by automating the synchronization of traffic generation and multi-point packet capture.

Core Features & Use Cases

  • Automated Capture Orchestration: Simultaneously triggers server-side gRPC captures and dual-interface tcpdumps on the active firewall.
  • Performance Analysis: Runs iperf3 tests and generates a summary of throughput, retransmits, and interval statistics.
  • Use Case: When debugging TCP resets or tuple corruption, use this skill to capture a synchronized view of traffic across the LAN, WAN, and server endpoints to identify exactly where packets are being dropped or modified.

Quick Start

Run the capture script for IPv4 traffic to analyze throughput and capture packets on the active firewall.

Frequently Asked Questions about iperf-grpc-tcpdump

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I synchronize tcpdump packet capture across distributed firewall nodes and gRPC endpoints?

Synchronized packet capture across distributed firewall nodes is automated by triggering server-side gRPC captures and dual-interface tcpdumps simultaneously. This coordinated traffic generation captures a synchronized view of traffic across LAN, WAN, and server endpoints to identify where packets are dropped or modified.

Why does my userspace dataplane experience throughput degradation and TCP resets?

Throughput degradation and TCP resets in userspace dataplane environments often stem from packet corruption or tuple modification. Running iperf3 tests alongside multi-point packet capture helps isolate exactly where packets are being dropped or modified across the network path.

What's the best way to debug packet corruption in a userspace firewall environment?

Debugging packet corruption in a userspace firewall environment is best handled by automating synchronized network performance testing and multi-point packet capture. This approach pairs iperf3 throughput analysis with simultaneous tcpdump captures to pinpoint corruption locations.

Do I need incus and grpcurl to run coordinated network performance testing?

Yes, incus, grpcurl, and iperf3 are required dependencies to execute coordinated traffic generation and diagnostic data collection. These tools enable the automated capture orchestration and performance analysis needed for synchronized network debugging.

Can I analyze iperf3 retransmits and interval statistics during a live firewall capture?

Yes, iperf3 tests are run during the live capture process to generate a summary of throughput, retransmits, and interval statistics. This performance analysis runs concurrently with dual-interface tcpdumps on the active firewall.

When should I use synchronized network debugging for firewall troubleshooting?

Synchronized network debugging should be used when diagnosing throughput collapses, TCP resets, or packet corruption within userspace dataplane environments. It is specifically designed for complex firewall setups where identifying the exact point of packet drop or modification requires multi-point visibility.