1.. SPDX-License-Identifier: GPL-2.0 2.. include:: ../../../disclaimer-zh_CN.rst 3 4:Original: Documentation/admin-guide/mm/damon/reclaim.rst 5 6:翻译: 7 8 司延腾 Yanteng Si <siyanteng@loongson.cn> 9 10:校译: 11 12=============== 13基于DAMON的回收 14=============== 15 16基于DAMON的回收（DAMON_RECLAIM）是一个静态的内核模块，旨在用于轻度内存压力下的主动和轻 17量级的回收。它的目的不是取代基于LRU列表的页面回收，而是有选择地用于不同程度的内存压力和要 18求。 19 20哪些地方需要主动回收？ 21====================== 22 23在一般的内存超量使用（over-committed systems，虚拟化相关术语）的系统上，主动回收冷页 24有助于节省内存和减少延迟高峰，这些延迟是由直接回收进程或kswapd的CPU消耗引起的，同时只产 25生最小的性能下降 [1]_ [2]_ 。 26 27基于空闲页报告 [3]_ 的内存过度承诺的虚拟化系统就是很好的例子。在这样的系统中，客户机 28向主机报告他们的空闲内存，而主机则将报告的内存重新分配给其他客户。因此，系统的内存得到了充 29分的利用。然而，客户可能不那么节省内存，主要是因为一些内核子系统和用户空间应用程序被设计为 30使用尽可能多的内存。然后，客户机可能只向主机报告少量的内存是空闲的，导致系统的内存利用率下降。 31在客户中运行主动回收可以缓解这个问题。 32 33它是如何工作的？ 34================ 35 36DAMON_RECLAIM找到在特定时间内没有被访问的内存区域并分页。为了避免它在分页操作中消耗过多 37的CPU，可以配置一个速度限制。在这个速度限制下，它首先分页出那些没有被访问过的内存区域。系 38统管理员还可以配置在什么情况下这个方案应该自动激活和停用三个内存压力水位。 39 40接口: 模块参数 41============== 42 43要使用这个功能，你首先要确保你的系统运行在一个以 ``CONFIG_DAMON_RECLAIM=y`` 构建的内 44核上。 45 46为了让系统管理员启用或禁用它，并为给定的系统进行调整，DAMON_RECLAIM利用了模块参数。也就 47是说，你可以把 ``damon_reclaim.<parameter>=<value>`` 放在内核启动命令行上，或者把 48适当的值写入 ``/sys/modules/damon_reclaim/parameters/<parameter>`` 文件。 49 50注意，除 ``启用`` 外的参数值只在DAMON_RECLAIM启动时应用。因此，如果你想在运行时应用新 51的参数值，而DAMON_RECLAIM已经被启用，你应该通过 ``启用`` 的参数文件禁用和重新启用它。 52在重新启用之前，应将新的参数值写入适当的参数值中。 53 54下面是每个参数的描述。 55 56enabled 57------- 58 59启用或禁用DAMON_RECLAIM。 60 61你可以通过把这个参数的值设置为 ``Y`` 来启用DAMON_RCLAIM，把它设置为 ``N`` 可以禁用 62DAMON_RECLAIM。注意，由于基于水位的激活条件，DAMON_RECLAIM不能进行真正的监测和回收。 63这一点请参考下面关于水位参数的描述。 64 65min_age 66------- 67 68识别冷内存区域的时间阈值，单位是微秒。 69 70如果一个内存区域在这个时间或更长的时间内没有被访问，DAMON_RECLAIM会将该区域识别为冷的， 71并回收它。 72 73默认为120秒。 74 75quota_ms 76-------- 77 78回收的时间限制，以毫秒为单位。 79 80DAMON_RECLAIM 试图在一个时间窗口（quota_reset_interval_ms）内只使用到这个时间，以 81尝试回收冷页。这可以用来限制DAMON_RECLAIM的CPU消耗。如果该值为零，则该限制被禁用。 82 83默认为10ms。 84 85quota_sz 86-------- 87 88回收的内存大小限制，单位为字节。 89 90DAMON_RECLAIM 收取在一个时间窗口（quota_reset_interval_ms）内试图回收的内存量，并 91使其不超过这个限制。这可以用来限制CPU和IO的消耗。如果该值为零，则限制被禁用。 92 93默认情况下是128 MiB。 94 95quota_reset_interval_ms 96----------------------- 97 98时间/大小配额收取重置间隔，单位为毫秒。 99 100时间（quota_ms）和大小（quota_sz）的配额的目标重置间隔。也就是说，DAMON_RECLAIM在 101尝试回收‘不’超过quota_ms毫秒或quota_sz字节的内存。 102 103默认为1秒。 104 105wmarks_interval 106--------------- 107 108当DAMON_RECLAIM被启用但由于其水位规则而不活跃时，在检查水位之前的最小等待时间。 109 110wmarks_high 111----------- 112 113高水位的可用内存率（每千字节）。 114 115如果系统的可用内存（以每千字节为单位）高于这个数值，DAMON_RECLAIM就会变得不活跃，所以 116它什么也不做，只是定期检查水位。 117 118wmarks_mid 119---------- 120 121中间水位的可用内存率（每千字节）。 122 123如果系统的空闲内存（以每千字节为单位）在这个和低水位线之间，DAMON_RECLAIM就会被激活， 124因此开始监测和回收。 125 126wmarks_low 127---------- 128 129低水位的可用内存率（每千字节）。 130 131如果系统的空闲内存（以每千字节为单位）低于这个数值，DAMON_RECLAIM就会变得不活跃，所以 132它除了定期检查水位外什么都不做。在这种情况下，系统会退回到基于LRU列表的页面粒度回收逻辑。 133 134sample_interval 135--------------- 136 137监测的采样间隔，单位是微秒。 138 139DAMON用于监测冷内存的采样间隔。更多细节请参考DAMON文档 (:doc:`usage`) 。 140 141aggr_interval 142------------- 143 144监测的聚集间隔，单位是微秒。 145 146DAMON对冷内存监测的聚集间隔。更多细节请参考DAMON文档 (:doc:`usage`)。 147 148min_nr_regions 149-------------- 150 151监测区域的最小数量。 152 153DAMON用于冷内存监测的最小监测区域数。这可以用来设置监测质量的下限。但是，设 154置的太高可能会导致监测开销的增加。更多细节请参考DAMON文档 (:doc:`usage`) 。 155 156max_nr_regions 157-------------- 158 159监测区域的最大数量。 160 161DAMON用于冷内存监测的最大监测区域数。这可以用来设置监测开销的上限值。但是， 162设置得太低可能会导致监测质量不好。更多细节请参考DAMON文档 (:doc:`usage`) 。 163 164monitor_region_start 165-------------------- 166 167目标内存区域的物理地址起点。 168 169DAMON_RECLAIM将对其进行工作的内存区域的起始物理地址。也就是说，DAMON_RECLAIM 170将在这个区域中找到冷的内存区域并进行回收。默认情况下，该区域使用最大系统内存区。 171 172monitor_region_end 173------------------ 174 175目标内存区域的结束物理地址。 176 177DAMON_RECLAIM将对其进行工作的内存区域的末端物理地址。也就是说，DAMON_RECLAIM将 178在这个区域内找到冷的内存区域并进行回收。默认情况下，该区域使用最大系统内存区。 179 180kdamond_pid 181----------- 182 183DAMON线程的PID。 184 185如果DAMON_RECLAIM被启用，这将成为工作线程的PID。否则，为-1。 186 187nr_reclaim_tried_regions 188------------------------ 189 190试图通过DAMON_RECLAIM回收的内存区域的数量。 191 192bytes_reclaim_tried_regions 193--------------------------- 194 195试图通过DAMON_RECLAIM回收的内存区域的总字节数。 196 197nr_reclaimed_regions 198-------------------- 199 200通过DAMON_RECLAIM成功回收的内存区域的数量。 201 202bytes_reclaimed_regions 203----------------------- 204 205通过DAMON_RECLAIM成功回收的内存区域的总字节数。 206 207nr_quota_exceeds 208---------------- 209 210超过时间/空间配额限制的次数。 211 212例子 213==== 214 215下面的运行示例命令使DAMON_RECLAIM找到30秒或更长时间没有访问的内存区域并“回收”？ 216为了避免DAMON_RECLAIM在分页操作中消耗过多的CPU时间，回收被限制在每秒1GiB以内。 217它还要求DAMON_RECLAIM在系统的可用内存率超过50%时不做任何事情，但如果它低于40%时 218就开始真正的工作。如果DAMON_RECLAIM没有取得进展，因此空闲内存率低于20%，它会要求 219DAMON_RECLAIM再次什么都不做，这样我们就可以退回到基于LRU列表的页面粒度回收了:: 220 221 # cd /sys/modules/damon_reclaim/parameters 222 # echo 30000000 > min_age 223 # echo $((1 * 1024 * 1024 * 1024)) > quota_sz 224 # echo 1000 > quota_reset_interval_ms 225 # echo 500 > wmarks_high 226 # echo 400 > wmarks_mid 227 # echo 200 > wmarks_low 228 # echo Y > enabled 229 230.. [1] https://research.google/pubs/pub48551/ 231.. [2] https://lwn.net/Articles/787611/ 232.. [3] https://www.kernel.org/doc/html/latest/vm/free_page_reporting.html 233