使用 docker stats 监控无状态容器资源消耗，最直接的方法是结合 --no-stream 参数获取一次性快照，或通过管道将实时数据重定向到文件进行持久化记录。默认情况下该命令会持续刷新终端显示，不适合后台长期运行或自动化采集；加上 --no-stream 后仅输出当前时刻的 cpu、内存和网络 i/o 统计信息，便于脚本解析或人工查看瞬时负载。
如何获取特定容器的单次资源快照
通过指定容器 ID 或名称并启用 --no-stream，可以只输出一行包含关键指标的数据，避免终端刷屏。此方法适用于定时任务中定期抓取某个容器的资源占用情况，例如每五分钟检查一次 Web 服务的内存峰值。
#!/bin/bash # 获取名为 'web-app' 的容器的一次性资源快照 CONTAINER_NAME="web-app" OUTPUT_FILE="/tmp/docker_stats_snapshot.txt" echo "Taking snapshot for $CONTAINER_NAME at $(date)" > "$OUTPUT_FILE" docker stats --no-stream "$CONTAINER_NAME" >> "$OUTPUT_FILE" echo "Snapshot saved to $OUTPUT_FILE" cat "$OUTPUT_FILE"
预期结果：终端打印出包含时间戳和 docker stats 原始输出的文本文件内容，其中包含 CPU %、MEM USAGE / LIMIT、NET I/O 等列。若容器不存在，命令会报错并返回非零退出码。
Docker Hub (hub.docker.com)。此技能适用于所有 Docker Hub 操作，包括读取、创建、更新和删除数据。只要任务涉及 Docker Hub，就使用此技能。
如何将实时统计数据写入日志文件以便后续分析
利用 Linux 的 tee 命令或重定向操作符，可以将 docker stats 的实时输出同时保存到文件中。这种方式适合需要连续记录资源变化趋势的场景，比如排查间歇性性能瓶颈。注意由于 docker stats 默认每秒刷新，直接重定向可能导致文件快速膨胀，建议配合 timeout 限制运行时长。
#!/bin/bash
# 实时监控 'db-service' 容器并将数据追加到日志文件
CONTAINER_NAME="db-service"
LOG_FILE="/var/log/docker/db_service_stats.log"
DURATION=60 # 监控60秒
echo "Starting monitoring for $CONTAINER_NAME for $DURATION seconds..." >> "$LOG_FILE"
timeout $DURATION docker stats --no-stream "$CONTAINER_NAME" | while read line; do
echo "$(date '+%Y-%m-%d %H:%M:%S') - $line" >> "$LOG_FILE"
done
echo "Monitoring stopped." >> "$LOG_FILE"
预期结果：在指定的 DURATION 时间内，docker stats 每次输出一行数据，被 while 循环捕获并添加时间戳后追加到 LOG_FILE。监控结束后，文件包含带时间标记的资源使用历史序列。如果容器在监控期间重启，新容器可能获得不同 ID，需确保脚本能识别新的容器实例或重新绑定名称。
当容器处于 Restarting 状态时 docker stats 的行为是什么
如果目标容器正处于 Restarting 状态（即因退出码非零而正在自动重启），docker stats 命令通常会立即失败并返回错误信息，提示无法连接到容器或容器未运行。这是因为 docker stats 依赖于 cgroups 和容器运行时接口，而这些接口在容器完全停止或处于过渡状态时不可用。此时无法获取任何资源消耗数据，直到容器成功进入 Running 状态。
