microsoft/ethrCLI multiplataforma para pruebas de rendimiento de red sobre TCP, UDP, HTTP, HTTPS e ICMP: ancho de banda, conexiones/s, paquetes/s, latencia, pérdida, jitter, ping y traceroute.
Ethr es una herramienta multiplataforma de medición de rendimiento de red escrita en golang. El objetivo de este proyecto es proporcionar una herramienta nativa para mediciones exhaustivas del rendimiento de red: ancho de banda, conexiones/s, paquetes/s, latencia, pérdida y jitter, a través de múltiples protocolos como TCP, UDP, HTTP, HTTPS, y en múltiples plataformas como Windows, Linux y otros sistemas Unix.
Ethr se inspira en las herramientas open source existentes de medición de rendimiento de red y se basa en esas ideas. Para la medición de ancho de banda, es similar a iPerf3, para tráfico TCP y UDP. iPerf3 tiene muchas más opciones, como pruebas con límite de velocidad y un conjunto de funciones más amplio, mientras que Ethr admite múltiples hilos, lo que le permite escalar a 1024 o incluso un número mayor de conexiones, comunicación de múltiples clientes con un solo servidor, etc. Para mediciones de latencia, es similar a latte en Windows o sockperf en Linux.
Ethr ofrece más mediciones de prueba en comparación con otras herramientas; por ejemplo, proporciona mediciones de ancho de banda, conexiones/s, paquetes/s, latencia y latencia de establecimiento de conexión TCP, todo en una sola herramienta. En el futuro, hay planes para añadir más funciones (con la esperanza de que otros contribuyan), así como soporte para más protocolos, para convertirlo en una herramienta integral para la medición del rendimiento de la red.
Ethr es nativamente multiplataforma, gracias a golang, en comparación con la compilación mediante una capa de abstracción como cygwin que puede limitar la funcionalidad. Espera unificar la medición del rendimiento combinando la funcionalidad de herramientas como iPerf3, ntttcp, psping, sockperf y latte, y ofreciendo una única herramienta en múltiples plataformas y múltiples protocolos.
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
Nota: se requiere la versión 1.11 de go o superior para compilarlo desde el código fuente.
Usamos go-module para gestionar las dependencias de Ethr. Para más información, consulta ¡cómo usar los go-modules!
git clone https://github.com/Microsoft/ethr.git
cd ethr
go build
Si ethr se clona dentro del árbol $GOPATH/src, asegúrate de invocar el comando go con GO111MODULE=on.
Construye la imagen con el comando:
docker build -t microsoft/ethr .
Generar el binario:
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
Asumiendo que estás usando yay (https://github.com/Jguer/yay):
yay -S ethr
Sigue el tema Compilación desde el código fuente para compilar ethr.exe.
Modifica ethr.nuspec para añadir la nueva versión de lanzamiento:
vim ethr.nuspec
Crea un paquete nuget (como Ethr.0.2.1.nupkg):
nuget.exe pack ethr.nuspec
Sube el paquete a nuget.org.
Ayuda:
ethr -h
Servidor:
ethr -s
Servidor con interfaz de texto:
ethr -s -ui
Cliente:
ethr -c <server ip>
Ejemplos:
// 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
Para las pruebas relacionadas con ICMP, Ping, TraceRoute, MyTraceRoute, Windows requiere que ICMP esté permitido a través del Firewall. Esto se puede hacer mediante PowerShell con los siguientes comandos. Sin embargo, úsalo solo si la política de seguridad de tu configuración lo permite.
// 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
Además, para TraceRoute y MyTraceRoute basados en TCP, se requiere el modo Administrador; de lo contrario, Ethr no podrá recibir los mensajes ICMP de TTL excedido.
Para ICMP Ping, TraceRoute y MyTraceRoute por ICMP/TCP, se requiere el modo privilegiado mediante 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
Probado: Windows 10, Windows 7 SP1
No probado: Otras versiones de Windows
Linux
Probado: Ubuntu Linux 18.04.1 LTS, OpenSuse Leap 15
No probado: Otras versiones de Linux
OSX
Probado: OSX es probado por los colaboradores.
Otros
Ninguna otra plataforma está probada en este momento.
Los elementos de trabajo de la lista de tareas pendientes se muestran a continuación. Las contribuciones son muy bienvenidas para estos elementos o para cualquier otra función y corrección de errores.
Este proyecto agradece contribuciones y sugerencias. La mayoría de las contribuciones requieren que aceptes un Acuerdo de Licencia de Colaborador (CLA) que declara que tienes el derecho, y de hecho lo otorgas, de concedernos los derechos para usar tu contribución. Para más detalles, visita https://cla.microsoft.com.
Cuando envías un pull request, un CLA-bot determinará automáticamente si necesitas proporcionar un CLA y decorará el PR adecuadamente (por ejemplo, etiqueta, comentario). Simplemente sigue las instrucciones del bot. Solo tendrás que hacerlo una vez en todos los repositorios que usan nuestro CLA.
Este proyecto ha adoptado el Código de Conducta de Código Abierto de Microsoft. Para más información, consulta las Preguntas frecuentes sobre el Código de Conducta o contacta con [email protected] si tienes preguntas o comentarios adicionales.
| Protocolo | Ancho de banda | Conexiones/s | Paquetes/s | Latencia | Ping | TraceRoute | MyTraceRoute |
|---|
| TCP | Sí | Sí | NA | Sí | Sí | Sí | Sí |
| UDP | Sí | NA | Sí | No | NA | No | No |
| ICMP | No | NA | NA | NA | Sí | Sí | Sí |