Go / 系统课时
使用 httptrace 分解延迟
使用 httptrace 分解延迟
一次 HTTP 调用“很慢”并不能直接说明服务端慢。net/http/httptrace 可以把单次客户端请求拆成连接获取、DNS、TCP 连接、TLS 握手、请求写入和首字节等待等事件,让你根据时间线判断延迟发生在哪一段。([Go][1])
学习目标
- 为单次 HTTP 请求挂载
httptrace.ClientTrace - 区分 DNS、建连、TLS、连接获取和首字节等待时间
- 根据连接复用信息判断是否需要继续排查连接池或服务端
先把总延迟拆成事件
GetConn 在获取或创建连接前触发,GotConn 在连接可用后触发;DNSStart/DNSDone、ConnectStart/ConnectDone 和 TLSHandshakeStart/TLSHandshakeDone 分别覆盖名称解析、TCP 建连和 TLS 握手。GotFirstResponseByte 表示响应头的第一个字节已经到达。([Go Packages][2])

记录一次真实请求
下面程序默认请求 https://example.com,用相对请求开始时间打印关键事件。示例直接在回调里输出便于观察;生产采集应保持回调轻量,避免观测本身显著增加延迟。
package main
import (
"crypto/tls"
"fmt"
"net/http"
"net/http/httptrace"
"time"
)
func main() {
start := time.Now()
stamp := func(event string) {
fmt.Printf("t=%s event=%s\n", time.Since(start), event)
}
trace := &httptrace.ClientTrace{
GetConn: func(hostPort string) {
fmt.Printf("t=%s event=get_conn host=%s\n", time.Since(start), hostPort)
},
DNSStart: func(httptrace.DNSStartInfo) { stamp("dns_start") },
DNSDone: func(httptrace.DNSDoneInfo) { stamp("dns_done") },
ConnectStart: func(network, addr string) {
fmt.Printf("t=%s event=connect_start network=%s addr=%s\n",
time.Since(start), network, addr)
},
ConnectDone: func(network, addr string, err error) {
fmt.Printf("t=%s event=connect_done network=%s addr=%s err=%v\n",
time.Since(start), network, addr, err)
},
TLSHandshakeStart: func() { stamp("tls_start") },
TLSHandshakeDone: func(_ tls.ConnectionState, err error) {
fmt.Printf("t=%s event=tls_done err=%v\n", time.Since(start), err)
},
GotConn: func(info httptrace.GotConnInfo) {
fmt.Printf("t=%s event=got_conn reused=%t was_idle=%t idle=%s\n",
time.Since(start), info.Reused, info.WasIdle, info.IdleTime)
},
WroteRequest: func(httptrace.WroteRequestInfo) { stamp("wrote_request") },
GotFirstResponseByte: func() { stamp("first_response_byte") },
}
req, err := http.NewRequest(http.MethodGet, "https://example.com", nil)
if err != nil {
panic(err)
}
req = req.WithContext(httptrace.WithClientTrace(req.Context(), trace))
client := &http.Client{Timeout: 10 * time.Second}
resp, err := client.Do(req)
if err != nil {
panic(err)
}
defer resp.Body.Close()
fmt.Printf("status=%s total=%s\n", resp.Status, time.Since(start))
}预期输出如下,<DURATION>、<IP> 等实际值会随网络环境变化;连接被复用时 DNS、TCP 或 TLS 事件可能不出现。
t=<DURATION> event=get_conn host=example.com:443
t=<DURATION> event=dns_start
t=<DURATION> event=dns_done
t=<DURATION> event=connect_start network=tcp addr=<IP>:443
t=<DURATION> event=connect_done network=tcp addr=<IP>:443 err=<nil>
t=<DURATION> event=tls_start
t=<DURATION> event=tls_done err=<nil>
t=<DURATION> event=got_conn reused=false was_idle=false idle=0s
t=<DURATION> event=wrote_request
t=<DURATION> event=first_response_byte
status=200 OK total=<DURATION>用时间线判断慢在哪里
DNS 两个事件之间明显拉长时先检查解析链路;connect_start 到 connect_done 偏长时检查网络与代理;TLS 两个事件之间偏长时检查握手。GetConn 到 GotConn 表示“等待获得可用连接”的总区间,但当 Reused=false 时还包含新连接的 DNS、TCP 和 TLS 成本,不能直接称为连接池等待。只有结合 Reused、WasIdle 和 IdleTime,才能判断是否更像连接复用或连接池容量问题。([Go][3])
wrote_request 到 first_response_byte 很长,说明请求已经写出但响应头迟迟没有到达,常见排查方向是服务端处理、下游依赖或返回链路。它仍不能直接证明根因在服务端内部;httptrace 观察的是客户端一次 round trip 的事件,重定向和服务端内部阶段还要结合访问日志、请求 ID、指标或分布式追踪继续定位。([Go][1])