如何在Golang中监控容器资源使用情况

答案是使用Docker API或读取cgroup数据监控容器资源。通过Docker的/containers/{id}/stats接口获取CPU、内存、网络和磁盘IO信息，结合Go客户端库解析JSON数据并计算使用率；在无Docker环境可直接读取/sys/fs/cgroup下memory.current、cpuacct.usage等文件获取底层指标；为实现长期监控，可集成Prometheus Go客户端，定义Gauge指标暴露/metrics端点，供Prometheus抓取。生产环境推荐cgroup与Prometheus结合以提升精度。

在Golang中监控容器资源使用情况，通常依赖于访问容器运行时暴露的指标接口或读取底层cgroup文件系统数据。最常见的方式是通过Docker的API或直接解析宿主机上的cgroup信息来获取CPU、内存、网络和磁盘IO等资源使用情况。

使用Docker API获取容器资源数据

Go语言可以通过调用Docker的REST API来实时获取容器的资源使用统计。Docker提供了/containers/{id}/stats接口，返回流式的资源数据。

你可以使用官方的docker/docker客户端库来连接本地Docker守护进程：

package main
import (
"context"
"io"
"log"
"github.com/docker/docker/api/types"
"github.com/docker/docker/client"
)
func main() {
cli, err := client.NewClientWithOpts(client.WithVersion("1.41"))
if err != nil {
log.Fatal(err)
}
defer cli.Close()
ctx := context.Background()
options := types.ContainerStatsOptions{Stream: false}
// 替换为你的容器ID或名称
resp, err := cli.ContainerStats(ctx, "my-container", options)
if err != nil {
log.Fatal(err)
}
defer resp.Body.Close()
body, err := io.ReadAll(resp.Body)
if err != nil {
log.Fatal(err)
}
log.Println(string(body))
}

返回的JSON数据包含CPU使用率、内存限制与使用量、网络收发字节、块设备IO等信息。你需要根据字段自行计算百分比，例如CPU使用率需结合cpu_usage和system_cpu_usage进行差值计算。

立即学习“go语言免费学习笔记（深入）”；

直接读取cgroup文件系统（适用于无Docker环境）

容器本质上是受限的进程组，其资源限制由Linux cgroup管理。你可以在宿主机或特权容器中直接读取/sys/fs/cgroup/下的文件来获取资源数据。

例如，获取某个进程的内存使用情况：

晓象AI资讯阅读神器

晓象-AI时代的资讯阅读神器

25

查看详情

func getMemoryUsage(cgroupPath string) (uint64, error) {
data, err := os.ReadFile(filepath.Join(cgroupPath, "memory.current"))
if err != nil {
return 0, err
}
var usage uint64
fmt.Sscanf(string(data), "%d", &usage)
return usage, nil
}

CPU使用时间位于cpu.stat或cpuacct.usage中，IO统计可在blkio.throttle.io_service_bytes查看。这种方式更底层，适合嵌入式监控工具或运行在Kubernetes Pod中的sidecar容器。

集成Prometheus进行指标暴露

如果你希望将采集到的数据用于长期监控，可以使用Prometheus Go客户端暴露指标。

定义Gauge类型指标：

var (
containerCPUPercent = prometheus.NewGauge(
prometheus.GaugeOpts{Name: "container_cpu_percent", Help: "CPU usage percent"})
containerMemoryUsed = prometheus.NewGauge(
prometheus.GaugeOpts{Name: "container_memory_used_bytes", Help: "Memory used in bytes"})
)

在采集逻辑中更新这些指标，并启动HTTP服务暴露/metrics端点，供Prometheus抓取。

基本上就这些。选择哪种方式取决于你的部署环境：开发测试可用Docker API，生产级平台建议结合cgroup与Prometheus实现高精度监控。