On Wed, Jan 29, 2025 at 02:12:04PM -0500, Waiman Long wrote:
> Since commit 0e4b01df8659 ("mm, memcg: throttle allocators when failing
> reclaim over memory.high"), the amount of allocator throttling had
> increased substantially. As a result, it could be difficult for a
> misbehaving application that consumes increasing amount of memory from
> being OOM-killed if memory.high is set. Instead, the application may
> just be crawling along holding close to the allowed memory.high memory
> for the current memory cgroup for a very long time especially those
> that do a lot of memcg charging and uncharging operations.
>
> This behavior makes the upstream Kubernetes community hesitate to
> use memory.high. Instead, they use only memory.max for memory control
> similar to what is being done for cgroup v1 [1].
>
> To allow better control of the amount of throttling and hence the
> speed that a misbehving task can be OOM killed, a new single-value
> memory.high.throttle control file is now added. The allowable range
> is 0-32. By default, it has a value of 0 which means maximum throttling
> like before. Any non-zero positive value represents the corresponding
> power of 2 reduction of throttling and makes OOM kills easier to happen.
>
> System administrators can now use this parameter to determine how easy
> they want OOM kills to happen for applications that tend to consume
> a lot of memory without the need to run a special userspace memory
> management tool to monitor memory consumption when memory.high is set.
>
> Below are the test results of a simple program showing how different
> values of memory.high.throttle can affect its run time (in secs) until
> it gets OOM killed. This test program allocates pages from kernel
> continuously. There are some run-to-run variations and the results
> are just one possible set of samples.
>
> # systemd-run -p MemoryHigh=10M -p MemoryMax=20M -p MemorySwapMax=10M \
> --wait -t timeout 300 /tmp/mmap-oom
>
> memory.high.throttle service runtime
> -------------------- ---------------
> 0 120.521
> 1 103.376
> 2 85.881
> 3 69.698
> 4 42.668
> 5 45.782
> 6 22.179
> 7 9.909
> 8 5.347
> 9 3.100
> 10 1.757
> 11 1.084
> 12 0.919
> 13 0.650
> 14 0.650
> 15 0.655
>
> [1] https://docs.google.com/document/d/1mY0MTT34P-Eyv5G1t_Pqs4OWyIH-cg9caRKWmqYlSbI/edit?tab=t.0
>
> Signed-off-by: Waiman Long <longman@xxxxxxxxxx>
> ---
> Documentation/admin-guide/cgroup-v2.rst | 16 ++++++++--
> include/linux/memcontrol.h | 2 ++
> mm/memcontrol.c | 41 +++++++++++++++++++++++++
> 3 files changed, 57 insertions(+), 2 deletions(-)
>
> diff --git a/Documentation/admin-guide/cgroup-v2.rst b/Documentation/admin-guide/cgroup-v2.rst
> index cb1b4e759b7e..df9410ad8b3b 100644
> --- a/Documentation/admin-guide/cgroup-v2.rst
> +++ b/Documentation/admin-guide/cgroup-v2.rst
> @@ -1291,8 +1291,20 @@ PAGE_SIZE multiple when read back.
> Going over the high limit never invokes the OOM killer and
> under extreme conditions the limit may be breached. The high
> limit should be used in scenarios where an external process
> - monitors the limited cgroup to alleviate heavy reclaim
> - pressure.
> + monitors the limited cgroup to alleviate heavy reclaim pressure
> + unless a high enough value is set in "memory.high.throttle".
> +
> + memory.high.throttle
> + A read-write single value file which exists on non-root
> + cgroups. The default is 0.
> +
> + Memory usage throttle control. This value controls the amount
> + of throttling that will be applied when memory consumption
> + exceeds the "memory.high" limit. The larger the value is,
> + the smaller the amount of throttling will be and the easier an
> + offending application may get OOM killed.
memory.high is supposed to never invoke the OOM killer (see above). It's
unclear to me if you are referring to OOM kills from the kernel or
userspace in the commit message. If the latter, I think it shouldn't be
in kernel docs.
