reorx/httpstat
Httpstat
httpstat is a network latency diagnostic tool and HTTP request performance analyzer. It measures and visualizes the timings of DNS lookups, TCP connections, and TLS handshakes to identify specific network bottlenecks.
The project functions as a JSON HTTP metrics exporter and a service level objective validation tool. It compares captured network request timings against predefined performance thresholds to detect violations and can export structured timing and response data in JSON or JSONL formats.
The tool provides capabilities for automated API diagnostics and network latency troubleshooting. It supports the configuration of custom headers, request methods, and timeouts to verify endpoint behavior, while also providing skill definitions for AI agent integration to automate diagnostics.
Features
- HTTP Request Performance Analysis - Measures and visualizes DNS, TCP, and TLS timings to identify network bottlenecks and server latency.
- HTTP Request Performance Analyzers - Measures and visualizes DNS, TCP, and TLS handshake timings for individual HTTP requests.
- Curl-Based Request Engines - Uses a system curl wrapper to execute requests and capture precise network timing statistics.
- Network Diagnostics - Provides utilities for breaking down the stages of an HTTP request to identify specific network bottlenecks.
- Handshake Latency Breakdowns - Isolates delays in connection and handshaking by breaking down the individual stages of an HTTP request.
- Service Level Objective Validation - Compares network request timings against predefined service level objectives to detect performance violations.
- Request Timing Decompositions - Breaks down total request duration into discrete DNS, TCP, and TLS phases to pinpoint bottlenecks.
- Diagnostic JSON Reports - Outputs detailed request timing and response data in structured JSON or JSONL formats for automation.
- Metric Export Formats - Serializes performance and timing data into structured formats for external analysis pipelines.
- Network Performance Exit Codes - Compares captured network metrics against predefined limits to trigger non-zero exit codes upon violations.
- Network Diagnostic Automation - Collects structured timing metrics in JSON format to automate network diagnostic tracing and analysis.
- Performance Goal Validation - Compares timing metrics against defined service level objectives to identify performance limit violations.
- API Clients and Debuggers - Visualizes curl request statistics with color-coded output.
- Command Line Tools - Listed in the “Command Line Tools” section of the The Book Of Secret Knowledge awesome list.
- HTTP Security - Visualizes curl statistics with clarity and style.
