Go httptrace 怎么单独统计 HTTP 请求的 DNS 解析耗时

HTTP 请求变慢时，先把 DNS 解析从整段耗时里拆出来，才能判断问题是在解析器、连接建立还是服务端响应。Go 的 net/http/httptrace 已经提供了这条边界：在 DNSStart 记录开始时间，在 DNSDone 计算 time.Since(start)。因此，DNS 耗时就是 DNSStart 到 DNSDone 的时间差，不包含后面的 TCP、TLS 和响应读取。

把 DNSStart 与 DNSDone 绑定到同一条请求

ClientTrace 是一组 HTTP 客户端阶段回调。先创建 trace，再用 httptrace.WithClientTrace 生成新的上下文，最后把它放进请求。开始时刻必须在 DNSStart 内写入，这样每次请求都有自己的计时状态。

var dnsStart time.Time
var dnsElapsed time.Duration
var dnsObserved bool

trace := &httptrace.ClientTrace{
	DNSStart: func(info httptrace.DNSStartInfo) {
		// 每次解析开始都刷新时刻，避免沿用上一次请求的零值或旧值。
		dnsStart = time.Now()
	},
	DNSDone: func(info httptrace.DNSDoneInfo) {
		// 只有配对成功时才计算区间；错误信息仍交给上层记录。
		if !dnsStart.IsZero() {
			dnsElapsed = time.Since(dnsStart)
			dnsObserved = true
		}
	},
}

req, err := http.NewRequestWithContext(
	httptrace.WithClientTrace(context.Background(), trace),
	http.MethodGet,
	"https://api.example.com/health",
	nil,
)
if err != nil {
	// 请求构造失败没有 DNS 阶段，直接返回构造错误。
	return err
}
resp, err := http.DefaultClient.Do(req)
if resp != nil {
	// 读取完响应体并关闭它，避免把连接资源留在调用方之外。
	defer resp.Body.Close()
}
if err != nil {
	return err
}
if dnsObserved {
	log.Printf("dns_duration=%s", dnsElapsed)
}

这里的关键不是把 DNSStartInfo.Host 打出来，而是让开始和结束回调共享同一份请求级状态。生产代码若会并发复用这段逻辑，应把这些变量放进单次调用的闭包，或使用互斥保护，不能放成全局变量。

从 DNSDoneInfo 计算耗时并记录结果

DNSDone 被调用时，解析阶段已经结束。DNSDoneInfo 的 Addrs 表示解析得到的地址，Err 表示解析错误，Coalesced 表示结果是否与同时进行相同查询的其他调用共享。耗时和这些字段应当作为一条事件保存，避免只看到一个毫秒数却无法解释。

不要把 len(Addrs)==0 直接等同于网络不可用：真正的判断依据是 Err。同样，Coalesced 不是失败标志，它只说明解析结果的来源存在并发合并。

处理缓存、失败与并发回调边界

第一次请求通常更容易观察到 DNS 回调，但连接池、解析器缓存和自定义 Transport 会改变后续请求的阶段表现。若本次请求没有进入新的 DNS 查询，不能用一个未初始化的开始时间计算出“0 毫秒”；应记录 dns_observed=false，把它和真实的极短解析区分开。

另外，官方文档说明 ClientTrace 的函数可能从不同 goroutine 并发调用，甚至在请求完成或失败后继续触发。因此回调只负责写入当前请求的采样状态，日志聚合、指标上报放到 Do 返回之后完成。不要在回调中修改共享 map，也不要把响应体读取时间塞回 DNS 字段。

用阶段表确认指标没有越界

当 DNS 指标升高时，先看 Err、Coalesced 和地址数量，再与连接、TLS、首字节指标并排比较。这样能回答“解析慢”还是“请求整体慢”，而不会把一个总耗时问题错误归因给 DNS。

相关问题

DNSStart 和 DNSDone 没有同时出现怎么办？

只保留未配对状态并标记未观测，不要用零值补齐耗时；同时检查是否命中已有解析或请求在更早阶段失败。

DNSDone 的 Err 非空还能记录耗时吗？

可以记录为失败样本，耗时表示失败前经历的解析区间，统计成功率时不要把它并入成功解析延迟。

为什么 DNS 耗时正常但 HTTP 仍然很慢？

继续查看 Connect、TLS、GotFirstResponseByte 和响应体读取阶段；DNS 计时只覆盖域名解析。