perf-test

Measure network throughput and profile CPU usage with iperf3 and perf record.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill addresses the difficulty of measuring network throughput and identifying CPU bottlenecks in high-performance firewall environments, ensuring that traffic processing remains efficient under load.

Core Features & Use Cases

  • Throughput Benchmarking: Executes automated iperf3 tests to measure IPv4 and IPv6 performance across different network topologies.
  • CPU Profiling: Captures and analyzes kernel-level performance data using perf to identify specific BPF program overheads.
  • Use Case: When deploying a new firewall configuration, use this Skill to compare IPv4 and IPv6 throughput and verify that CPU usage for packet parsing and NAT remains within healthy operational baselines.

Quick Start

Run the perf-test skill with the all argument to execute a full throughput comparison and CPU profiling report for the current environment.

Frequently Asked Questions about perf-test

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

FAQPage Schema
How do I benchmark firewall network throughput using iperf3?

To benchmark network throughput, this Skill automates iperf3 tests to measure IPv4 and IPv6 performance across different firewall topologies. It generates traffic to validate network configurations under load.

How does CPU profiling identify BPF program overhead in firewalls?

CPU profiling captures kernel-level performance data using perf record to identify specific BPF program overheads. It analyzes kernel symbols to isolate packet parsing and NAT bottlenecks.

Can I test firewall performance in clustered incus environments?

Yes, you can validate firewall performance in clustered incus environments. The Skill facilitates performance validation across standalone VMs and clustered managed infrastructure.

What is the best way to compare IPv4 and IPv6 firewall performance?

The best way to compare IPv4 and IPv6 firewall performance is running the Skill with the all argument. This executes a full throughput comparison and CPU profiling report.

Do I need incus-managed infrastructure to run network throughput diagnostics?

Yes, you need access to incus-managed infrastructure and standard Linux performance monitoring tools. These dependencies execute the automated traffic generation and diagnostic workflows.

Why does firewall CPU usage spike during packet parsing under load?

Firewall CPU usage spikes during packet parsing are identified by capturing kernel-level performance data with perf. This pinpoints specific BPF overheads causing processing bottlenecks.