使用 docker stats 命令中的 --stream 参数可以控制是否持续刷新容器资源使用情况。默认情况下,docker stats 会持续输出实时数据流,而添加 --no-stream 或 -n 标志则只获取并打印一次当前快照数据。若需将数据重定向到文件或进行后续处理,通常结合 --no-stream 使用以避免无限输出阻塞管道。

如何获取单次容器资源快照
要获取容器资源的单次快照而非持续监控,需在命令中显式指定 --no-stream 参数。该参数会阻止 docker stats 进入轮询模式,执行完毕后立即退出。这对于脚本自动化、定时任务或仅需检查某一时刻资源占用场景非常有用。例如,运行 docker stats --no-stream my_container 将返回一行包含 CPU、内存、网络 I/O 等指标的静态表格。

docker stats --no-stream <container_id_or_name></container_id_or_name>
上述命令执行后,终端将显示类似以下的输出:
CONTAINER ID NAME CPU % MEM USAGE / LIMIT MEM % NET I/O BLOCK I/O PIDS a1b2c3d4e5f6 my_container 0.50% 10MiB / 1GiB 1.00% 1.2kB / 0B 0B / 0B 5
此输出为一次性结果,不包含动态更新。若省略 --no-stream,命令将持续运行直到用户手动中断(如按 Ctrl+C)。
如何将统计信息导出为 JSON 格式
当需要以结构化数据形式消费 docker stats 输出时,可结合 --format 与 --no-stream 参数实现。通过指定 Go 模板语法,可自定义输出字段并转换为 JSON 对象。例如,使用 --format json 可将单次快照数据序列化为标准 JSON 格式,便于被其他程序解析。注意:即使使用 --format json,若不加 --no-stream,仍会持续输出多个 JSON 对象流。
以数据形式体验爵士乐。AI代理流式处理和声分离、色度、音网。误差纳入已测量。

docker stats --no-stream --format json <container_id_or_name></container_id_or_name>
执行后输出如下 JSON 结构:
{"Name":"my_container","ID":"a1b2c3d4e5f6","CPUPerc":"0.50%","MemUsage":"10MiB / 1GiB","MemPerc":"1.00%","NetIO":"1.2kB / 0B","BlockIO":"0B / 0B","PIDs":"5"}
该格式可直接用于 API 调用、日志聚合或监控系统集成。若需仅获取特定字段,可使用更精细的模板,如 --format '{{.CPUPerc}}'。
在脚本中如何安全捕获 docker stats 输出而不阻塞
在 Shell 脚本中调用 docker stats 时,若未使用 --no-stream,进程将永久挂起导致脚本卡死。因此,必须始终搭配 --no-stream 以确保命令正常退出。此外,可通过管道将输出重定向至变量或文件,例如:STATS=$(docker stats --no-stream --format json my_container)。这样可在不阻塞主流程的前提下获取数据。若需定期采集,应使用循环配合睡眠间隔,而非依赖 docker stats 的内置流功能。










