Documentation/translations/zh_CN/admin-guide/mm/damon/usage.rst

   1 .. SPDX-License-Identifier: GPL-2.0
   2 .. include:: ../../../disclaimer-zh_CN.rst
   3
   4 :Original: Documentation/admin-guide/mm/damon/usage.rst
   5
   6 :翻译:
   7
   8  司延腾 Yanteng Si <siyanteng@loongson.cn>
   9
  10 :校译:
  11
  12 ========
  13 详细用法
  14 ========
  15
  16 DAMON 为不同的用户提供了下面这些接口。
  17
  18 - *DAMON用户空间工具。*
  19   `这 <https://github.com/awslabs/damo>`_ 为有这特权的人， 如系统管理员，希望有一个刚好
  20   可以工作的人性化界面。
  21   使用它，用户可以以人性化的方式使用DAMON的主要功能。不过，它可能不会为特殊情况进行高度调整。
  22   它同时支持虚拟和物理地址空间的监测。更多细节，请参考它的 `使用文档
  23   <https://github.com/awslabs/damo/blob/next/USAGE.md>`_。
  24 - *sysfs接口。*
  25   :ref:`这 <sysfs_interface>` 是为那些希望更高级的使用DAMON的特权用户空间程序员准备的。
  26   使用它，用户可以通过读取和写入特殊的sysfs文件来使用DAMON的主要功能。因此，你可以编写和使
  27   用你个性化的DAMON sysfs包装程序，代替你读/写sysfs文件。  `DAMON用户空间工具
  28   <https://github.com/awslabs/damo>`_ 就是这种程序的一个例子  它同时支持虚拟和物理地址
  29   空间的监测。注意，这个界面只提供简单的监测结果 :ref:`统计 <damos_stats>`。对于详细的监测
  30   结果，DAMON提供了一个:ref:`跟踪点 <tracepoint>`。
  31 - *debugfs interface.*
  32   :ref:`这 <debugfs_interface>` 几乎与:ref:`sysfs interface <sysfs_interface>` 接
  33   口相同。这将在下一个LTS内核发布后被移除，所以用户应该转移到
  34   :ref:`sysfs interface <sysfs_interface>`。
  35 - *内核空间编程接口。*
  36   :doc:`这 </vm/damon/api>` 这是为内核空间程序员准备的。使用它，用户可以通过为你编写内
  37   核空间的DAMON应用程序，最灵活有效地利用DAMON的每一个功能。你甚至可以为各种地址空间扩展DAMON。
  38   详细情况请参考接口 :doc:`文件 </vm/damon/api>`。
  39
  40 sysfs接口
  41 =========
  42 DAMON的sysfs接口是在定义 ``CONFIG_DAMON_SYSFS`` 时建立的。它在其sysfs目录下创建多
  43 个目录和文件， ``<sysfs>/kernel/mm/damon/`` 。你可以通过对该目录下的文件进行写入和
  44 读取来控制DAMON。
  45
  46 对于一个简短的例子，用户可以监测一个给定工作负载的虚拟地址空间，如下所示::
  47
  48     # cd /sys/kernel/mm/damon/admin/
  49     # echo 1 > kdamonds/nr && echo 1 > kdamonds/0/contexts/nr
  50     # echo vaddr > kdamonds/0/contexts/0/operations
  51     # echo 1 > kdamonds/0/contexts/0/targets/nr
  52     # echo $(pidof <workload>) > kdamonds/0/contexts/0/targets/0/pid
  53     # echo on > kdamonds/0/state
  54
  55 文件层次结构
  56 ------------
  57
  58 DAMON sysfs接口的文件层次结构如下图所示。在下图中，父子关系用缩进表示，每个目录有
  59 ``/`` 后缀，每个目录中的文件用逗号（","）分开。 ::
  60
  61     /sys/kernel/mm/damon/admin
  62     │ kdamonds/nr_kdamonds
  63     │ │ 0/state,pid
  64     │ │ │ contexts/nr_contexts
  65     │ │ │ │ 0/operations
  66     │ │ │ │ │ monitoring_attrs/
  67     │ │ │ │ │ │ intervals/sample_us,aggr_us,update_us
  68     │ │ │ │ │ │ nr_regions/min,max
  69     │ │ │ │ │ targets/nr_targets
  70     │ │ │ │ │ │ 0/pid_target
  71     │ │ │ │ │ │ │ regions/nr_regions
  72     │ │ │ │ │ │ │ │ 0/start,end
  73     │ │ │ │ │ │ │ │ ...
  74     │ │ │ │ │ │ ...
  75     │ │ │ │ │ schemes/nr_schemes
  76     │ │ │ │ │ │ 0/action
  77     │ │ │ │ │ │ │ access_pattern/
  78     │ │ │ │ │ │ │ │ sz/min,max
  79     │ │ │ │ │ │ │ │ nr_accesses/min,max
  80     │ │ │ │ │ │ │ │ age/min,max
  81     │ │ │ │ │ │ │ quotas/ms,bytes,reset_interval_ms
  82     │ │ │ │ │ │ │ │ weights/sz_permil,nr_accesses_permil,age_permil
  83     │ │ │ │ │ │ │ watermarks/metric,interval_us,high,mid,low
  84     │ │ │ │ │ │ │ stats/nr_tried,sz_tried,nr_applied,sz_applied,qt_exceeds
  85     │ │ │ │ │ │ ...
  86     │ │ │ │ ...
  87     │ │ ...
  88
  89 根
  90 --
  91
  92 DAMON sysfs接口的根是 ``<sysfs>/kernel/mm/damon/`` ，它有一个名为 ``admin`` 的
  93 目录。该目录包含特权用户空间程序控制DAMON的文件。拥有根权限的用户空间工具或deamons可以
  94 使用这个目录。
  95
  96 kdamonds/
  97 ---------
  98
  99 与监测相关的信息包括请求规格和结果被称为DAMON上下文。DAMON用一个叫做kdamond的内核线程
 100 执行每个上下文，多个kdamonds可以并行运行。
 101
 102 在 ``admin`` 目录下，有一个目录，即``kdamonds``，它有控制kdamonds的文件存在。在开始
 103 时，这个目录只有一个文件，``nr_kdamonds``。向该文件写入一个数字（``N``），就会创建名为
 104 ``0`` 到 ``N-1`` 的子目录数量。每个目录代表每个kdamond。
 105
 106 kdamonds/<N>/
 107 -------------
 108
 109 在每个kdamond目录中，存在两个文件（``state`` 和 ``pid`` ）和一个目录( ``contexts`` )。
 110
 111 读取 ``state`` 时，如果kdamond当前正在运行，则返回 ``on`` ，如果没有运行则返回 ``off`` 。
 112 写入 ``on`` 或 ``off`` 使kdamond处于状态。向 ``state`` 文件写 ``update_schemes_stats`` ，
 113 更新kdamond的每个基于DAMON的操作方案的统计文件的内容。关于统计信息的细节，请参考
 114 :ref:`stats section <sysfs_schemes_stats>`.
 115
 116 如果状态为 ``on``，读取 ``pid`` 显示kdamond线程的pid。
 117
 118 ``contexts`` 目录包含控制这个kdamond要执行的监测上下文的文件。
 119
 120 kdamonds/<N>/contexts/
 121 ----------------------
 122
 123 在开始时，这个目录只有一个文件，即 ``nr_contexts`` 。向该文件写入一个数字( ``N`` )，就会创
 124 建名为``0`` 到 ``N-1`` 的子目录数量。每个目录代表每个监测背景。目前，每个kdamond只支持
 125 一个上下文，所以只有 ``0`` 或 ``1`` 可以被写入文件。
 126
 127 contexts/<N>/
 128 -------------
 129
 130 在每个上下文目录中，存在一个文件(``operations``)和三个目录(``monitoring_attrs``,
 131 ``targets``, 和 ``schemes``)。
 132
 133 DAMON支持多种类型的监测操作，包括对虚拟地址空间和物理地址空间的监测。你可以通过向文件
 134 中写入以下关键词之一，并从文件中读取，来设置和获取DAMON将为上下文使用何种类型的监测操作。
 135
 136  - vaddr: 监测特定进程的虚拟地址空间
 137  - paddr: 监视系统的物理地址空间
 138
 139 contexts/<N>/monitoring_attrs/
 140 ------------------------------
 141
 142 用于指定监测属性的文件，包括所需的监测质量和效率，都在 ``monitoring_attrs`` 目录中。
 143 具体来说，这个目录下有两个目录，即 ``intervals`` 和 ``nr_regions`` 。
 144
 145 在 ``intervals`` 目录下，存在DAMON的采样间隔(``sample_us``)、聚集间隔(``aggr_us``)
 146 和更新间隔(``update_us``)三个文件。你可以通过写入和读出这些文件来设置和获取微秒级的值。
 147
 148 在 ``nr_regions`` 目录下，有两个文件分别用于DAMON监测区域的下限和上限（``min`` 和 ``max`` ），
 149 这两个文件控制着监测的开销。你可以通过向这些文件的写入和读出来设置和获取这些值。
 150
 151 关于间隔和监测区域范围的更多细节，请参考设计文件 (:doc:`/vm/damon/design`)。
 152
 153 contexts/<N>/targets/
 154 ---------------------
 155
 156 在开始时，这个目录只有一个文件 ``nr_targets`` 。向该文件写入一个数字(``N``)，就可以创建
 157 名为 ``0`` 到 ``N-1`` 的子目录的数量。每个目录代表每个监测目标。
 158
 159 targets/<N>/
 160 ------------
 161
 162 在每个目标目录中，存在一个文件(``pid_target``)和一个目录(``regions``)。
 163
 164 如果你把 ``vaddr`` 写到 ``contexts/<N>/operations`` 中，每个目标应该是一个进程。你
 165 可以通过将进程的pid写到 ``pid_target`` 文件中来指定DAMON的进程。
 166
 167 targets/<N>/regions
 168 -------------------
 169
 170 当使用 ``vaddr`` 监测操作集时（ ``vaddr`` 被写入 ``contexts/<N>/operations`` 文
 171 件），DAMON自动设置和更新监测目标区域，这样就可以覆盖目标进程的整个内存映射。然而，用户可
 172 能希望将初始监测区域设置为特定的地址范围。
 173
 174 相反，当使用 ``paddr`` 监测操作集时，DAMON不会自动设置和更新监测目标区域（ ``paddr``
 175 被写入 ``contexts/<N>/operations`` 中）。因此，在这种情况下，用户应该自己设置监测目标
 176 区域。
 177
 178 在这种情况下，用户可以按照自己的意愿明确设置初始监测目标区域，将适当的值写入该目录下的文件。
 179
 180 开始时，这个目录只有一个文件， ``nr_regions`` 。向该文件写入一个数字(``N``)，就可以创
 181 建名为 ``0`` 到  ``N-1`` 的子目录。每个目录代表每个初始监测目标区域。
 182
 183 regions/<N>/
 184 ------------
 185
 186 在每个区域目录中，你会发现两个文件（ ``start``  和  ``end`` ）。你可以通过向文件写入
 187 和从文件中读出，分别设置和获得初始监测目标区域的起始和结束地址。
 188
 189 contexts/<N>/schemes/
 190 ---------------------
 191
 192 对于一版的基于DAMON的数据访问感知的内存管理优化，用户通常希望系统对特定访问模式的内存区
 193 域应用内存管理操作。DAMON从用户那里接收这种形式化的操作方案，并将这些方案应用于目标内存
 194 区域。用户可以通过读取和写入这个目录下的文件来获得和设置这些方案。
 195
 196 在开始时，这个目录只有一个文件，``nr_schemes``。向该文件写入一个数字(``N``)，就可以
 197 创建名为``0``到``N-1``的子目录的数量。每个目录代表每个基于DAMON的操作方案。
 198
 199 schemes/<N>/
 200 ------------
 201
 202 在每个方案目录中，存在四个目录(``access_pattern``, ``quotas``,``watermarks``,
 203 和 ``stats``)和一个文件(``action``)。
 204
 205 ``action`` 文件用于设置和获取你想应用于具有特定访问模式的内存区域的动作。可以写入文件
 206 和从文件中读取的关键词及其含义如下。
 207
 208  - ``willneed``: 对有 ``MADV_WILLNEED`` 的区域调用 ``madvise()`` 。
 209  - ``cold``: 对具有 ``MADV_COLD`` 的区域调用 ``madvise()`` 。
 210  - ``pageout``: 为具有 ``MADV_PAGEOUT`` 的区域调用 ``madvise()`` 。
 211  - ``hugepage``: 为带有 ``MADV_HUGEPAGE`` 的区域调用 ``madvise()`` 。
 212  - ``nohugepage``: 为带有 ``MADV_NOHUGEPAGE`` 的区域调用 ``madvise()``。
 213  - ``lru_prio``: 在其LRU列表上对区域进行优先排序。
 214  - ``lru_deprio``: 对区域的LRU列表进行降低优先处理。
 215  - ``stat``: 什么都不做，只计算统计数据
 216
 217 schemes/<N>/access_pattern/
 218 ---------------------------
 219
 220 每个基于DAMON的操作方案的目标访问模式由三个范围构成，包括以字节为单位的区域大小、每个
 221 聚合区间的监测访问次数和区域年龄的聚合区间数。
 222
 223 在 ``access_pattern`` 目录下，存在三个目录（ ``sz``, ``nr_accesses``, 和 ``age`` ），
 224 每个目录有两个文件（``min`` 和 ``max`` ）。你可以通过向  ``sz``, ``nr_accesses``, 和
 225 ``age``  目录下的 ``min`` 和 ``max`` 文件分别写入和读取来设置和获取给定方案的访问模式。
 226
 227 schemes/<N>/quotas/
 228 -------------------
 229
 230 每个 ``动作`` 的最佳 ``目标访问模式`` 取决于工作负载，所以不容易找到。更糟糕的是，将某些动作
 231 的方案设置得过于激进会造成严重的开销。为了避免这种开销，用户可以为每个方案限制时间和大小配额。
 232 具体来说，用户可以要求DAMON尽量只使用特定的时间（``时间配额``）来应用行动，并且在给定的时间间
 233 隔（``重置间隔``）内，只对具有目标访问模式的内存区域应用行动，而不使用特定数量（``大小配额``）。
 234
 235 当预计超过配额限制时，DAMON会根据 ``目标访问模式`` 的大小、访问频率和年龄，对找到的内存区域
 236 进行优先排序。为了进行个性化的优先排序，用户可以为这三个属性设置权重。
 237
 238 在 ``quotas`` 目录下，存在三个文件（``ms``, ``bytes``, ``reset_interval_ms``）和一个
 239 目录(``weights``)，其中有三个文件(``sz_permil``, ``nr_accesses_permil``, 和
 240 ``age_permil``)。
 241
 242 你可以设置以毫秒为单位的 ``时间配额`` ，以字节为单位的 ``大小配额`` ，以及以毫秒为单位的 ``重
 243 置间隔`` ，分别向这三个文件写入数值。你还可以通过向 ``weights`` 目录下的三个文件写入数值来设
 244 置大小、访问频率和年龄的优先权，单位为千分之一。
 245
 246 schemes/<N>/watermarks/
 247 -----------------------
 248
 249 为了便于根据系统状态激活和停用每个方案，DAMON提供了一个称为水位的功能。该功能接收五个值，称为
 250 ``度量`` 、``间隔`` 、``高`` 、``中`` 、``低`` 。``度量值`` 是指可以测量的系统度量值，如
 251 自由内存比率。如果系统的度量值 ``高`` 于memoent的高值或 ``低`` 于低值，则该方案被停用。如果
 252 该值低于 ``中`` ，则该方案被激活。
 253
 254 在水位目录下，存在五个文件(``metric``, ``interval_us``,``high``, ``mid``, and ``low``)
 255 用于设置每个值。你可以通过向这些文件的写入来分别设置和获取这五个值。
 256
 257 可以写入 ``metric`` 文件的关键词和含义如下。
 258
 259  - none: 忽略水位
 260  - free_mem_rate: 系统的自由内存率（千分比）。
 261
 262 ``interval`` 应以微秒为单位写入。
 263
 264 schemes/<N>/stats/
 265 ------------------
 266
 267 DAMON统计每个方案被尝试应用的区域的总数量和字节数，每个方案被成功应用的区域的两个数字，以及
 268 超过配额限制的总数量。这些统计数据可用于在线分析或调整方案。
 269
 270 可以通过读取 ``stats`` 目录下的文件(``nr_tried``, ``sz_tried``, ``nr_applied``,
 271 ``sz_applied``, 和 ``qt_exceeds``)）分别检索这些统计数据。这些文件不是实时更新的，所以
 272 你应该要求DAMON sysfs接口通过在相关的 ``kdamonds/<N>/state`` 文件中写入一个特殊的关键字
 273 ``update_schemes_stats`` 来更新统计信息的文件内容。
 274
 275 用例
 276 ~~~~
 277
 278 下面的命令应用了一个方案：”如果一个大小为[4KiB, 8KiB]的内存区域在[10, 20]的聚合时间间隔内
 279 显示出每一个聚合时间间隔[0, 5]的访问量，请分页该区域。对于分页，每秒最多只能使用10ms，而且每
 280 秒分页不能超过1GiB。在这一限制下，首先分页出具有较长年龄的内存区域。另外，每5秒钟检查一次系统
 281 的可用内存率，当可用内存率低于50%时开始监测和分页，但如果可用内存率大于60%，或低于30%，则停
 282 止监测。“ ::
 283
 284     # cd <sysfs>/kernel/mm/damon/admin
 285     # # populate directories
 286     # echo 1 > kdamonds/nr_kdamonds; echo 1 > kdamonds/0/contexts/nr_contexts;
 287     # echo 1 > kdamonds/0/contexts/0/schemes/nr_schemes
 288     # cd kdamonds/0/contexts/0/schemes/0
 289     # # set the basic access pattern and the action
 290     # echo 4096 > access_patterns/sz/min
 291     # echo 8192 > access_patterns/sz/max
 292     # echo 0 > access_patterns/nr_accesses/min
 293     # echo 5 > access_patterns/nr_accesses/max
 294     # echo 10 > access_patterns/age/min
 295     # echo 20 > access_patterns/age/max
 296     # echo pageout > action
 297     # # set quotas
 298     # echo 10 > quotas/ms
 299     # echo $((1024*1024*1024)) > quotas/bytes
 300     # echo 1000 > quotas/reset_interval_ms
 301     # # set watermark
 302     # echo free_mem_rate > watermarks/metric
 303     # echo 5000000 > watermarks/interval_us
 304     # echo 600 > watermarks/high
 305     # echo 500 > watermarks/mid
 306     # echo 300 > watermarks/low
 307
 308 请注意，我们强烈建议使用用户空间的工具，如 `damo <https://github.com/awslabs/damo>`_ ，
 309 而不是像上面那样手动读写文件。以上只是一个例子。
 310
 311 debugfs接口
 312 ===========
 313
 314 DAMON导出了八个文件, ``attrs``, ``target_ids``, ``init_regions``,
 315 ``schemes``, ``monitor_on``, ``kdamond_pid``, ``mk_contexts`` 和
 316 ``rm_contexts`` under its debugfs directory, ``<debugfs>/damon/``.
 317
 318
 319 属性
 320 ----
 321
 322 用户可以通过读取和写入 ``attrs`` 文件获得和设置 ``采样间隔`` 、 ``聚集间隔`` 、 ``更新间隔``
 323 以及监测目标区域的最小/最大数量。要详细了解监测属性，请参考 `:doc:/vm/damon/design` 。例如，
 324 下面的命令将这些值设置为5ms、100ms、1000ms、10和1000，然后再次检查::
 325
 326     # cd <debugfs>/damon
 327     # echo 5000 100000 1000000 10 1000 > attrs
 328     # cat attrs
 329     5000 100000 1000000 10 1000
 330
 331
 332 目标ID
 333 ------
 334
 335 一些类型的地址空间支持多个监测目标。例如，虚拟内存地址空间的监测可以有多个进程作为监测目标。用户
 336 可以通过写入目标的相关id值来设置目标，并通过读取 ``target_ids`` 文件来获得当前目标的id。在监
 337 测虚拟地址空间的情况下，这些值应该是监测目标进程的pid。例如，下面的命令将pid为42和4242的进程设
 338 为监测目标，并再次检查::
 339
 340     # cd <debugfs>/damon
 341     # echo 42 4242 > target_ids
 342     # cat target_ids
 343     42 4242
 344
 345 用户还可以通过在文件中写入一个特殊的关键字 "paddr\n" 来监测系统的物理内存地址空间。因为物理地
 346 址空间监测不支持多个目标，读取文件会显示一个假值，即 ``42`` ，如下图所示::
 347
 348     # cd <debugfs>/damon
 349     # echo paddr > target_ids
 350     # cat target_ids
 351     42
 352
 353 请注意，设置目标ID并不启动监测。
 354
 355
 356 初始监测目标区域
 357 ----------------
 358
 359 在虚拟地址空间监测的情况下，DAMON自动设置和更新监测的目标区域，这样就可以覆盖目标进程的整个
 360 内存映射。然而，用户可能希望将监测区域限制在特定的地址范围内，如堆、栈或特定的文件映射区域。
 361 或者，一些用户可以知道他们工作负载的初始访问模式，因此希望为“自适应区域调整”设置最佳初始区域。
 362
 363 相比之下，DAMON在物理内存监测的情况下不会自动设置和更新监测目标区域。因此，用户应该自己设置
 364 监测目标区域。
 365
 366 在这种情况下，用户可以通过在 ``init_regions`` 文件中写入适当的值，明确地设置他们想要的初
 367 始监测目标区域。输入的每一行应代表一个区域，形式如下::
 368
 369     <target idx> <start address> <end address>
 370
 371 目标idx应该是 ``target_ids`` 文件中目标的索引，从 ``0`` 开始，区域应该按照地址顺序传递。
 372 例如，下面的命令将设置几个地址范围， ``1-100`` 和 ``100-200`` 作为pid 42的初始监测目标
 373 区域，这是 ``target_ids`` 中的第一个（索引 ``0`` ），另外几个地址范围， ``20-40`` 和
 374 ``50-100`` 作为pid 4242的地址，这是 ``target_ids`` 中的第二个（索引 ``1`` ）::
 375
 376     # cd <debugfs>/damon
 377     # cat target_ids
 378     42 4242
 379     # echo "0   1       100
 380             0   100     200
 381             1   20      40
 382             1   50      100" > init_regions
 383
 384 请注意，这只是设置了初始的监测目标区域。在虚拟内存监测的情况下，DAMON会在一个 ``更新间隔``
 385 后自动更新区域的边界。因此，在这种情况下，如果用户不希望更新的话，应该把 ``更新间隔`` 设
 386 置得足够大。
 387
 388
 389 方案
 390 ----
 391
 392 对于通常的基于DAMON的数据访问感知的内存管理优化，用户只是希望系统对特定访问模式的内存区域应用内
 393 存管理操作。DAMON从用户那里接收这种形式化的操作方案，并将这些方案应用到目标进程中。
 394
 395 用户可以通过读取和写入 ``scheme`` debugfs文件来获得和设置这些方案。读取该文件还可以显示每个
 396 方案的统计数据。在文件中，每一个方案都应该在每一行中以下列形式表示出来::
 397
 398     <target access pattern> <action> <quota> <watermarks>
 399
 400 你可以通过简单地在文件中写入一个空字符串来禁用方案。
 401
 402 目标访问模式
 403 ~~~~~~~~~~~~
 404
 405 ``<目标访问模式>`` 是由三个范围构成的，形式如下::
 406
 407     min-size max-size min-acc max-acc min-age max-age
 408
 409 具体来说，区域大小的字节数（ `min-size` 和 `max-size` ），访问频率的每聚合区间的监测访问次
 410 数（ `min-acc` 和 `max-acc` ），区域年龄的聚合区间数（ `min-age` 和 `max-age` ）都被指定。
 411 请注意，这些范围是封闭区间。
 412
 413 动作
 414 ~~~~
 415
 416 ``<action>`` 是一个预定义的内存管理动作的整数，DAMON将应用于具有目标访问模式的区域。支持
 417 的数字和它们的含义如下::
 418
 419  - 0: Call ``madvise()`` for the region with ``MADV_WILLNEED``
 420  - 1: Call ``madvise()`` for the region with ``MADV_COLD``
 421  - 2: Call ``madvise()`` for the region with ``MADV_PAGEOUT``
 422  - 3: Call ``madvise()`` for the region with ``MADV_HUGEPAGE``
 423  - 4: Call ``madvise()`` for the region with ``MADV_NOHUGEPAGE``
 424  - 5: Do nothing but count the statistics
 425
 426 配额
 427 ~~~~
 428
 429 每个 ``动作`` 的最佳 ``目标访问模式`` 取决于工作负载，所以不容易找到。更糟糕的是，将某个
 430 动作的方案设置得过于激进会导致严重的开销。为了避免这种开销，用户可以通过下面表格中的 ``<quota>``
 431 来限制方案的时间和大小配额::
 432
 433     <ms> <sz> <reset interval> <priority weights>
 434
 435 这使得DAMON在 ``<reset interval>`` 毫秒内，尽量只用 ``<ms>`` 毫秒的时间对 ``目标访
 436 问模式`` 的内存区域应用动作，并在 ``<reset interval>`` 内只对最多<sz>字节的内存区域应
 437 用动作。将 ``<ms>`` 和 ``<sz>`` 都设置为零，可以禁用配额限制。
 438
 439 当预计超过配额限制时，DAMON会根据 ``目标访问模式`` 的大小、访问频率和年龄，对发现的内存
 440 区域进行优先排序。为了实现个性化的优先级，用户可以在 ``<优先级权重>`` 中设置这三个属性的
 441 权重，具体形式如下::
 442
 443     <size weight> <access frequency weight> <age weight>
 444
 445 水位
 446 ~~~~
 447
 448 有些方案需要根据系统特定指标的当前值来运行，如自由内存比率。对于这种情况，用户可以为该条
 449 件指定水位。::
 450
 451     <metric> <check interval> <high mark> <middle mark> <low mark>
 452
 453 ``<metric>`` 是一个预定义的整数，用于要检查的度量。支持的数字和它们的含义如下。
 454
 455  - 0: 忽视水位
 456  - 1: 系统空闲内存率 (千分比)
 457
 458 每隔 ``<检查间隔>`` 微秒检查一次公制的值。
 459
 460 如果该值高于 ``<高标>`` 或低于 ``<低标>`` ，该方案被停用。如果该值低于 ``<中标>`` ，
 461 该方案将被激活。
 462
 463 统计数据
 464 ~~~~~~~~
 465
 466 它还统计每个方案被尝试应用的区域的总数量和字节数，每个方案被成功应用的区域的两个数量，以
 467 及超过配额限制的总数量。这些统计数据可用于在线分析或调整方案。
 468
 469 统计数据可以通过读取方案文件来显示。读取该文件将显示你在每一行中输入的每个 ``方案`` ，
 470 统计的五个数字将被加在每一行的末尾。
 471
 472 例子
 473 ~~~~
 474
 475 下面的命令应用了一个方案：”如果一个大小为[4KiB, 8KiB]的内存区域在[10, 20]的聚合时间
 476 间隔内显示出每一个聚合时间间隔[0, 5]的访问量，请分页出该区域。对于分页，每秒最多只能使
 477 用10ms，而且每秒分页不能超过1GiB。在这一限制下，首先分页出具有较长年龄的内存区域。另外，
 478 每5秒钟检查一次系统的可用内存率，当可用内存率低于50%时开始监测和分页，但如果可用内存率
 479 大于60%，或低于30%，则停止监测“::
 480
 481     # cd <debugfs>/damon
 482     # scheme="4096 8192  0 5    10 20    2"  # target access pattern and action
 483     # scheme+=" 10 $((1024*1024*1024)) 1000" # quotas
 484     # scheme+=" 0 0 100"                     # prioritization weights
 485     # scheme+=" 1 5000000 600 500 300"       # watermarks
 486     # echo "$scheme" > schemes
 487
 488
 489 开关
 490 ----
 491
 492 除非你明确地启动监测，否则如上所述的文件设置不会产生效果。你可以通过写入和读取 ``monitor_on``
 493 文件来启动、停止和检查监测的当前状态。写入 ``on`` 该文件可以启动对有属性的目标的监测。写入
 494 ``off`` 该文件则停止这些目标。如果每个目标进程被终止，DAMON也会停止。下面的示例命令开启、关
 495 闭和检查DAMON的状态::
 496
 497     # cd <debugfs>/damon
 498     # echo on > monitor_on
 499     # echo off > monitor_on
 500     # cat monitor_on
 501     off
 502
 503 请注意，当监测开启时，你不能写到上述的debugfs文件。如果你在DAMON运行时写到这些文件，将会返
 504 回一个错误代码，如 ``-EBUSY`` 。
 505
 506
 507 监测线程PID
 508 -----------
 509
 510 DAMON通过一个叫做kdamond的内核线程来进行请求监测。你可以通过读取 ``kdamond_pid`` 文件获
 511 得该线程的 ``pid`` 。当监测被 ``关闭`` 时，读取该文件不会返回任何信息::
 512
 513     # cd <debugfs>/damon
 514     # cat monitor_on
 515     off
 516     # cat kdamond_pid
 517     none
 518     # echo on > monitor_on
 519     # cat kdamond_pid
 520     18594
 521
 522
 523 使用多个监测线程
 524 ----------------
 525
 526 每个监测上下文都会创建一个 ``kdamond`` 线程。你可以使用 ``mk_contexts`` 和 ``rm_contexts``
 527 文件为多个 ``kdamond`` 需要的用例创建和删除监测上下文。
 528
 529 将新上下文的名称写入 ``mk_contexts`` 文件，在 ``DAMON debugfs`` 目录上创建一个该名称的目录。
 530 该目录将有该上下文的 ``DAMON debugfs`` 文件::
 531
 532     # cd <debugfs>/damon
 533     # ls foo
 534     # ls: cannot access 'foo': No such file or directory
 535     # echo foo > mk_contexts
 536     # ls foo
 537     # attrs  init_regions  kdamond_pid  schemes  target_ids
 538
 539 如果不再需要上下文，你可以通过把上下文的名字放到 ``rm_contexts`` 文件中来删除它和相应的目录::
 540
 541     # echo foo > rm_contexts
 542     # ls foo
 543     # ls: cannot access 'foo': No such file or directory
 544
 545 注意， ``mk_contexts`` 、 ``rm_contexts`` 和 ``monitor_on`` 文件只在根目录下。
 546
 547
 548 监测结果的监测点
 549 ================
 550
 551 DAMON通过一个tracepoint ``damon:damon_aggregated`` 提供监测结果.  当监测开启时，你可
 552 以记录追踪点事件，并使用追踪点支持工具如perf显示结果。比如说::
 553
 554     # echo on > monitor_on
 555     # perf record -e damon:damon_aggregated &
 556     # sleep 5
 557     # kill 9 $(pidof perf)
 558     # echo off > monitor_on
 559     # perf script