microsoft /ethr
Ethr is a Comprehensive Network Measurement Tool for TCP, UDP & ICMP.
★ 5,871⑂ 405👁 118⑃ 99● 91▤ 5
More from this author
+0
Daily
5,871
stars
405
forks
118
watchers
99
prs
91
issues
5
releases
README
Ethr Ethr is a cross platform network performance measurement tool written in golang. The goal of this project is to provide a native tool for comprehensive network performance measurements of bandwidth, connections/s, packets/s, latency, loss & jitter, across multiple protocols such as TCP, UDP, HTTP, HTTPS, and across multiple platforms such as Windows, Linux and other Unix systems. Ethr takes inspiration from existing open source network performance tools and builds upon those ideas. For Bandwidth measurement, it is similar to iPerf3, for TCP & UDP traffic. iPerf3 has many more options for doing such as throttled testing, richer feature set, while Ethr has support for multiple threads, that allows it to scale to 1024 or even higher number of connections, multiple clients communication to a single server etc. For latency measurements, it is similar to latte on Windows or sockperf on Linux. Ethr provides more test measurements as compared to other tools, e.g. it provides measurements for bandwidth, connections/s, packets/s, latency, and TCP connection setup latency, all in a single tool. In the future, there are plans to add more features (hoping for others to contribute) as well as more protocol support to make it a comprehensive tool for network performance measurements. Ethr is natively cross platform, thanks to golang, as compared to compiling via an abstraction layer like cygwin that may limit functionality. It hopes to unify performance measurement by combining the functionality of tools like iPerf3, ntttcp, psping, sockperf, and latte and offering a single tool across multiple platforms and multiple protocols. Installation Download https://github.com/Microsoft/ethr/releases/latest Linux wget https://github.com/microsoft/ethr/releases/latest/download/ethr_linux.zip unzip ethr_linux.zip Windows Powershell wget https://github.com/microsoft/ethr/releases/latest/download/ethr_windows.zip -OutFile ethr_windows.zip Expand-Archive .\ethr_windows.zip -DestinationPath . OSX wget https://github.com/microsoft/ethr/releases/latest/download/ethr_osx.zip unzip ethr_osx.zip Building from Source Note: go version 1.11 or higher is required building it from the source. We use go-module to manage Ethr dependencies. for more information please check how to use go-modules! git clone https://github.com/Microsoft/ethr.git cd ethr go build If ethr is cloned inside of the $GOPATH/src tree, please make sure you invoke the go command with GO111MODULE=on! Docker Build image using command: docker build -t microsoft/ethr . Make binary: Linux docker run -e GOOS=linux -v $(pwd):/out microsoft/ethr make build-docker Windows docker run -e BINARY_NAME=ethr.exe -e GOOS=windows -v $(pwd):/out microsoft/ethr make build-docker OS X docker run -e BINARY_NAME=ethr -e GOOS=darwin -v $(pwd):/out microsoft/ethr make build-docker Using go get go get github.com/microsoft/ethr Using ArchLinux AUR Assuming you are using yay (http
Top issues
#13Export metrics11 comments · 2018-12-06#117localhost latency tests work, over network they do not...8 comments · 2020-08-10#57Support for HTTP requests/s7 comments · 2018-12-28#21Add UDP based latency testing.5 comments · 2018-12-07#171Bandwidth measurements are not accurate4 comments · 2022-02-10#60TCP statistics (segment retransmit) is not working - open /proc/net/snmp: no such file or directory4 comments · 2018-12-31#1802 Docker build issues with easy fix3 comments · 2023-02-21#161http/https protocol is unavailable in 1.0.03 comments · 2021-10-05
Latest release
Ethr v1.0.0 v1.0.0 2020-12-05This is stable release for Ethr with code fixes, cleanup and addition of following features: - Throttling support using -b - Support for local IP using -ip - Title for the client side using -T - IP ToS support - Detection of admin/sudo for Windows & Linux respectively.