Manual:Tools/Traffic Generator: Difference between revisions

From MikroTik Wiki
Jump to navigation Jump to search
Line 276: Line 276:




This menu allows to specify ports (interfaces) that will be used to receive send generated packets.
This menu allows to configure ports that will be associated to specific interface and will be used to receive/send generated packets.




Line 304: Line 304:
|type=string
|type=string
|default=
|default=
|desc=Name of the interface which will be used for tx/rx
|desc=Name of the interface associated with the port.
}}
}}


Line 324: Line 324:
|arg=first-header
|arg=first-header
|type=ip {{!}} mac {{!}} raw {{!}} udp {{!}} vlan
|type=ip {{!}} mac {{!}} raw {{!}} udp {{!}} vlan
|desc=Shows the first generated header from packet template.
|desc=Shows suhhested first header for packets to be sent out of specified interface. This is information can be used when creating [[#Packet_Template | packet templates]].
}}
}}



Revision as of 10:59, 28 September 2011

Version.png

Applies to RouterOS: v5 +

Summary

Traffic Generator is a tool that allows to generate and send RAW packets over specific ports. Tool also collects latency and jitter values, tx/rx rates, it also counts lost packets and detects Out-of-Order packets. Traffic Generator can be used similar to bandwidth test tool as well as generate packets that will be routed back to packet generator for advanced status collection.

General

Sub-menu /tool traffic-generator


This menu allows to set general traffic generator properties and contains commands to quickly start and stop the tool.


Properties

Property Description
latency-distribution-scale (integer [0..28]; Default: 10)
test-id (integer [0..255]; Default: 0)


Read-Only Properties

Property Description
latency-distribution-samples (integer)
latency-distribution-measure-interval (time)
running (yes | no) Shows whether traffic generator tool is started.


Commands

Property Description
quick () This command allows to quickly start packet generator and print the stats output to the terminal. Command also accept several parameters that overrides settings in packet template and stream settings. Accepted parameters are duration, entries-to-show, freeze-frame-interval, mbps, num, packet-size, port, pps, stream, test-id, tx-template
  • duration - how long to run the test
  • entries-to-show - how many status lines print to the terminal
  • freeze-frame-interval - how often to update status to the terminal
The rest of the parameters are not command specific and are described elsewhere.
start () Commands starts the traffic generator tool in the background. It accepts one parameter test-id
stop () Command stops the started traffic generator tool by start command.

Packet Template

Sub-menu /tool traffic-generator packet-template

This sub menu allows to build packet based on provided parameters. Based on parameters you can build ip packet with vlan tags and set udp ports. If you require other protocols, then please use raw-packet-template builder to build the packet.

Properties

Property Description
comment (string; Default: ) Short description of packet you are building.
data (incrementing | random | specific-byte | uninitialized; Default: uninitialized)
data-byte (hex [0..FF]]; Default: 0) Byte that will be used to fill packet payload.
interface (string; Default: )
ip-dscp (integer[0..255][,integer [0..255],...]] (max 16 times); Default: ) Single DSCP or list of DSCP values that will be set in IP header
ip-dst (list of IP/Netmask (max 16 times); Default: ) List of destination IP addresses that will be used when generating IP header.
ip-frag-off (; Default: )
ip-gateway (; Default: )
ip-id (; Default: )
ip-protocol (; Default: )
ip-src (; Default: )
ip-ttl (; Default: )
mac-dst (; Default: )
mac-protocol (; Default: )
mac-src (; Default: )
name (; Default: )
port (; Default: )
raw-header (; Default: )
udp-dst-port (; Default: )
udp-src-port (; Default: )
vlan-id (; Default: )
vlan-priority (; Default: )
vlan-protocol (; Default: )
header-stack (; Default: )

Port Configuration

Sub-menu /tool packet-generator port


This menu allows to configure ports that will be associated to specific interface and will be used to receive/send generated packets.


Properties

Property Description
disabled (yes | no; Default: no) Whether port is disabled and does not participate in receiving/sending of the packets
name (string; Default: ) Descriptive name of the port
interface (string; Default: ) Name of the interface associated with the port.


Read-Only Properties

Property Description
dynamic (yes | no) Whether port configuration is generated automatically.
first-header (ip | mac | raw | udp | vlan) Shows suhhested first header for packets to be sent out of specified interface. This is information can be used when creating packet templates.
inactive (yes | no) Whether port is inactive and can't participate in tx/rx of the packets.

Stats

Sub-menu /tool traffic-generator stats


Properties

Property Description
(; Default: )


Streams

Properties

Property Description
disabled (yes | no; Default: no) Whether stream is disabled
mbps (integer [0..4294967295]; Default: 0) Value in Mega bits per second that stream will try to generate.
name (string; Default: ) Descriptive name of the stream.
num (integer [0..15]; Default: 0)
packet-size (integer[1..65535] [-integer[1..65535]]; Default: 0) Generated size of the packets in bytes. Can be set as the range for random packet size generation.
port (string; Default: ) Name of the port from Port menu that will be used to transmit packets.
pps (integer [0..4294967295]; Default: 0) Packets per second that stream will try to generate.
tx-template (string; Default: ) Name of the packet template from packet-template or raw-packet-template menus used as the packet content source.

Configuration Examples

[ Top | Back to Content ]