Linux cgroup v2 cpu.max 如何判断 CPU 配额

如果进程运行在 Linux cgroup v2 中，判断 CPU 配额最直接的入口就是目标 cgroup 目录下的 cpu.max。它通常包含两个按微秒计的数字：MAX PERIOD。把前者除以后者，就能得到这个 cgroup 在一个周期内可使用的近似 CPU 数；如果第一个字段是 max，表示这里没有设置带宽上限。需要注意，这个比例是硬配额，不等于机器当前空闲 CPU，也不等于 cpuset 能看到的核数。

先确认 cpu 控制器和目标 cgroup

先找到统一层级的挂载点，再进入承载目标进程的目录。容器环境里常见路径是 /sys/fs/cgroup，但不要把它当成固定答案；systemd、容器运行时或发行版配置都可能让目标 cgroup 位于更深的子目录。

# 只读检查挂载点和当前目录，避免直接改动控制器配置
mountpoint -q /sys/fs/cgroup && echo "cgroup v2 mount exists"
cd /sys/fs/cgroup/app.slice/service-a.scope
printf 'controllers: '; cat cgroup.controllers
printf 'parent enabled: '; cat ../cgroup.subtree_control
printf 'cpu.max: '; cat cpu.max

如果目标目录没有 cpu.max，先别急着写入。通常要检查父级的 cgroup.subtree_control 是否启用了 cpu，以及目标目录是否确实属于 cgroup v2；控制器是沿层级向下分发的，读取错目录会把“没有限制”误判成“文件不存在”。

读取 cpu.max 并换算 CPU 配额

cpu.max 的两个字段分别是每周期允许的 CPU 时间和周期长度，单位都是微秒。例如 200000 100000 表示每 100000 微秒最多消耗 200000 微秒 CPU 时间，换算结果约为 2 个 CPU。25000 100000 则约为 0.25 个 CPU。它描述的是累计带宽上限，多个线程会共享这段额度。

这个换算只回答“最多给多少 CPU 时间”。它不能说明进程已经用满，也不能替代负载观测。父级 cgroup 还可能施加更紧的上限，所以排查时要沿父链读取对应的 cpu.max。

结合 cpu.stat 判断是否被限流

当服务变慢时，单看 cpu.max 只能说明配置，不能证明发生了限流。cgroup v2 的 cpu.stat 会给出使用时间和限流统计；在压力持续期间，如果 nr_throttled、throttled_usec 同步增长，才更像是 CPU 带宽耗尽。

# 只读取统计快照；连续采样时请比较两次读数的差值
cat cpu.stat
printf 'effective cpus: '; cat cpuset.cpus.effective
printf 'weight: '; cat cpu.weight

修改配额时保留可回滚的检查路径

调整前先记录原值、父级限制和当前统计。写入时使用两个字段，避免只改周期却忘记原有配额；修改后重新读取，并在相同业务负载下观察限流统计。生产环境更稳妥的做法是先在单个服务 cgroup 上灰度，确认延迟和吞吐变化后再扩大范围。

# 示例：将当前 cgroup 限制为约 1.5 个 CPU；写入前请确认权限和回滚值
old_value=$(cat cpu.max)
printf 'old cpu.max: %s\n' "$old_value"
printf '150000 100000' > cpu.max
printf 'new cpu.max: '; cat cpu.max
# 若需回滚，使用刚才记录的两个原始字段恢复

如果写入失败，优先检查权限、目标是否为非 root cgroup、父级是否已分发 cpu 控制器，以及数值是否满足内核接口要求。不要只把失败归因于“Linux 不支持 cgroup v2”，先确认实际挂载层级。

相关问题

cpu.max 的第一个字段是 max，第二个数字还重要吗？

对当前 CPU 带宽限制来说，max 表示没有上限，但周期字段仍是接口的一部分，读取和写回时应保留完整的两个字段。

cpu.max 和 cpu.weight 有什么区别？

cpu.max 是每周期的硬带宽上限，cpu.weight 是同层级竞争 CPU 时的相对分配权重，不能用权重直接换算出固定 CPU 核数。

为什么 cpu.max 看起来足够，服务仍然变慢？

还要看父级配额、cpuset.cpus.effective、运行队列、IO 等因素；先对比 cpu.stat 的限流计数和限流时间增量，再判断是否是配额问题。