Graph Ubiquiti AirOS stats during an Iperf test.
PHP
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
images
lib
LICENSE
README.md
ubiquiperf.php

README.md

Ubiquiperf

Graph Ubiquiti AirOS stats during an Iperf test.

This is a quick script to perform an iperf to a remote server while grabbing various statistics from a Ubiquiti Access Point or CPE. I just wanted a quick and dirty way to see iperf data aligned with signal stats, etc at the same time. It uses jpgraph (http://jpgraph.net) to plot everything once the tests are complete. You'll need to download it and install or symlink it into the main directory (/jpgraph).

At the present time it only runs as a client, so effectively it's an upload test. Of course, you can always run it from the other side as well.

Example graph

Ubiquiperf Graph

Known issues

If you're running a single threaded instance of iperf, the output of the client is problematic and will not work. To fix that, recompile iperf with pthread support.

Options

-s Iperf server to connect to.
-a Ubiquiti AirOS device IP.
-u AirOS login (typically "ubnt").
-p AirOS password.
-h AirOS web protocol (http||https)
-d Duration of iperf test (in seconds).
-c CSV file to output results to.
-g PNG graph of the test.
-y Amount of time to delay start of iperf test (in seconds).

Example usage

php ./ubiquiperf.php -s <iperf server> -a <AP IP> -u <AP Username> -p <AP/CPE Password> -d <test duration> -c <CSV OUTPUT> -g <PNG OUTPUT> -h <http|https> -y <test delay>

Example graphs are found in the images/ directory.

If you have any questions, feel free to contact me.