Spot Scenarios¶
TCP¶
This scenario tests TCP bandwidth to the destination host. By default it sends traffic to one of public iperf servers. This can be overridden via parameter --matrix "{host:<host>}".
How To Run¶
- Run the scenario with defaults and generate interactive report into file report.html:
shaker-spot --scenario spot/tcp --report report.html
- Run the scenario with overridden target host (10.0.0.2) and store raw result:
shaker-spot --scenario spot/tcp --matrix "{host:10.0.0.2}" --output report.json
- Run the scenario with overridden target host (10.0.0.2) and store SLA verification results in subunit stream file:
shaker-spot --scenario spot/tcp --matrix "{host:10.0.0.2}" --subunit report.subunit
- Run the scenario against the list of target hosts and store report:
shaker-spot --scenario spot/tcp --matrix "{host:[10.0.0.2, 10.0.0.3]}" --output report.html
Scenario¶
title: TCP bandwidth
description: >
This scenario uses iperf3 to measure TCP throughput between local host and
ping.online.net (or against hosts provided via CLI). SLA check is verified
and expects the speed to be at least 90Mbit and at most 20 retransmitts.
The destination host can be overridden by command-line parameter,
e.g. ``--matrix "{host: 172.10.1.2}"``.
execution:
tests:
-
title: TCP
class: iperf3
host: ping.online.net
time: 20
sla:
- "[type == 'agent'] >> (stats.bandwidth.avg > 90)"
- "[type == 'agent'] >> (stats.retransmits.max < 20)"
UDP¶
This scenario tests UDP packets per second to the destination host. By default it sends traffic to one of public iperf servers. This can be overridden via parameter --matrix "{host:<host>}".
How To Run¶
shaker-spot --scenario spot/udp --report report.html
Scenario¶
title: UDP bandwidth
description: >
This scenario uses iperf3 to measure UDP throughput between local host and
ping.online.net (or against hosts provided via CLI). SLA check is verified
and requires at least 10 000 packets per second.
The destination host can be overridden by command-line parameter,
e.g. ``--matrix "{host: 172.10.1.2}"``.
execution:
tests:
-
title: UDP
class: iperf3
host: ping.online.net
udp: on
time: 20
bandwidth: 1000M
sla:
- "[type == 'agent'] >> (stats.packets.avg > 10000)"