httpstat:用 Go 重新定义 HTTP 性能可视化
缘起:一个 Python 脚本的 Go 重生
httpstat 最初是 Reorx 用 Python 写的一个小工具,灵感来自 curl 的 -w 参数和 time 命令的结合体。它的核心价值在于:把一次 HTTP 请求的各个耗时阶段用可视化的时间线拆解出来,让你一眼看出慢在哪。
Dave Cheney 用 Go 重写了它,项目地址 davecheney/httpstat,这个版本有几个非常实际的好处:
- 单二进制分发:编译出来就是一个可执行文件,没有 Python 运行时依赖,扔到任何 Linux 机器上都能跑
- 完整的 TLS 指标:利用了 Go
crypto/tls包暴露的ConnectionState,可以拿到 TLS 握手的详细阶段耗时(Python/OpenSSL 那边拿不到这么细) - 与 curl 参数兼容:大部分 curl 常用参数(
-k、-H、-d、-u、-o等)都原样支持
它长什么样
跑一下 httpstat https://example.com,你会看到类似这样的输出:
Connected to 93.184.216.34:443
DNS Lookup TCP Connection TLS Handshake Server Processing Content Transfer
[ 5ms | 12ms | 45ms | 89ms | 3ms ]
| | | | |
namelookup:5ms | | | |
connect:17ms | | |
pretransfer:62ms | |
starttransfer:151ms |
total:154ms
这张图的信息密度很高,对应了 HTTP 请求生命周期的几个关键节点:
| 阶段 | 含义 | 常见瓶颈 |
|---|---|---|
| DNS Lookup | 域名解析耗时 | 本地 DNS 慢、没走缓存、CDN 调度问题 |
| TCP Connection | TCP 三次握手 | 跨地域延迟高、丢包重传 |
| TLS Handshake | TLS 协商(含证书验证) | 证书链过长、OCSP 慢、TLS 版本/加密套件协商 |
| Server Processing | 从请求发出到首字节返回 | 服务端处理逻辑慢、后端依赖超时 |
| Content Transfer | 响应体传输耗时 | 带宽、响应体过大、压缩未开启 |
左侧的聚合指标——namelookup、connect、pretransfer、starttransfer、total——命名直接对齐了 curl 的 -w 变量,方便你把已有的监控脚本迁移过来对比。
为什么用 Go 重写特别合适
1. Go 的 httptrace 是天生为此设计的
Go 标准库从 1.7 开始提供 net/http/httptrace 包,它通过 context.Context 注入一系列回调,让调用方精确捕获请求的每个阶段:
trace := &httptrace.ClientTrace{
DNSStart: func(info httptrace.DNSStartInfo) { ... },
DNSDone: func(info httptrace.DNSDoneInfo) { ... },
ConnectStart: func(network, addr string) { ... },
ConnectDone: func(network, addr string, err error) { ... },
TLSHandshakeStart: func() { ... },
TLSHandshakeDone: func(state tls.ConnectionState, err error) { ... },
GotConn: func(info httptrace.GotConnInfo) { ... },
WroteRequest: func(info httptrace.WroteRequestInfo) { ... },
GotFirstResponseByte: func() { ... },
}
req = req.WithContext(httptrace.WithClientTrace(ctx, trace))
httpstat 的核心逻辑就是注册这一串回调,在每次回调里打一个 time.Now() 时间戳,最后拼装成时间线。这正是 Go 相比于 Python 实现的天然优势——不用 hook socket 层或依赖外部代理,标准库直接给你阶段级的可观测性。
2. TLS 指标可以做到极致细腻
TLSHandshakeDone 回调里拿到的 tls.ConnectionState 包含 HandshakeComplete、Version、CipherSuite、NegotiatedProtocol(ALPN,可以判断是否走了 HTTP/2)等字段。httpstat 在详细模式下会把这些都打出来,对于排查”为什么这个 HTTPS 站点比 http 慢那么多”这类问题极其有用。
3. HTTP/2 支持
Go 的 http.Transport 默认对 HTTPS 站点协商 HTTP/2。这在很多诊断场景里非常关键——HTTP/2 的多路复用会显著改变耗时模型,用 curl 检查时如果不带 --http2 可能看到完全不同的人体工学。httpstat 默认就跟 Go 的立场一致。
常用姿势
# 基本用法
httpstat https://api.example.com/v1/users
# 跳过 TLS 验证(自签证书环境)
httpstat -k https://internal.service/
# 带请求头和 body
httpstat -X POST -H "Content-Type: application/json" \
-d '{"name":"alice"}' https://api.example.com/users
# Basic Auth
httpstat -u user:pass https://protected.example.com/
# 保存响应到文件(只看时间线)
httpstat -o /dev/null https://cdn.example.com/large.bin
# 加自定义请求头
httpstat -H "Authorization: Bearer xxx" https://api.example.com/
和同类工具的比较
| 工具 | 优势 | 局限 |
|---|---|---|
| curl -w | 无处不在,无需安装 | 输出要自己格式化,TLS 阶段拿不到细分 |
| httpstat (Go) | 单二进制、可视化、TLS 细节、参数兼容 | 只测单次请求,没有批量/并发能力 |
| hey / wrk | 并发压测 | 不展示单次请求的阶段耗时 |
| Chrome DevTools | 可视化最完整 | 只能在浏览器里用,难以脚本化 |
httpstat 的定位很清晰:一次请求的全景透视。它不做压测、不做批处理,就是让你在一个终端里把”慢在哪”这个问题回答清楚。
一个实践技巧:搭配 --trace 排查重定向
当目标 URL 发生 301⁄302 时,时间线会变得迷惑——你看到的总耗时可能来自多次请求。httpstat 支持 curl 的 -L 走重定向,此时建议重点关注 starttransfer 和 total 的差值:每次重定向都意味着一次完整的 DNS→TCP→TLS→Server 循环,如果差距悬殊,说明重定向链路本身在拖后腿。
另外,把 httpstat 的输出接到日志里,可以在 CI 或发布验证阶段自动化采集——比如针对关键 API 做一次”冒烟检测”,把时间线写入监控指标,长期对比可以发现 TLS 握手等阶段的隐性劣化。
总结
davecheney/httpstat 是一个典型的“小工具、大洞察”项目。它本质上是用 Go 的 httptrace 和 crypto/tls 把 HTTP 请求拆解成可读的时间线,用不到 500 行的核心代码,解决了运维和开发排查性能问题的一大痛点。
对于任何需要跟网络故障打交道的人——无论是怀疑 CDN 慢的前端、排查 TLS 劣化的 SRE,还是调试后端接口延迟的开发者——httpstat 都值得装进你的工具链。go install github.com/davecheney/httpstat@latest,一行命令,终身受益。



还没有评论,来说两句吧...