Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?

Latest commit

* v0.0.1-3865

* Release v0.0.1-3865

Git stats


Failed to load latest commit information.
Latest commit message
Commit time


A powerful traffic generator based on Open Traffic Generator API

Release v0.0.1-3865 Open Traffic Generator v0.11.1 snappi v0.11.1 news news Slack Status

Quick Demo  •  Quick Start  •  Key Features  •  Documentation  •  Use Cases  •  Roadmap  •  FAQ

What is Ixia-c ?

Ixia-c is a modern, powerful and API-driven traffic generator designed to cater to the needs of hyperscalers, network hardware vendors and hobbyists alike.

It is available for free and distributed / deployed as a multi-container application consisting of a controller, a traffic-engine and an app-usage-reporter.

As a reference implementation of Open Traffic Generator API, Ixia-c supports client SDKs in various languages, most prevalent being snappi (Python SDK).

Ixia-c Deployment for Bidirectional Traffic

Keysight also offers a well supported commercial version, Keysight Elastic Network Generator, with no restrictions on performance and scalability. Scripts written for the free version are compatible with this version.

Quick Demo

Quick Demo

Quick Start

Before proceeding, please ensure system prerequisites are met.

  • Deploy Ixia-c

    # start ixia-c controller
    docker run -d --network=host --accept-eula
    docker run --net=host -d
    # start ixia-c traffic engine on eth1 interface
    docker run -d --network=host --privileged     \
      -e ARG_IFACE_LIST="virtual@af_packet,eth1"  \
      -e OPT_NO_HUGEPAGES="Yes"                   \

    Once the containers are up, accessing https://controller-ip/docs/ will open up an interactive REST API documentation. Check out deployment guide for more details.

  • Generate Traffic using snappi

    # clone repo for test suites, useful helper scripts, deployment files, etc.
    git clone --recurse-submodules && cd ixia-c
    # install snappi
    python -m pip install --upgrade snappi==0.11.1
    # run a standalone script to generate TCP traffic and fetch metrics
    python snappi-tests/scripts/

    Upon successful run, you should see port metrics printed on console.

    Expand this section for overview of the script we just ran. For more details on snappi, checkout hello-snappi.
    import snappi
    # create a new API instance over HTTPS transport where location points to controller
    api = snappi.api(location="https://localhost:8443", verify=False)
    # OR
    # create a new API instance over gRPC transport where location points to controller
    api = snappi.api(location="localhost:40051", transport=snappi.Transport.GRPC)
    # create a config object to be pushed to controller
    config = api.config()
    # add a port with location pointing to traffic engine
    prt = config.ports.port(name='prt', location='localhost:5555')[-1]
    # add a flow and assign endpoints
    flw = config.flows.flow(name='flw')[-1]
    flw.tx_rx.port.tx_name =
    # configure 100 packets to be sent, each having a size of 128 bytes
    flw.size.fixed = 128
    flw.duration.fixed_packets.packets = 100
    # add Ethernet, IP and TCP protocol headers with defaults
    # push configuration
    # start transmitting configured flows
    ts = api.transmit_state()
    ts.state = ts.START
    # fetch & print port metrics
    req = api.metrics_request()
    req.port.port_names = []
  • Optionally, Generate Traffic Using curl

    We can also pass equivalent JSON configuration directly to ixia-c controller, without installing snappi, using curl.
    The detailed description of each node (and their attributes) in JSON configuration are well documented here.

    # push the contents of config file snappi-tests/configs/quickstart_snappi.json
    curl -k https://localhost:8443/config -H "Content-Type: application/json" -d @snappi-tests/configs/quickstart_snappi.json
    # start transmitting configured flows
    curl -k https://localhost:8443/control/transmit -H  "Content-Type: application/json" -d '{"state": "start"}'
    # fetch all port metrics
    curl -k https://localhost:8443/monitor/metrics -H  "Content-Type: application/json" -d '{"choice": "port"}}'

Key Features

  • High Performance
    • Run on servers or Keysight hardware (commercial version only)
    • Generate kbps to Tbps of traffic using same script
    • 10Gbps @ 64 byte frame size using one Xeon class core (commercial version only)
    • Built using DPDK
  • Fast REST API for automation
    • Easily integrate with test frameworks like pytest
    • Easily integrate into CI/CD pipelines with Jenkins, GitHub, GitLab
  • Up to 256 flows per port. Each Flow supports:
    • Packet Templates for Ethernet, VLAN, VXLAN, GTPv1, GTPv2, IPv4, IPv6, ICMP, ICMPv6, GRE, UDP, & TCP. More protocols are on the way.
    • Ability to use tools like Scapy to add headers for unsupported protocols.
    • Manipulation of any field in the packet headers
    • Patterns to modify common packet header fields to generate millions of unique packets
    • Ability to track flows based on common packet header fields
    • Configurable frame size
    • Rate specification in pps (packets per second) or % line-rate
    • Ability to send bursts
  • Statistics
    • Per port and per flow
    • One way latency measurements (min, max, average) on a per flow basis
  • Capture
    • Packets with filters
    • Write to PCAP or redirect to tcpdump