### Docker Stats 命令中的内存计算方法及原理 `docker stats` 命令用于实时监控运行中的容器资源使用情况，其中包括 CPU 使用率、内存使用量以及网络 I/O 和磁盘 I/O 等指标。对于内存使用的具体计算方式，其基于 cgroups（control groups）机制来获取数据。 #### 内存统计的核心概念 Docker 利用 Linux 的 cgroups 功能管理容器的资源分配和限制。cgroups 提供了一种接口，允许操作系统跟踪进程组的资源消耗情况。通过读取 `/sys/fs/cgroup/memory/` 下的相关文件，可以得到容器的实际内存使用情况[^1]。 以下是 `docker stats` 中内存计算的关键部分： 1. **实际内存使用 (Memory Usage)** 实际内存使用是指当前容器所占用的物理内存大小。它可以通过以下公式计算得出： \[ \text{Memory Usage} = \text{rss} + \text{cache} \] 其中： - `rss` 表示驻留集大小（Resident Set Size），即直接映射到 RAM 的页面数量。 - `cache` 表示被缓存的数据量，这些数据可能来自文件系统或其他来源。 这些值可以从 cgroups 文件系统的路径下提取，例如 `/sys/fs/cgroup/memory/docker/<container_id>/memory.usage_in_bytes`[^2]。 2. **总内存限制 (Limit)** 总内存限制表示该容器能够使用的最大内存量。如果未设置显式的内存限制，则默认等于主机上的可用内存总量。此值存储在 `/sys/fs/cgroup/memory/docker/<container_id>/memory.limit_in_bytes` 文件中。 3. **百分比计算** 容器的内存使用百分比可通过以下公式计算： \[ \text{Percentage Used} = \left( \frac{\text{Memory Usage}}{\text{Limit}} \right) \times 100\% \] #### 数据采集流程 当执行 `docker stats` 命令时，Docker Daemon 负责收集各个容器的资源统计数据并将其展示给用户。这一过程依赖于底层 OCI runtime（如 runc）与宿主机的操作系统交互完成。runc 遵循 OCI 规范实现容器生命周期管理和资源配置功能。 为了提高性能，`docker stats` 默认会每隔两秒刷新一次数据显示；然而，这个时间间隔是可以调整的。 ```bash docker stats --no-stream ``` 上述命令可一次性显示所有活动容器的即时状态而无需持续更新。 --- ### 示例代码：手动解析 CGroup 数据 下面是一个简单的 Python 脚本示例，演示如何从 cgroups 获取某个特定容器的内存使用信息： ```python import os def get_memory_usage(container_id): usage_path = f"/sys/fs/cgroup/memory/docker/{container_id}/memory.usage_in_bytes" limit_path = f"/sys/fs/cgroup/memory/docker/{container_id}/memory.limit_in_bytes" with open(usage_path, 'r') as file: memory_usage = int(file.read().strip()) with open(limit_path, 'r') as file: memory_limit = int(file.read().strip()) percentage_used = (memory_usage / memory_limit) * 100 if memory_limit != 0 else 0 return { "Usage": memory_usage, "Limit": memory_limit, "PercentUsed": round(percentage_used, 2) } # 替换为实际存在的容器 ID 或名称 result = get_memory_usage("your_container_id_here") print(f"Memory Usage: {result['Usage']} bytes") print(f"Memory Limit: {result['Limit']} bytes") print(f"Percentage Used: {result['PercentUsed']}%") ``` ---