This is an archive of the ONOS 1.1 wiki. For the current ONOS wiki, look here.


This experiment is to measure how ONOS as a cluster in various sizes, reacts to a topology event. The type of topology events  tested include: 1) a switch connects/disconnects to an ONOS node; 2) a link comes up and down on an exiting topology. ONOS being a distributed system architecture,  may incurs additional delay to propagate a topology event when as a multi-node cluster compared with when standalone. While the latency in standalone mode should be limited, it is also desirable to reduce any additional delays incurs in a clustered ONOS due to the need of East-West wise communication of the events.

Setup and Method - Switch Connect/Disconnect Latency:

The following diagram illustrates the test setup. A switch connect event is generated from a “floating” (i.e. no data pathe port and links) OVS (OF1.3) by issuing “set-controller” command for the OVS bridge to initiate connection to ONOS1.  We capture “on the wire” timestamps on the OF control network with the tshark tool, as well as ONOS Device and Graph timestamps recorded in ONOS using “topology-event-metrics” app. By collating those timestamps, we come up with a "end-to-end" timing profile of the events from initial event triggering to when ONOS registers the event in its topology.

The key timing captures are the following:

  1. Device initiate connection t0, tcp syn/ack;

  2. Openflow protocol exchanges:

    • t0 -> ONOS Features Reply;

    • OVS Features Reply -> ONOS Role Request; (ONOS processing of mastership election for the device happens here)

    • ONOS Role Request -> OVS Role Reply - completes the initial OF protocol exchanges;

  3. ONOS core processing of the event:

    • A Device Event is triggered upon OF protocol exchange completes;

    • A Topology (Graph) Event is triggered from the local node Device Event.

Likewise, for testing a switch disconnect event, we use the ovs command "del-controller" to disconnect the above switch from its ONOS node. Timestamps captured are the following:

  1. OVS tcp syn/fin (t0);
  2. OVS tcp fin;
  3. ONOS Device Event;
  4. ONOS Graph Event (t1).

The switch disconnect end-to-end latency is the (t1 - t0).

As we scale ONOS cluster size, we only connect and disconnect the switch on ONOS1 and record the event timestamps on all nodes. The overall latency of the cluster is the latest node in the cluster reporting the Graph Event. In our test script, we run multiple iteration (ex. 20 iterations) of a test to gather statistical results.

Setup and Method - Link Up/Down Latency:

When testing for a link up/down event latency, we use a similar methodology as in switch-connect test, except that we use two OVS switches to create the link (we use mininet to create a simple linear two switch topology). Both switches' masterships belongs to ONOS1 . Referring to the diagram below. After initially establish switch-controller connections. By setting one of the switches’ interface up or down, we generate the port up or down events as the trigger for this test.

Some of the key timestamps are recorded, as described below:

  1. Switch port brought up/down, t0;

  2. OF PortStatus Update message sent from OVS to ONOS1; 

    2a. in the case of port up, ONOS reacts with link discovery events by sending link discovery message out to each OVS switch, and receiving Openflow PacketIn’s from the other OVS switch .

  3. ONOS core processing of the events:

    • A Device event is generated by the OF port status message; (ONOS processing)

    • On link down, a Link Event is generated locally on the nodes triggered by the Device Event; on link up, a Link Event is generated upon completion of the link discovery PacketIn/out; (mostly timing due to OFP messaging and ONOS processing)

    • A Graph Event is generated locally on the nodes. (ONOS processing)

Similar to the switch-connect test, we consider the latest node in the cluster having registered the Graph event as the latency for the cluster.



Switch-add Event:

Bar chart for Switch Up Latency Tests (Mean) TCP(syn/ack) -> Graph Event showing Latency(ms) by Cluster ScaleBar chart for Switch Down Latency Tests (Mean) TCP(fin/ack) -> Graph Event showing Latency(ms) by Cluster Scale


Link Up/Down Event:

Bar chart for Link Up Latency Tests (Mean) OPF port_status -> Graph Event showing Latency (ms) by Cluster ScaleBar chart for Link Down Latency Tests (Mean) OPF port_status_update -> Graph Event showing Latency (ms) by Cluster Scale

Analysis and Conclusions:

Switch Connect/Disconnect Event:

On connecting a switch to ONOS, the notable key timing breakdowns are:

  1. The largest portion of time spent in the discovery is from initial tcp connection to Openflow features-reply message received on ONOS. A further dissecting of the packets (not shown in the result graph), we can see majority of this time spent is ONOS waiting for OVS switch responding to its features_request in the initial Openflow handshake between the controller and the switch. This is a timing largely independent of ONOS processing.
  2. The second largest portion of the time spent is between "OFP feature reply -> OFP role request". This timing also increases with the ONOS cluster scale. This is the time spent when ONOS processes mastership election for the newly attached switch. ONOS if in standalone processes this locally, while in a multi-node cluster, additional delay incurs with   communication among nodes.
  3. The next time consuming process is from the Openflow handshake completes (OFP role reply), to when ONOS registers a Device event. This ONOS processing time is also affected by multi-node ONOS configuration This event requires ONOS writing of the event to the Device Store.
  4. The last timing is related to ONOS' node locally processing the Device event from the Device Store to registering Topology event in the Graph.

On a switch down event, there is a slight increase of ONOS triggering Device event as cluster size scales.

In conclusion, the overall end-to-end timing of a switch connect event is dominated by OVS response time on a feature-request during the Openflow message exchange. Subsequently, ONOS spends approx. 9 ms to process the mastership election. Both switch connect and disconnect timing increases when ONOS in a multi-node cluster due to the needs to communicate the election among the nodes.


Link Up/Down Events:

The first observation of this test is that the link-up event take substantial longer time than a link-down event. From timing break down, we can see the the port-up event at the OVS triggers extra ONOS activities, mainly for processing link discovery. This timing also is affected by having multi-node ONOS more than standalone ONOS. Otherwise, most of the ONOS core processing time incur in the low single-digit millisecond level to register the topology event to the Graph. 


In most of the network operation situations, while low overall topology event latency is desirable, switch/link down event is  more crucial, because they are considered more as an adverse events to applications. Applications can reacts to those adverse events quicker when ONOS can detect them faster.  We show that ONOS in this release is capable of single-digit millisecond switch/link down detection time.


  • No labels