cgroup v2 memory pressure容器内存回收前怎样读取压力指标为什么结果为空或不符合预期

容器内存快到上限时，单看 memory.current 只能知道用了多少，不能说明应用是否已经因为回收而变慢。cgroup v2 把 Pressure Stall Information（PSI）放在每个 cgroup 的 memory.pressure 中：some 表示至少有一部分任务因内存而停顿，full 表示全部非空闲任务同时停顿。实际排查时，应把它和 memory.events、memory.high、memory.max 一起读，才能判断是否要在回收前扩容或降载。

先找到容器真正使用的 cgroup 目录

cgroup v2 是单一层级，进程的 /proc/PID/cgroup 通常会出现 0::/...。从容器内拿到主进程 PID 后，在宿主机上把这个相对路径拼到 cgroup2 挂载点；不要直接假定路径一定是 Docker 或 systemd 的固定名字。

# 读取目标进程的 cgroup v2 相对路径
pid="$1"
mount_point="$(findmnt -n -t cgroup2 -o TARGET | head -n 1)"
relative="$(awk -F: '$1 == 0 {print $3}' "/proc/$pid/cgroup")"
if [ -z "$mount_point" ] || [ -z "$relative" ]; then
  # 挂载点或路径为空时，说明当前主机不符合 cgroup v2 读取前提
  echo "无法定位 cgroup v2" >&2
  exit 1
fi
cgroup_dir="$mount_point$relative"
echo "$cgroup_dir"

如果 findmnt 找不到 cgroup2，或 /proc/$pid/cgroup 只有 v1 层级，继续读取 memory.pressure 就会得到路径不存在、空输出或错误的层级数据。先确认挂载和 PID 归属，比反复调整阈值更重要。

读取 memory.pressure：some 和 full 要分开看

在目标目录执行下面的命令。这里的值是静态说明中的典型格式，不代表某台机器的运行结果。

# 同时读取压力、用量和内存事件，便于做一次关联判断
for file in memory.pressure memory.current memory.high memory.max memory.events; do
  echo "--- $file ---"
  cat "$cgroup_dir/$file" 2>/dev/null || echo "不可读或文件不存在"
done

memory.pressure 常见为两行：some avg10=... avg60=... avg300=... total=... 与 full ...。avg 数值是百分比形式的近期趋势，total 的单位是微秒。some 长时间升高说明工作负载已经被部分拖住；full 长时间升高则更接近所有非空闲任务都在等待回收，通常应优先降载或扩大内存。

用四个文件判断压力究竟来自哪里

压力指标回答“任务被拖住了多少”，边界和事件回答“为什么被拖住”。建议先做下面的对照：

例如 some 上升、high 也持续增加而 oom_kill 不变，优先怀疑 memory.high 太紧或并发突增；如果 memory.max 已接近当前值且 oom、oom_kill 增长，就不能只靠调度节流，需要重新评估硬上限与工作集。

连续采样，避免“结果为空或不符合预期”

刚启动容器、压力已经结束、读取了宿主机文件，都会让结果看起来是 0。PSI 的平均值只覆盖最近 10、60、300 秒，短暂尖峰可能只体现在 total。可以保留前后快照：

# 每 5 秒保存一次压力与事件，方便比较增量
while sleep 5; do
  now="$(date -Is)"
  pressure="$(cat "$cgroup_dir/memory.pressure" 2>/dev/null)"
  events="$(cat "$cgroup_dir/memory.events" 2>/dev/null)"
  echo "$now"
  echo "$pressure"
  echo "$events"
done

结果为空时按顺序检查：目标进程是否仍在原 cgroup、当前是不是统一层级、目录是否有 memory.pressure、控制器是否被正确启用，以及读取的是否是目标子 cgroup 而不是父目录。memory.events 默认可能包含子树事件；需要只看当前 cgroup 时再比较 memory.events.local。

迁移和回归检查清单

• 先确认 cgroup v2 和容器 PID 的归属，再记录压力文件的原始快照。
• 用 avg10 看近期变化，用 avg60/avg300 判断是否持续，用 total 捕捉短尖峰。
• 同时保存 memory.current、memory.high、memory.max 和 memory.events，不要只凭百分比扩容。
• 调高 memory.high 前先确认宿主机余量；它是保护性能的节流边界，不是无限扩容开关。
• 若要做主动回收，不要把 memory.reclaim 的回收动作直接当成自然内存压力信号；内核文档明确区分了两者。

常见问题

为什么 /proc/pressure/memory 有值，但容器目录没有？

/proc/pressure/memory 是系统级压力；按 cgroup 统计需要 cgroup2 挂载并存在目标目录的 memory.pressure。两者范围不同，不能互相替代。

some 为 0 就能说明容器没有内存问题吗？

不能。它只表示对应采样窗口内没有被记录到部分任务停顿。检查 avg60、avg300 与 total，并结合工作负载高峰复测。

high 增长是否等于 OOM？

不等于。high 代表超过 high 边界后被迫做 direct reclaim 或节流；是否发生 OOM 要看 oom 和 oom_kill 等事件。

应该把 memory.max 设成和 memory.high 一样吗？

通常不应机械设置成相同值。high 用于给工作负载施加可调整的回收压力，max 是最后的硬边界，两者应为故障处理和回滚留出空间。

真正可用的判断不是“pressure 非零就扩容”，而是把压力趋势、当前用量、high/max 边界和事件增量放在同一时间窗口里看。这样才能在容器进入持续回收前，选择降并发、调整边界或增加内存。