Table Of Contents
Table Of Contents

Measuring Residence Time

Goals

In this example we explore the packet residence time statistics of network nodes.

INET version: 4.4

The Model

The packet residence time is measured from the moment a packet enters a network node up to the moment the same packet leaves the network node. This statistic is also collected for packets which are created and/or destroyed in network nodes.

Here is the network:

../../../../_images/Network7.png

Here is the configuration:

[General]
network = ResidenceTimeMeasurementShowcase
description = "Measure packet residence time in all network nodes"
sim-time-limit = 1s

# source application ~96Mbps throughput
*.source.numApps = 1
*.source.app[0].typename = "UdpSourceApp"
*.source.app[0].source.packetLength = 1200B
*.source.app[0].source.productionInterval = exponential(100us)
*.source.app[0].io.destAddress = "destination"
*.source.app[0].io.destPort = 1000

# destination application
*.destination.numApps = 1
*.destination.app[0].typename = "UdpSinkApp"
*.destination.app[0].io.localPort = 1000

# enable packet residence time measurer in all network nodes
*.*.measurer.typename = "ResidenceTimeMeasurer"

Results

Here are the results:

../../../../_images/SourceHistogram.png
../../../../_images/SourceVector.png
../../../../_images/SwitchHistogram.png
../../../../_images/SwitchVector.png
../../../../_images/DestinationHistogram.png
../../../../_images/DestinationVector.png

Sources: omnetpp.ini, ResidenceTimeMeasurementShowcase.ned

Try It Yourself

If you already have INET and OMNeT++ installed, start the IDE by typing omnetpp, import the INET project into the IDE, then navigate to the inet/showcases/measurement/residencetime folder in the Project Explorer. There, you can view and edit the showcase files, run simulations, and analyze results.

Otherwise, there is an easy way to install INET and OMNeT++ using opp_env, and run the simulation interactively. Ensure that opp_env is installed on your system, then execute:

$ opp_env run inet-4.4 --init -w inet-workspace --install --chdir \
   -c 'cd inet-4.4.*/showcases/measurement/residencetime && inet'

This command creates an inet-workspace directory, installs the appropriate versions of INET and OMNeT++ within it, and launches the inet command in the showcase directory for interactive simulation.

Alternatively, for a more hands-on experience, you can first set up the workspace and then open an interactive shell:

$ opp_env install --init -w inet-workspace inet-4.4
$ cd inet-workspace
$ opp_env shell

Inside the shell, start the IDE by typing omnetpp, import the INET project, then start exploring.

Discussion

Use this page in the GitHub issue tracker for commenting on this showcase.