microsoft/ethrPlattformübergreifende CLI für Netzwerkleistungstests über TCP, UDP, HTTP, HTTPS und ICMP: Bandbreite, Verbindungen/s, Pakete/s, Latenz, Verlust, Jitter, Ping und Traceroute.
Ethr ist ein plattformübergreifendes Netzwerkleistungsmessungstool, das in golang geschrieben ist. Das Ziel dieses Projekts ist es, ein natives Tool für umfassende Netzwerkleistungsmessungen von Bandbreite, Verbindungen/s, Paketen/s, Latenz, Verlust & Jitter über mehrere Protokolle wie TCP, UDP, HTTP, HTTPS und über mehrere Plattformen wie Windows, Linux und andere Unix-Systeme bereitzustellen.
Ethr lässt sich von bestehenden Open-Source-Netzwerkleistungstools inspirieren und baut auf deren Ideen auf. Für die Bandbreitenmessung ähnelt es iPerf3 für TCP- und UDP-Datenverkehr. iPerf3 bietet viele weitere Optionen wie etwa gedrosselte Tests und einen umfangreicheren Funktionsumfang, während Ethr mehrere Threads unterstützt, sodass es auf 1024 oder sogar mehr Verbindungen skaliert, die Kommunikation mehrerer Clients mit einem einzelnen Server usw. ermöglicht. Für Latenzmessungen ähnelt es latte unter Windows oder sockperf unter Linux.
Ethr bietet im Vergleich zu anderen Tools mehr Testmessungen, z. B. Messungen für Bandbreite, Verbindungen/s, Pakete/s, Latenz und die Latenz beim TCP-Verbindungsaufbau – alles in einem einzigen Tool. In Zukunft sind weitere Funktionen (in der Hoffnung auf Beiträge von anderen) sowie zusätzliche Protokollunterstützung geplant, um es zu einem umfassenden Werkzeug für Netzwerkleistungsmessungen zu machen.
Dank golang ist Ethr nativ plattformübergreifend, anders als bei der Kompilierung über eine Abstraktionsebene wie Cygwin, die die Funktionalität einschränken kann. Es möchte die Leistungsmessung vereinheitlichen, indem es die Funktionalität von Tools wie iPerf3, ntttcp, psping, sockperf und latte kombiniert und ein einziges Tool für mehrere Plattformen und mehrere Protokolle bietet.
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
Hinweis: Zum Erstellen aus dem Quellcode wird Go Version 1.11 oder höher benötigt.
Wir verwenden go-module zur Verwaltung der Ethr-Abhängigkeiten. Weitere Informationen finden Sie unter Verwendung von go-modules!
git clone https://github.com/Microsoft/ethr.git
cd ethr
go build
Wenn ethr innerhalb des $GOPATH/src-Verzeichnisbaums geklont wurde, stellen Sie sicher, dass Sie den Befehl go mit GO111MODULE=on ausführen!
Image mit folgendem Befehl erstellen:
docker build -t microsoft/ethr .
Binärdatei erstellen:
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
go get github.com/microsoft/ethr
Angenommen, Sie verwenden yay (https://github.com/Jguer/yay):
yay -S ethr
Folgen Sie dem Abschnitt „Aus dem Quellcode erstellen“, um ethr.exe zu erstellen.
Ändern Sie ethr.nuspec, um eine neue Release-Version hinzuzufügen.
vim ethr.nuspec
Erstellen Sie ein Nuget-Paket (z. B. Ethr.0.2.1.nupkg).
nuget.exe pack ethr.nuspec
Laden Sie das Paket auf nuget.org hoch.
Hilfe:
ethr -h
Server:
ethr -s
Server mit Text-UI:
ethr -s -ui
Client:
ethr -c <server ip>
Beispiele:
// Start server
ethr -s
// Start client for default (bandwidth) test measurement using 1 thread
ethr -c localhost
// Start bandwidth test using 8 threads
ethr -c localhost -n 8
// Start connections/s test using 64 threads to server 10.1.0.11
ethr -c 10.1.0.11 -t c -n 64
// Run Ethr server on port 9999
./ethr -s -port 9999
// Measure TCP connection setup latency to ethr server on port 9999
// Assuming Ethr server is running on server with IP address: 10.1.1.100
./ethr -c 10.1.1.100 -p tcp -t pi -d 0 -4 -port 9999
// Measure TCP connection setup latency to www.github.com at port 443
./ethr -x www.github.com:443 -p tcp -t pi -d 0 -4
// Measure TCP connection setup latency to www.github.com at port 443
// Note: Here port 443 is driven automatically from https
./ethr -x https://www.github.com -p tcp -t pi -d 0 -4
// Measure ICMP ping latency to www.github.com
sudo ./ethr -x www.github.com -p icmp -t pi -d 0 -4
// Run measurement similar to mtr on Linux
sudo ./ethr -x www.github.com -p icmp -t mtr -d 0 -4
// Measure packets/s over UDP by sending small 1-byte packets
./ethr -c 172.28.192.1 -p udp -t p -d 0
Für ICMP-bezogene Tests wie Ping, TraceRoute und MyTraceRoute muss unter Windows ICMP über die Firewall erlaubt sein. Dies kann mit PowerShell über die folgenden Befehle erfolgen. Verwenden Sie dies jedoch nur, wenn die Sicherheitsrichtlinie Ihrer Umgebung dies zulässt.
// Allow ICMP packets via Firewall for IPv4
New-NetFirewallRule -DisplayName "ICMP_Allow_Any" -Direction Inbound -Protocol ICMPv4 -IcmpType Any -Action Allow -Profile Any -RemotePort Any
// Allow ICMP packets via Firewall for IPv6
New-NetFirewallRule -DisplayName "ICMPV6_Allow_Any" -Direction Inbound -Protocol ICMPv6 -IcmpType Any -Action Allow -Profile Any -RemotePort Any
Darüber hinaus ist für TCP-basiertes TraceRoute und MyTraceRoute der Administratormodus erforderlich, da Ethr andernfalls keine ICMP-Nachrichten mit überschrittener TTL empfangen kann.
Für ICMP-Ping, ICMP/TCP-TraceRoute und MyTraceRoute ist der privilegierte Modus über sudo erforderlich.
-h
Help
-no
Disable logging to file. Logging to file is enabled by default.
-o <filename>
Name of log file. By default, following file names are used:
Server mode: 'ethrs.log'
Client mode: 'ethrc.log'
-debug
Enable debug information in logging output.
-4
Use only IP v4 version
-6
Use only IP v6 version
In this mode, Ethr runs as a server, allowing multiple clients to run
performance tests against it.
-s
Run in server mode.
-ip <string>
Bind to specified local IP address for TCP & UDP tests.
This must be a valid IPv4 or IPv6 address.
Default: <empty> - Any IP
-port <number>
Use specified port number for TCP & UDP tests.
Default: 8888
-ui
Show output in text UI.
In this mode, Ethr client can only talk to an Ethr server.
-c <server>
Run in client mode and connect to <server>.
Server is specified using name, FQDN or IP address.
-b <rate>
Transmit only Bits per second (format: <num>[K | M | G])
Only valid for Bandwidth tests. Default: 0 - Unlimited
Examples: 100 (100bits/s), 1M (1Mbits/s).
-cport <number>
Use specified local port number in client for TCP & UDP tests.
Default: 0 - Ephemeral Port
-d <duration>
Duration for the test (format: <num>[ms | s | m | h]
0: Run forever
Default: 10s
-g <gap>
Time interval between successive measurements (format: <num>[ms | s | m | h]
Only valid for latency, ping and traceRoute tests.
0: No gap
Default: 1s
-i <iterations>
Number of round trip iterations for each latency measurement.
Only valid for latency testing.
Default: 1000
-ip <string>
Bind to specified local IP address for TCP & UDP tests.
This must be a valid IPv4 or IPv6 address.
Default: <empty> - Any IP
-l <length>
Length of buffer to use (format: <num>[KB | MB | GB])
Only valid for Bandwidth tests. Max 1GB.
Default: 16KB
-n <number>
Number of Parallel Sessions (and Threads).
0: Equal to number of CPUs
Default: 1
-p <protocol>
Protocol ("tcp", "udp", "http", "https", or "icmp")
Default: tcp
-port <number>
Use specified port number for TCP & UDP tests.
Default: 8888
-r
For Bandwidth tests, send data from server to client.
-t <test>
Test to run ("b", "c", "p", "l", "cl" or "tr")
b: Bandwidth
c: Connections/s
p: Packets/s
l: Latency, Loss & Jitter
pi: Ping Loss & Latency
tr: TraceRoute
mtr: MyTraceRoute with Loss & Latency
Default: b - Bandwidth measurement.
-tos
Specifies 8-bit value to use in IPv4 TOS field or IPv6 Traffic Class field.
-w <number>
Use specified number of iterations for warmup.
Default: 1
-T <string>
Use the given title in log files for logging results.
Default: <empty>
In this mode, Ethr talks to a non-Ethr server. This mode supports only a
few types of measurements, such as Ping, Connections/s and TraceRoute.
-x <destination>
Run in external client mode and connect to <destination>.
<destination> is specified in URL or Host:Port format.
For URL, if port is not specified, it is assumed to be 80 for http and 443 for https.
Example: For TCP - www.microsoft.com:443 or 10.1.0.4:22 or https://www.github.com
For ICMP - www.microsoft.com or 10.1.0.4
-cport <number>
Use specified local port number in client for TCP & UDP tests.
Default: 0 - Ephemeral Port
-d <duration>
Duration for the test (format: <num>[ms | s | m | h]
0: Run forever
Default: 10s
-g <gap>
Time interval between successive measurements (format: <num>[ms | s | m | h]
Only valid for latency, ping and traceRoute tests.
0: No gap
Default: 1s
-ip <string>
Bind to specified local IP address for TCP & UDP tests.
This must be a valid IPv4 or IPv6 address.
Default: <empty> - Any IP
-n <number>
Number of Parallel Sessions (and Threads).
0: Equal to number of CPUs
Default: 1
-p <protocol>
Protocol ("tcp", or "icmp")
Default: tcp
-t <test>
Test to run ("c", "cl", or "tr")
c: Connections/s
pi: Ping Loss & Latency
tr: TraceRoute
mtr: MyTraceRoute with Loss & Latency
Default: pi - Ping Loss & Latency.
-tos
Specifies 8-bit value to use in IPv4 TOS field or IPv6 Traffic Class field.
-w <number>
Use specified number of iterations for warmup.
Default: 1
-T <string>
Use the given title in log files for logging results.
Default: <empty>
Windows
Getestet: Windows 10, Windows 7 SP1
Nicht getestet: Andere Windows-Versionen
Linux
Getestet: Ubuntu Linux 18.04.1 LTS, OpenSuse Leap 15
Nicht getestet: Andere Linux-Versionen
OSX
Getestet: OSX wird von Mitwirkenden getestet
Andere
Derzeit werden keine anderen Plattformen getestet
Die Arbeitspunkte der Todo-Liste sind unten aufgeführt. Beiträge zu diesen Arbeitspunkten oder zu anderen Funktionen und Fehlerbehebungen sind sehr willkommen.
Dieses Projekt begrüßt Beiträge und Vorschläge. Die meisten Beiträge erfordern, dass Sie einer Contributor License Agreement (CLA) zustimmen, in der Sie erklären, dass Sie das Recht haben, uns die Rechte zur Nutzung Ihres Beitrags zu gewähren, und dies auch tatsächlich tun. Einzelheiten finden Sie unter https://cla.microsoft.com.
Wenn Sie einen Pull Request einreichen, wird ein CLA-Bot automatisch feststellen, ob Sie eine CLA bereitstellen müssen, und den PR entsprechend kennzeichnen (z. B. Label, Kommentar). Befolgen Sie einfach die Anweisungen des Bots. Sie müssen dies nur einmal für alle Repos tun, die unsere CLA verwenden.
Dieses Projekt hat den Microsoft Open Source Code of Conduct übernommen. Weitere Informationen finden Sie in den Code of Conduct FAQ oder wenden Sie sich bei weiteren Fragen oder Kommentaren an [email protected].
| Protocol | Bandbreite | Verbindungen/s | Pakete/s | Latenz | Ping | TraceRoute | MyTraceRoute |
|---|
| TCP | Ja | Ja | NA | Ja | Ja | Ja | Ja |
| UDP | Ja | NA | Ja | Nein | NA | Nein | Nein |
| ICMP | Nein | NA | NA | NA | Ja | Ja | Ja |