microsoft/ethrCLI multiplateforme pour les tests de performance réseau sur TCP, UDP, HTTP, HTTPS et ICMP : bande passante, connexions/s, paquets/s, latence, perte, gigue, ping et traceroute.
Ethr est un outil de mesure des performances réseau multiplateforme écrit en golang. L'objectif de ce projet est de fournir un outil natif pour des mesures complètes des performances réseau : bande passante, connexions/s, paquets/s, latence, pertes et gigue, sur plusieurs protocoles tels que TCP, UDP, HTTP, HTTPS, et sur plusieurs plateformes telles que Windows, Linux et d'autres systèmes Unix.
Ethr s'inspire des outils open source existants de mesure des performances réseau et s'appuie sur ces idées. Pour la mesure de la bande passante, il est similaire à iPerf3 pour le trafic TCP et UDP. iPerf3 offre de nombreuses autres options, comme les tests à débit limité et un ensemble de fonctionnalités plus riche, tandis qu'Ethr prend en charge plusieurs threads, ce qui lui permet de passer à l'échelle avec 1024 connexions ou plus, plusieurs clients communiquant avec un seul serveur, etc. Pour les mesures de latence, il est similaire à latte sur Windows ou à sockperf sur Linux.
Ethr fournit davantage de mesures de test que les autres outils, par exemple des mesures de bande passante, de connexions/s, de paquets/s, de latence et de latence d'établissement de connexion TCP, le tout dans un seul outil. À l'avenir, il est prévu d'ajouter d'autres fonctionnalités (en espérant que d'autres contributeurs se joignent) ainsi qu'une meilleure prise en charge des protocoles pour en faire un outil complet de mesure des performances réseau.
Ethr est nativement multiplateforme, grâce à golang, par rapport à une compilation via une couche d'abstraction comme cygwin qui peut limiter les fonctionnalités. Il espère unifier la mesure des performances en combinant les fonctionnalités d'outils comme iPerf3, ntttcp, psping, sockperf et latte, et en offrant un outil unique sur plusieurs plateformes et plusieurs protocoles.
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
Remarque : la version 1.11 ou supérieure de go est requise pour compiler à partir des sources.
Nous utilisons go-module pour gérer les dépendances d'Ethr. Pour plus d'informations, consultez comment utiliser les go-modules !
git clone https://github.com/Microsoft/ethr.git
cd ethr
go build
Si ethr est cloné dans l'arborescence $GOPATH/src, assurez-vous d'invoquer la commande go avec GO111MODULE=on !
Construire l'image avec la commande :
docker build -t microsoft/ethr .
Générer le binaire :
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
En supposant que vous utilisez yay (https://github.com/Jguer/yay) :
yay -S ethr
Suivez la section Compilation à partir des sources pour générer ethr.exe
Modifiez ethr.nuspec pour ajouter la nouvelle version de publication
vim ethr.nuspec
Créez un package nuget (par exemple Ethr.0.2.1.nupkg)
nuget.exe pack ethr.nuspec
Téléversez le package sur nuget.org.
Aide :
ethr -h
Serveur :
ethr -s
Serveur avec interface texte :
ethr -s -ui
Client :
ethr -c <server ip>
Exemples :
// 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
Pour les tests liés à ICMP, Ping, TraceRoute, MyTraceRoute, Windows exige que l'ICMP soit autorisé via le pare-feu. Cela peut être fait en utilisant PowerShell avec les commandes suivantes. Cependant, n'utilisez cette méthode que si la politique de sécurité de votre configuration l'autorise.
// 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
De plus, pour TraceRoute et MyTraceRoute basés sur TCP, le mode Administrateur est requis, sinon Ethr ne pourra pas recevoir les messages ICMP de dépassement de TTL.
Pour ICMP Ping, TraceRoute et MyTraceRoute via ICMP/TCP, le mode privilégié est requis via sudo.
-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
Testé : Windows 10, Windows 7 SP1
Non testé : autres versions de Windows
Linux
Testé : Ubuntu Linux 18.04.1 LTS, OpenSuse Leap 15
Non testé : autres versions de Linux
OSX
Testé : OSX est testé par les contributeurs
Autre
Aucune autre plateforme n'est testée pour le moment
Les éléments de travail de la liste des tâches sont présentés ci-dessous. Les contributions sont les bienvenues pour ces éléments ou pour toute autre fonctionnalité et correction de bug.
Ce projet accueille favorablement les contributions et suggestions. La plupart des contributions nécessitent que vous acceptiez un contrat de licence de contributeur (CLA) déclarant que vous avez le droit de nous accorder, et que vous nous accordez effectivement, les droits d'utilisation de votre contribution. Pour plus de détails, consultez https://cla.microsoft.com.
Lorsque vous soumettez une pull request, un CLA-bot déterminera automatiquement si vous devez fournir un CLA et décorera la PR de manière appropriée (par exemple, étiquette, commentaire). Suivez simplement les instructions fournies par le bot. Vous n'aurez à le faire qu'une seule fois sur tous les dépôts utilisant notre CLA.
Ce projet a adopté le Code de conduite open source de Microsoft. Pour plus d'informations, consultez la FAQ du Code de conduite ou contactez [email protected] pour toute question ou commentaire supplémentaire.
| Protocole | Bande passante | Connexions/s | Paquets/s | Latence | Ping | TraceRoute | MyTraceRoute |
|---|
| TCP | Oui | Oui | N/A | Oui | Oui | Oui | Oui |
| UDP | Oui | N/A | Oui | Non | N/A | Non | Non |
| ICMP | Non | N/A | N/A | N/A | Oui | Oui | Oui |