brc test throughput

Measure the network throughput for a terminal

Synopsis

This command runs an iperf2 test to measure the network throughput for a network in either down-link (dl) or up-link (ul) direction. In both cases an iperf2 client from the terminal will connect to an iperf2 server running on the destination IP address. In case of the down-link direction the --reverse flag from iperf2 is used. All the regular flags for iperf2 can be passed after the -- separator.

The special value gateway can be used as the destination IP address to use the gateway IP address of the UPF where the terminal is connected. This gateway IP is assumed to be the first IP address in the subnet of the terminal.

The option --namespace by default points to a Kubernetes namespace of the default Kubernetes context. You may explicitly provide the context in the format of <context-name>.<namespace> to access the cluster using particular kubectlcontext. The format bare.<machine-name> is reserved for bare-metal machine access where SSH is used to access the machine named <machine-name>. In this case the <terminal> points to the name of the network interface where the iperf2 test is being executed.

Depending on your PDU session configuration, the terminal might accept IPv4 or IPv6 packages.

brc test throughput [flags]

Examples

# tcp dl throughput from gateway test for ue1 on the cluster for 60 seconds
brc test throughput ue1 dl gateway -- --time 60

# udp ul throughput to 192.168.1.1 for ue2 on the cluster with target bandwidth of 100 Mbps
brc test throughput ue2 ul 192.168.1.1 -- --udp --bandwidth 100M

# tcp dl throughput test from gateway for bare-metal ue running on machine named ayo on interface wwan0
brc test throughput --namespace bare.ayo wwan0 dl gateway

Options

  -h, --help   help for throughput

Options inherited from parent commands

  -n, --namespace string   namespace to perform the operations (default "trirematics")
  -p, --plot               Specify if the results should be plotted.
  -v, --verbose            debug output

brc test throughput