最稳妥方式是调用 Docker daemon 的 /containers/{id}/stats HTTP API 获取流式 JSON 数据，需用 http.Client.Do 读取分块响应并按行解析 NDJSON；也可直读 cgroup 文件系统指标，但路径依赖运行时且需注意 I/O 压力。
用 docker stats API 获取容器实时状态最直接
Go 程序想拿到容器 CPU、内存、网络 I/O 等指标，最稳妥的方式是调用 Docker daemon 的 HTTP API：/containers/{id}/stats。它返回流式 JSON，每秒推送一次数据，比轮询 docker ps 或解析 docker inspect 输出更准、更轻量。
注意点：
- 需确保 Go 进程能访问 Docker socket（通常是
/var/run/docker.sock），或配置好 TCP endpoint 和 TLS 证书 - 响应体是分块传输的 stream，不能用普通
http.Get，得用http.Client.Do并读取Response.Body流 - 每个 JSON 块以换行符分隔（NDJSON），需按行解析，不是整个响应体一个 JSON
resp, err := client.Post("http://localhost:2375/containers/nginx/stats?stream=1", "application/json", nil)
if err != nil {
log.Fatal(err)
}
defer resp.Body.Close()
scanner := bufio.NewScanner(resp.Body)
for scanner.Scan() {
line := scanner.Bytes()
var stats types.Stats
if err := json.Unmarshal(line, &stats); err == nil {
fmt.Printf("MemUsage: %d, CPU: %.2f%%\n", stats.MemoryStats.Usage, cpuPercent(&stats))
}
}
用 cgroup 文件系统直读指标更底层、不依赖 Docker daemon
Linux 容器本质是 cgroup + namespace，所有资源限制和使用数据都暴露在 /sys/fs/cgroup/ 下。Go 程序可直接读取对应容器的 cgroup 路径，比如 memory usage 在 /sys/fs/cgroup/memory/docker/{container-id}/memory.usage_in_bytes，CPU 统计在 cpuacct.stat。
这种方式的优势和风险：
立即学习“go语言免费学习笔记（深入）”；
- 完全绕过 Docker daemon，适合无 Docker 环境（如 containerd、Podman）或 daemon 不可用时保底采集
- 路径依赖运行时：Docker 默认用
docker子目录，containerd 用kubepods或system.slice，需根据/proc/{pid}/cgroup反查实际挂载点 - 没有自动采样节流，高频读取（如 100ms 间隔）可能引发 I/O 压力，建议 ≥500ms 间隔
避免用 exec.Command("docker", "stats") 解析终端输出
常见误区是起子进程执行 docker stats --no-stream nginx，再正则提取字段。这在生产环境问题很多：
- 输出格式不稳定：Docker CLI 版本升级后列顺序、单位（MiB vs MB）、空格数可能变化，
strings.Fields()易错位 - 性能差：每次调用都要 fork+exec，开销远高于 HTTP API 或文件读取
- 权限冗余：需要给 Go 进程配
docker组权限，而 API 方式只需 socket 读权限 - 无法获取完整指标：CLI 输出只含常用字段，缺少
memory.failures、blkio.io_service_bytes_recursive等诊断关键项
采集频率与指标存储需分开设计
监控不是“越快越好”。容器指标有天然抖动，1 秒粒度已足够定位多数问题；盲目提高到 100ms 只会撑大存储、压垮 agent。
推荐做法：
- 采集层（Go agent）固定 1s 或 5s 拉取，做基础校验（如内存值突降为 0 则丢弃）
- 聚合层（如 Prometheus remote_write 或 Kafka）负责降采样、打标、补点
- 避免在 Go 程序里实现 TSDB 或写磁盘：用
github.com/prometheus/client_golang暴露/metrics，由外部 scraper 统一拉取
cgroup 路径变动、API 流中断重连、指标单位换算（如 CPU nanoseconds → 百分比）这些细节，比选什么库更容易出问题。先跑通一条链路，再考虑扩展维度。
