java可通过调用docker stats命令或docker remote api获取容器内存使用率和网络i/o累计值,再通过两次采样差分计算实时吞吐;内存百分比直接可靠,网络数据反映容器veth接口收发量而非物理网卡直连流量。

Java 应用本身不直接执行 docker stats,但你可以在 Java 程序中调用系统命令来获取容器实时资源使用数据。关键在于:通过 docker stats --no-stream --format 获取结构化输出,再解析 JSON 或表格格式,提取网卡(实际是容器网络栈的 in/out 流量)和内存占用率。注意:Docker 的 stats 不直接暴露“物理网卡”吞吐,它显示的是容器网络命名空间的 veth 接口收发字节数(即容器视角的网络 I/O),这与宿主机物理网卡流量高度相关,但不是一对一映射(因有 NAT、桥接、多容器共享等)。内存占用率则由 docker stats 原生支持。
1. 理解 docker stats 输出的网络与内存字段
docker stats 默认输出中:
-
NET I/O 列(如
12.4MB / 3.2MB)表示容器累计接收/发送的字节数,不是实时速率。要算吞吐(如 MB/s),需两次采样做差分计算。 - MEM USAGE / LIMIT 和 MEM % 直接给出内存使用率(百分比),这是内核 cgroup 统计值,准确可靠。
- 物理网卡层面的吞吐(如 eth0)需查
/sys/class/net/eth0/statistics/,但该指标属于宿主机,不能直接绑定到某容器——除非你用 host 网络模式或配合 CNI 插件深度追踪。
2. Java 中安全执行 docker stats 并解析数据
推荐使用 ProcessBuilder 调用带格式化输出的命令,避免解析混乱的表格:
docker stats --no-stream --format "{{.Name}},{{.MemPerc}},{{.NetIO}}"
示例 Java 代码片段:
// 注意:确保运行 Java 的用户有权限执行 docker(如加入 docker 组)
ProcessBuilder pb = new ProcessBuilder("docker", "stats", "--no-stream",
"--format", "{{.Name}},{{.MemPerc}},{{.NetIO}}");
pb.redirectErrorStream(true);
Process process = pb.start();
try (BufferedReader reader = new BufferedReader(
new InputStreamReader(process.getInputStream()))) {
String line;
while ((line = reader.readLine()) != null) {
String[] parts = line.split(",");
String containerName = parts[0].trim();
double memPercent = Double.parseDouble(parts[1].replace("%", "").trim());
String netIO = parts[2].trim(); // 格式如 "1.23MB / 456KB"
// 解析 netIO 得到 recv/sent 字节数(需正则或简单拆分)
System.out.printf("%s: MEM %.1f%%, NET %s%n", containerName, memPercent, netIO);
}
}
3. 计算实时网络吞吐率(需两次采样)
单次 docker stats 只给累计值。要得每秒吞吐,必须间隔固定时间(如 1 秒)采集两次:
- 第一次采集:记录每个容器的
rx_bytes和tx_bytes(可从docker inspect CONTAINER_ID | jq '.[].NetworkSettings.Networks[].Stats'或/sys/fs/cgroup/memory/docker/.../memory.stat深度获取,但更推荐用docker stats+ 差分) - 第二次采集:同样方式获取新值
- 差值 ÷ 时间间隔 = 实时平均吞吐(B/s)
Java 中可用 ScheduledExecutorService 定期执行采集,并用 ConcurrentHashMap 缓存上一次值。
4. 替代方案:用 Docker Remote API 更稳定可控
比 shell 命令更健壮的方式是调用 Docker 的 HTTP API:
- GET
http://localhost:2375/containers/json?filters={"status":["running"]}获取活跃容器 ID 列表 - 对每个 ID 请求
GET /containers/{id}/stats?stream=false - 响应是 JSON,含
memory_stats.usage / memory_stats.limit(算 %)、networks.eth0.rx_bytes / tx_bytes(注意:此处接口返回的是容器默认网络的 stats,字段名取决于实际网卡名,常见为eth0或bridge) - 用 Jackson 或 Gson 解析,无需字符串切割,更可靠
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南











