httpstat
Visualizes curl statistics with timing breakdowns of DNS, TCP, TLS, server processing, and content transfer.
httpstat is a Python wrapper around curl that provides detailed timing visualization for HTTP requests. It displays a breakdown of connection phases including DNS resolution, TCP connection, TLS handshake, server processing time, and content transfer in a color-coded terminal output.
The tool offers structured JSON output with a stable v1 schema for programmatic consumption, making it suitable for monitoring and automation workflows. It includes SLO threshold checking that exits with code 4 when response times exceed specified limits for metrics like total time, connection time, or time to first byte. Results can be saved to files for multi-step workflows.
As a single-file Python script with no dependencies, httpstat is easy to deploy and works with Python 3. It accepts any curl options and supports environment variables for customizing behavior. The tool includes an agent skill for AI coding assistants to automatically diagnose HTTP performance issues and suggest fixes. It's primarily used by developers, DevOps engineers, and SREs for debugging API latency and HTTP performance analysis.
Installation
# via Homebrew
brew install httpstat
# via pip
pip install httpstat
# via Direct download
wget https://raw.githubusercontent.com/reorx/httpstat/master/httpstat.py
