A Linux tool to measure the network transport layer latency.
-
Support network transport layer latency measurement (round-trip latency).
-
Support specifying ping message size, and ping interval.
-
Support two test modes: test-duration mode and ping-iteration mode.
-
Support CPU affinity.
-
Support running in background (daemon).
cd src
mkdir build
cd build
cmake ..
cmake --build .
cmake --build . --target install
lagscope -h
- UDP is not supported.
To measure the network TCP latency between two multi-core serves running Ubuntu 1604, NODE1 (192.168.4.1) and NODE2 (192.168.4.2).
On NODE1 (the receiver), run:
./lagscope -r
(Translation: Run lagscope as a receiver with default settings. See the output from ./lagscope -h for more details about the default settings.)
On NODE2 (the sender), run:
./lagscope -s192.168.4.1 -H -a 10 -l 1 -c 98
(Translation: Run lagscope as a sender, with default test settings; report histogram value with customized factors.)
Example sender-side output from a given run:
simonxiao@NODE2:~/lagscope/src# ./lagscope -s192.168.4.1 -H -a 10 -l 1 -c 98
lagscope 0.1.1
---------------------------------------------------------
13:19:44 INFO: New connection: local:13948 [socket:3] --> 192.168.4.1:6001
13:36:24 INFO: TEST COMPLETED.
13:36:24 INFO: Ping statistics for 192.168.4.1:
13:36:24 INFO: Number of successful Pings: 1000000
13:36:24 INFO: Minimum = 30.994us, Maximum = 8699.894us, Average = 54.063us
Interval(usec) Frequency
0 0
10 0
11 0
12 0
...
50 75086
51 116062
52 36401
53 27288
54 19781
55 16578
56 29390
57 8965
58 8980
59 8812
60 8418
...
100 519
101 472
102 849
103 324
104 324
105 327
106 291
107 288
108 6107
On NODE2 (the sender), run:
./lagscope -s192.168.4.1 -P
(Translation: Run lagscope as a sender. Prints these percentiles of the latencies: 50%, 75%, 90%, 99%, 99.9%, 99.99%, 99.999%.)
Option for dumping the latency frequency table into a JSON file, run:
./lagscope -s192.168.4.1 -Platencies_table.json
(Translation: Run lagscope as a sender. Prints percentiles and dumps a latency frequency table into a JSON file)
Example sender-side output from a given run:
paulkim@NODE2:~/lagscope/src# ./lagscope -s192.168.4.1 -P
lagscope 0.1.2
---------------------------------------------------------
17:49:03 INFO: New connection: local:13948 [socket:3] --> 192.168.4.1:6001
17:50:37 INFO: TEST COMPLETED.
17:50:37 INFO: Ping statistics for 192.168.4.1:
17:50:37 INFO: Number of successful Pings: 1000000
17:50:37 INFO: Minimum = 72.002us, Maximum = 4552.126us, Average = 92.055us
Percentile Latency(us)
50% 80
75% 102
90% 113
99.9% 410
99.99% 2566
99.999% 3921
paulkim@NODE2:~/lagscope/src# ./lagscope -s192.168.4.1 -Platencies_table.json
lagscope 0.1.2
---------------------------------------------------------
17:49:03 INFO: New connection: local:13948 [socket:3] --> 192.168.4.1:6001
17:50:37 INFO: TEST COMPLETED.
17:50:37 INFO: Ping statistics for 192.168.4.1:
17:50:37 INFO: Number of successful Pings: 1000000
17:50:37 INFO: Minimum = 72.002us, Maximum = 4552.126us, Average = 92.055us
17:50:38 INFO: Dumping latency frequency table into json file: latencies_table.json
Percentile Latency(us)
50% 80
75% 102
90% 113
99.9% 410
99.99% 2566
99.999% 3921
On NODE2 (the sender), run:
./lagscope -s192.168.4.1 -Rlatencies_log.csv
(Translation: Run lagscope as a sender and dumps latencies into a csv file)
Example sender-side output from a given run:
paulkim@NODE2:~/lagscope/src# ./lagscope -s192.168.4.1 -Rlatencies_log.csv
lagscope 0.1.2
---------------------------------------------------------
19:38:31 INFO: New connection: local:13948 [socket:3] --> 192.168.4.1:6001
19:38:32 INFO: TEST COMPLETED.
19:38:32 INFO: Ping statistics for 192.168.4.1:
19:38:32 INFO: Number of successful Pings: 1000000
19:38:32 INFO: Minimum = 96.083us, Maximum = 2828.121us, Average = 147.913us
19:38:32 INFO: Dumping all latencies into csv file: latencies_log.csv
- Python3
- pip3
- matplotlib
- pandas
- numpy
To install libraries:
pip3 install matplotlib pandas numpy
Known Issue:
Missing module, tkinter, not installed with Python3.
To install tkinter:
sudo apt-get install python3-tk
python3 visualize_data.py -h
python3 visualize_data.py -json freq_table.json -img freq_graph.png
Example run:
paulkim@NODE2:~/lagscope/src# python3 visualize_data.py -json freq_table.json -img freq_graph.png
INFO: Graph construction from freq_table.json is in progress...
INFO: Graph construction completed
INFO: Graph created in: freq_graph.png
By downloading and running this project, you agree to the license terms of the third-party application software, Microsoft products, and components to be installed.
The third-party software and products are provided to you by third parties. You are responsible for reading and accepting the relevant license terms for all software that will be installed. Microsoft grants you no rights to third party software.
The MIT License (MIT)
Copyright (c) 2016 Microsoft Corporation
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.