Linux cgroup CPU配额如何限制进程?配额与实际占用怎么验证?
CPU 配额限制的不是进程“能不能运行”,而是它在一段时间内最多能获得多少 CPU 时间。比如配额相当于 1.5 个逻辑 CPU,任务仍可能在多个核心上并行运行;当这一周期的 CPU 时间预算用完后,内核会暂时限制该 cgroup 中的任务,等下一周期再恢复。因此,短时间看到进程使用多个核心,不一定说明配额失效;反过来,实际占用低于配额,也不代表系统一定在限速。
概念边界:配额是上限,不是预留
Linux cgroup 是内核提供的资源控制机制,可以把进程放入不同的控制组,并对组内任务应用资源限制。CPU 配额限制的是一组任务合计可使用的 CPU 时间,不是每个进程各自拥有一份独立额度。
例如,若一个 cgroup 中有 4 个计算密集型线程,配额总量为 1.5 个 CPU,那么这 4 个线程共享总计约 1.5 个 CPU 的时间预算。它们可能短时并行使用多个核心,但不能在较长时间尺度上持续获得超过配额的 CPU 时间。
配额也不等于 CPU 预留。设置上限为 2 个 CPU,不代表系统会始终为该组保留两个核心;如果主机繁忙、任务受其他限制,实际使用量仍可能更低。配额通常与以下机制同时存在:
| 机制 | 主要作用 | 与 CPU 配额的区别 |
|---|---|---|
| CPU 配额 | 限制一组任务在周期内可用的 CPU 时间总量 | 形成可计算的上限 |
| CPU 权重 | CPU 竞争时影响不同组之间的相对调度份额 | 不单独规定固定的 CPU 时间上限 |
| CPU 亲和性或 cpuset | 限定任务可在哪些逻辑 CPU 上运行 | 限制可运行的 CPU 范围,不直接表示时间预算 |
一个进程实际能使用多少 CPU,取决于配额、可运行 CPU 范围、其他层级的限制、主机竞争状况以及任务本身是否有足够并行工作。
工作机制:周期内分配 CPU 时间预算
在常见的 CFS 带宽控制机制中,配额以“一个周期内允许消耗多少 CPU 时间”表示。周期开始时,cgroup 获得一份 CPU 时间预算;组内任务运行时共同消耗预算。预算用尽后,尚未完成的任务会被暂时节流,直到下一个周期补充预算。
在 cgroup v2 中,限制通常显示在 cpu.max 文件中,格式为:
最大运行时间 周期时间
两个值的单位都是微秒。比如:
150000 100000
表示每 100000 微秒(100 毫秒)的周期内,最多可使用 150000 微秒(150 毫秒)的 CPU 时间。配额折算为 CPU 数量时,可以用:
可用 CPU 数量 ≈ 配额时间 ÷ 周期时间
这个例子相当于 1.5 个 CPU。计算密集型任务若有足够并行度,可能在周期前半段同时占用多个核心;总预算耗尽后则会被节流。周期内的瞬时占用因此可能高于 1.5 个核心,但持续平均值受到配额约束。

如果 cpu.max 的第一个字段是 max,表示这个 cgroup 在该项上没有设置固定带宽上限,例如:
max 100000
这不表示它能无限占用 CPU:主机资源、父级 cgroup 的限制、CPU 权重和 cpuset 等仍可能影响实际运行。
cgroup v1 使用的常见文件名是 cpu.cfs_quota_us 和 cpu.cfs_period_us。前者表示每周期可用的 CPU 时间,后者表示周期长度。若 quota 为 150000、period 为 100000,折算结果同样是 1.5 个 CPU;quota 为负值时,常见含义是未设置该项的带宽限制。具体文件是否存在,取决于系统使用的 cgroup 版本及挂载方式。
为什么配置了配额,实际占用却不相等
配额是上限,实际使用量是运行结果。两者不相等很常见,不能只看一个瞬时 CPU 百分比判断限制是否生效。
- 任务没有持续的 CPU 需求。 程序可能在等待磁盘、网络、锁或其他进程。即使配额允许使用 2 个 CPU,任务只需要 0.3 个 CPU 时,实际占用也不会达到上限。
- 并行度不足。 单线程计算任务通常难以持续使用超过一个逻辑 CPU。若配额大于 1 个 CPU,单线程工作负载无法验证更高额度是否可用。
- 可运行 CPU 范围更窄。 cpuset 或进程亲和性可能只允许任务使用一个 CPU。此时设置 2 个 CPU 的配额,也不意味着任务能同时占用两个 CPU。
- 存在父级限制。 子 cgroup 的配额不能绕过父 cgroup 的上限。若祖先组的限制更紧,实际可用 CPU 时间可能由祖先决定。
- 主机上有其他竞争任务。 配额不提供资源预留。即使配额允许使用较多 CPU,竞争、虚拟化环境中的 CPU 调度以及主机负载都可能使实际使用量偏低。
- 采样窗口与周期不同。 短采样可能刚好覆盖了任务并行运行或被节流的阶段。更长窗口的平均占用通常更适合判断总量,但也可能掩盖延迟抖动。
CPU 时间预算耗尽时出现节流,是配额发挥作用的一种表现,不是程序必然报错。对交互式服务而言,持续节流可能增加请求排队和响应延迟;对批处理任务而言,更常见的影响是完成时间延长。
验证方法:先找准进程所在的 cgroup
读取 cpu.max 或 v1 配额文件之前,首先要确认目标进程实际属于哪个 cgroup。以 PID 为 1234 的进程为例:
cat /proc/1234/cgroup
在统一层级的 cgroup v2 环境中,常见输出类似:
0::/system.slice/example.service
0:: 后面是进程在 cgroup v2 层级中的路径。可先确认挂载点是否为 cgroup v2:
stat -fc %T /sys/fs/cgroup
若输出为 cgroup2fs,通常可在对应目录查看限制。以下示例把 cgroup 路径写入变量,实际操作时应替换为目标进程的路径:
CG=/sys/fs/cgroup/system.slice/example.service
cat "$CG/cpu.max"
cat "$CG/cpu.stat"
若进程在容器或服务的子 cgroup 中,应使用它对应的实际路径;不能只查看 /sys/fs/cgroup/cpu.max 后就认定那是进程自己的限制。还要检查父级目录是否存在更严格的 cpu.max。路径和挂载结构可能因容器运行时、systemd 配置及发行版而不同。
v2 的 cpu.stat 常见字段包括 usage_usec、nr_periods、nr_throttled 和 throttled_usec。它们分别记录累计 CPU 使用时间、经过的配额周期数、发生节流的周期数和累计节流时间。可用以下命令查看:
cat "$CG/cpu.stat"
这些值通常是累计计数,单次读取不能说明当前的使用率。需要间隔一段时间读取两次,再计算增量。若 usage_usec 在 1 秒内增加 1,480,000 微秒,进程组平均使用约 1.48 个 CPU;对应的单 CPU 百分比约为 148%。如果配额为 1.5 个 CPU,这一结果接近上限。该计算衡量的是组内 CPU 时间,不是整台机器的总 CPU 百分比。
节流计数同样要比较增量。如果一段时间内 nr_throttled 或 throttled_usec 增长,同时 CPU 使用接近该组的可用上限,说明任务很可能受到配额约束。若计数没有增加,只能说明观察窗口内没有记录到节流;任务负载不足时,即便配额设置得很低,也可能看不到节流计数增长。
cgroup v1 环境中,可在进程对应的 CPU 控制组目录查看:
cat /proc/1234/cgroup
cat /sys/fs/cgroup/cpu/example/cpu.cfs_quota_us
cat /sys/fs/cgroup/cpu/example/cpu.cfs_period_us
cat /sys/fs/cgroup/cpu/example/cpu.stat
这里的 example 仅为路径示例,不能照搬到所有机器。v1 的挂载点和控制组路径应根据 /proc/1234/cgroup 及系统挂载信息确认。其 cpu.stat 常见计数包括 nr_periods、nr_throttled 和 throttled_time;不同版本和控制器实现中的字段名称、单位应以实际文件内容为准。
用可控负载对照配额
验证时应在目标 cgroup 内运行持续计算负载,并保证并行工作量足以用满配额。若机器已安装 stress-ng,可在 systemd 支持的环境中创建一个临时作用域运行示例任务:
systemd-run --scope -p CPUQuota=150% \
stress-ng --cpu 4 --timeout 30s
CPUQuota=150% 在常见 systemd 语义下表示总量约为 1.5 个 CPU;4 个工作线程用于提供足够并行负载。此示例用于验证机制,不代表所有发行版都安装了 stress-ng,也不应在生产高峰期未经评估直接运行。测试任务会消耗 CPU,应控制持续时间和并发规模。
负载运行期间,应从该作用域对应的 cgroup 读取 cpu.max(若是 v2)、cpu.stat 和 usage_usec 的前后变化,并观察节流计数是否增长。假设 30 秒测试中,CPU 使用时间增加约 44 秒,折算平均约为 1.47 个 CPU;同时节流计数增加,这与 1.5 个 CPU 的上限相符。示例中的数值是演示计算逻辑,不是实际测量结果。若使用量明显低于上限,应先确认负载确实进入目标组、线程数足够、没有更窄的 CPU 亲和性限制,并检查父级 cgroup 与主机竞争情况。
也可以用 top 或监控系统查看进程 CPU 使用率,但要确认其百分比口径。有些工具将一个逻辑 CPU 的满载显示为 100%,多核任务便可能显示超过 100%;另一些面板则把整台机器的全部逻辑 CPU 归一化到 100%。因此,工具显示的“80%”未必表示该 cgroup 使用了配额的 80%。判断时应优先用 cgroup 的累计 CPU 时间增量计算 CPU 数量,再与配额折算值比较。
适用限制:配额不能单独解释所有性能现象
CPU 配额适合限制服务或任务组可持续消耗的 CPU 时间,尤其适用于防止某个工作负载长期挤占主机 CPU。但它无法单独回答“为什么应用变慢”。延迟升高还可能来自 CPU 竞争、锁等待、I/O 等待、线程池配置或其他资源限制。
判断配额是否发挥作用,可按以下顺序核对:

- 确认目标 PID 所属 cgroup,并读取该组及相关父级的 CPU 限制。
- 将配额时间除以周期时间,换算为可用 CPU 数量;同时确认 cpuset 或亲和性没有进一步收窄范围。
- 在足够长、负载足够并行的观察窗口内,比较 cgroup 的 CPU 时间增量与墙上时间,计算平均 CPU 数量。
- 对照
cpu.stat中节流计数的增量;若使用量接近上限且节流增长,配额限制的判断更有依据。 - 若使用量远低于上限,检查任务是否有足够的可运行工作、是否被其他层级限制,以及主机是否存在 CPU 竞争。
最终应把配额值视为“可持续 CPU 时间的上限”,而不是承诺值或瞬时占用目标。只有同时确认进程归属、层级限制、负载并行度和统计口径,才能判断实际占用与配额之间的关系。
在需要对多类服务、容器任务或计算进程进行 CPU 资源分配的场景中,A5idc数据提供香港、美国、日本、韩国、新加坡等地区的物理服务器资源,覆盖 Xeon Gold、AMD EPYC 及 GPU 等平台,并配备不同规格的内存、NVMe 存储和网络线路,为网站、业务后台、数据库、多任务计算及 AI 工作负载提供可落地的主机基础。
本文由A5数据原创发布,转载请注明出处:https://www.a5idc.com/helpcontent/6257.html



