microsoft/ethr
Ethr
ethr is a command line network diagnostic tool and performance analyzer designed to measure throughput, latency, and packet loss across TCP, UDP, and ICMP protocols. It functions as a multi-threaded network throughput tester and a diagnostic utility for analyzing connection health between client and server endpoints.
The project differentiates itself through specialized diagnostics such as TCP retransmission monitoring and bidirectional path analysis to identify asymmetric performance differences. It provides the ability to evaluate the overhead of encrypted HTTPS connections and enforce specific IP versions to isolate protocol-specific bottlenecks.
Its broader capabilities cover network path tracing, jitter and delay analysis, and capacity testing to determine maximum packet and connection rates. The tool also extracts raw network metrics from the operating system and provides real-time interface statistics.
Measurement results and system events are rendered in structured terminal tables and can be exported to JSON files for offline auditing.
Features
- Network Throughput Measurement Tools - Quantifies maximum data transfer rates, latency, and packet loss across TCP, UDP, and ICMP protocols.
- Network Performance Benchmarks - Measures maximum throughput, bandwidth, and connection rates across TCP, UDP, and ICMP protocols.
- Self-Hosted Servers - Hosts a private listener that accepts incoming performance tests and displays the results.
- Network Performance Analyzers - Calculates bandwidth, jitter, and connection rates between client and server endpoints to analyze performance.
- Measurement Endpoint Hosting - Listens on specified ports for TCP and UDP traffic to serve as a measurement endpoint.
- Multi-Protocol Performance Tools - Analyzes throughput, latency, and packet loss across TCP, UDP, and ICMP protocols.
- Network Latency Measurements - Tracks the time data takes to travel between endpoints and the variation in that delay.
- TCP Connection Health Diagnostics - Identifies network instability by tracking TCP retransmissions and analyzing connection health through system statistics.
- Retransmission Tracing - Extracts TCP segment retransmission counts from the operating system to identify network instability.
- Network Statistics Extraction - Extracts raw network metrics and TCP retransmission counts directly from operating system control files and interface counters.
- OS Network Metric Extraction - Extracts TCP-specific statistics from the operating system to analyze connection health.
- Jitter Analysis - Measures round-trip time, packet loss, and jitter to evaluate the stability of network connections.
- Network Diagnostic CLI Tools - Provides a terminal-based interface for mapping network paths and monitoring real-time interface statistics.
- Network Interface Statistics Collectors - Collects transmit and receive packet and byte counts from active network interfaces.
- Network Latency Testing - Tracks round-trip time, jitter, and packet loss to evaluate the stability and delay of network connections.
- Network Statistics Tracking - Tracks network device throughput and TCP retransmissions over specific intervals for real-time analysis.
- Parallel Bandwidth Saturation - Uses concurrent connections to saturate network bandwidth and determine maximum packet and connection rates.
- Client-Server Deployment Modes - Allows executing server and client operations in a decoupled configuration across different hosts.
- Asymmetric Path Analysis - Executes reverse tests from server to client to identify performance differences between upload and download paths.
- Route Tracing - Maps the route packets take to reach a destination to diagnose routing issues.
- Network Protocol Testing - Compares network behavior and speed across different versions of IP and encrypted HTTPS connections.
- IP Version Filters - Restricts network tests to IPv4 or IPv6 to isolate protocol-specific performance bottlenecks.
- Network Troubleshooting Tools - Maps the route packets take to a destination to diagnose and resolve routing and connectivity issues.
- Packet Rate Benchmarking - Calculates the total number of packets transmitted per second over a network using specific packet sizes.
- Traffic Shaping - Controls network tests by enforcing specific IP versions or using SSL encryption to isolate performance bottlenecks.
- Massive Connection Rate Generators - Determines the number of successful connections per second a server can handle via parallel sessions.
- Domain Connectivity Tests - Runs connectivity tests such as ping and connection rate checks against remote servers.
- Network Bottleneck Diagnosis - Analyzes socket states and transmission limits to locate network throughput bottlenecks.
- Real-Time Network Monitors - Collects real-time interface statistics and data rates to monitor bandwidth usage and identify bottlenecks.
- HTTPS Performance Testing - Measures network throughput over encrypted SSL/TLS connections to evaluate encryption overhead.
- Asymmetric Path Measurements - Initiates TCP performance measurements from the server back to the client to identify asymmetric paths.
- Command Line Tools - Listed in the “Command Line Tools” section of the The Book Of Secret Knowledge awesome list.
- Network Security - Network performance measurement tool for TCP, UDP, and HTTP.
Star history
How this analysis was created: This summary and feature list were written by an AI model that read the project's README and public documentation pages. Each feature links to the documentation it came from; stars, license and language come straight from the GitHub API. The model does not read the source code, and the analysis is refreshed when the project is re-analysed. Learn more on our About page.
