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])

HTTP 客户端延迟分解时间线

记录一次真实请求

下面程序默认请求 https://example.com,用相对请求开始时间打印关键事件。示例直接在回调里输出便于观察;生产采集应保持回调轻量,避免观测本身显著增加延迟。

go
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 事件可能不出现。

text
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])

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

使用 httptrace 分解延迟

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通