# 查看所有运行中容器的资源使用
docker stats

# 查看指定容器
docker stats my-container

# 查看多个容器
docker stats container1 container2

# 只输出一次（不持续刷新）
docker stats --no-stream

# 格式化输出
docker stats --format "table {{.Name}}\t{{.CPUPerc}}\t{{.MemUsage}}"

CONTAINER ID   NAME      CPU %     MEM USAGE / LIMIT    MEM %     NET I/O          BLOCK I/O    PIDS
a1b2c3d4e5f6   web       0.25%     45.6MiB / 512MiB    8.91%     12.3kB / 8.2kB   0B / 0B      8

# 持续观察内存增长趋势
docker stats --no-stream myapp | grep -E "NAME|myapp"

# 或配合 watch 定时监控
watch -n 5 'docker stats --no-stream myapp'

# 内存持续增长可能是泄漏
# 结合 docker inspect 看内存限制
docker inspect myapp | jq '.[0].HostConfig.Memory'

# 查看内存使用接近限制的容器
docker stats --no-stream --format \
  "table {{.Name}}\t{{.MemPerc}}"

# 每隔 10 秒采集一次，持续 1 小时
for i in $(seq 1 360); do
  docker stats --no-stream --format \
    "{{.Name}},{{.CPUPerc}},{{.MemUsage}}" \
    >> /var/log/container_stats.csv
  sleep 10
done

# 只显示关键信息
docker stats --format "table {{.Name}}\t{{.CPUPerc}}\t{{.MemUsage}}\t{{.NetIO}}"

# JSON 格式输出（适合程序解析）
docker stats --no-stream --format "{{json .}}"

# docker stats 不等于宿主机 top 看到的进程
# 原因：容器共享宿主机内核，top 看到的是所有进程混杂在一起

# 在容器内看本容器的进程
docker exec myapp top

# 宿主机上过滤容器进程
ps aux | grep -E "docker|containerd|myapp"

# 已停止容器的历史资源数据无法获取
# 如果需要历史数据，考虑 cAdvisor、Prometheus 等工具

# docker stats 本身有一定的性能开销
# 高频采集（< 1s）不建议在生产环境长时间运行

# CPU% 是相对值，不是绝对值
# 4 核机器上 100% CPU = 用满 1 个核，400% = 用满所有核

# 通过 API 获取 stats 数据
curl --unix-socket /var/run/docker.sock \
  http://localhost/containers/myapp/stats?stream=false

# 返回 JSON 格式，包含 CPU 详情（cpu_usage、system_cpu_usage 等）

# 1. 短时间排障用 docker stats
docker stats --no-stream myapp

# 2. 持续监控用外部工具
# Prometheus + cAdvisor + Grafana

# 3. 采集频率建议
# 排查时 5-10 秒一次
# 监控系统 15-60 秒一次

# docker stats 不保存历史数据
# 需要配置 Prometheus + cAdvisor 或使用 Docker 原生监控插件