| 1 |
.. SPDX-License-Identifier: GPL-2.0 |
| 2 |
.. include:: ../../../disclaimer-zh_TW.rst |
| 3 |
|
| 4 |
:Original: Documentation/admin-guide/mm/damon/start.rst |
| 5 |
|
| 6 |
:翻譯: |
| 7 |
|
| 8 |
司延騰 Yanteng Si <[email protected]> |
| 9 |
|
| 10 |
:校譯: |
| 11 |
|
| 12 |
======== |
| 13 |
入門指南 |
| 14 |
======== |
| 15 |
|
| 16 |
本文通過演示DAMON的默認用戶空間工具,簡要地介紹瞭如何使用DAMON。請注意,爲了簡潔 |
| 17 |
起見,本文檔只描述了它的部分功能。更多細節請參考該工具的使用文檔。 |
| 18 |
`doc <https://github.com/damonitor/damo/blob/next/USAGE.md>`_ . |
| 19 |
|
| 20 |
|
| 21 |
前提條件 |
| 22 |
======== |
| 23 |
|
| 24 |
內核 |
| 25 |
---- |
| 26 |
|
| 27 |
首先,你要確保你當前系統中跑的內核構建時選定了這個功能選項 ``CONFIG_DAMON_*=y``. |
| 28 |
|
| 29 |
|
| 30 |
用戶空間工具 |
| 31 |
------------ |
| 32 |
|
| 33 |
在演示中,我們將使用DAMON的默認用戶空間工具,稱爲DAMON Operator(DAMO)。它可以在 |
| 34 |
https://github.com/damonitor/damo找到。下面的例子假設DAMO在你的$PATH上。當然,但 |
| 35 |
這並不是強制性的。 |
| 36 |
|
| 37 |
因爲DAMO使用了DAMON的sysfs接口(詳情請參考:doc:`usage`),你應該確保 |
| 38 |
:doc:`sysfs </filesystems/sysfs>` 被掛載。 |
| 39 |
|
| 40 |
記錄數據訪問模式 |
| 41 |
================ |
| 42 |
|
| 43 |
下面的命令記錄了一個程序的內存訪問模式,並將監測結果保存到文件中。 :: |
| 44 |
|
| 45 |
$ git clone https://github.com/sjp38/masim |
| 46 |
$ cd masim; make; ./masim ./configs/zigzag.cfg & |
| 47 |
$ sudo damo record -o damon.data $(pidof masim) |
| 48 |
|
| 49 |
命令的前兩行下載了一個人工內存訪問生成器程序並在後臺運行。生成器將重複地逐一訪問兩個 |
| 50 |
100 MiB大小的內存區域。你可以用你的真實工作負載來代替它。最後一行要求 ``damo`` 將 |
| 51 |
訪問模式記錄在 ``damon.data`` 文件中。 |
| 52 |
|
| 53 |
|
| 54 |
將記錄的模式可視化 |
| 55 |
================== |
| 56 |
|
| 57 |
你可以在heatmap中直觀地看到這種模式,顯示哪個內存區域(X軸)何時被訪問(Y軸)以及訪 |
| 58 |
問的頻率(數字)。:: |
| 59 |
|
| 60 |
$ sudo damo report heats --heatmap stdout |
| 61 |
22222222222222222222222222222222222222211111111111111111111111111111111111111100 |
| 62 |
44444444444444444444444444444444444444434444444444444444444444444444444444443200 |
| 63 |
44444444444444444444444444444444444444433444444444444444444444444444444444444200 |
| 64 |
33333333333333333333333333333333333333344555555555555555555555555555555555555200 |
| 65 |
33333333333333333333333333333333333344444444444444444444444444444444444444444200 |
| 66 |
22222222222222222222222222222222222223355555555555555555555555555555555555555200 |
| 67 |
00000000000000000000000000000000000000288888888888888888888888888888888888888400 |
| 68 |
00000000000000000000000000000000000000288888888888888888888888888888888888888400 |
| 69 |
33333333333333333333333333333333333333355555555555555555555555555555555555555200 |
| 70 |
88888888888888888888888888888888888888600000000000000000000000000000000000000000 |
| 71 |
88888888888888888888888888888888888888600000000000000000000000000000000000000000 |
| 72 |
33333333333333333333333333333333333333444444444444444444444444444444444444443200 |
| 73 |
00000000000000000000000000000000000000288888888888888888888888888888888888888400 |
| 74 |
[...] |
| 75 |
# access_frequency: 0 1 2 3 4 5 6 7 8 9 |
| 76 |
# x-axis: space (139728247021568-139728453431248: 196.848 MiB) |
| 77 |
# y-axis: time (15256597248362-15326899978162: 1 m 10.303 s) |
| 78 |
# resolution: 80x40 (2.461 MiB and 1.758 s for each character) |
| 79 |
|
| 80 |
你也可以直觀地看到工作集的大小分佈,按大小排序。:: |
| 81 |
|
| 82 |
$ sudo damo report wss --range 0 101 10 |
| 83 |
# <percentile> <wss> |
| 84 |
# target_id 18446632103789443072 |
| 85 |
# avr: 107.708 MiB |
| 86 |
0 0 B | | |
| 87 |
10 95.328 MiB |**************************** | |
| 88 |
20 95.332 MiB |**************************** | |
| 89 |
30 95.340 MiB |**************************** | |
| 90 |
40 95.387 MiB |**************************** | |
| 91 |
50 95.387 MiB |**************************** | |
| 92 |
60 95.398 MiB |**************************** | |
| 93 |
70 95.398 MiB |**************************** | |
| 94 |
80 95.504 MiB |**************************** | |
| 95 |
90 190.703 MiB |********************************************************* | |
| 96 |
100 196.875 MiB |***********************************************************| |
| 97 |
|
| 98 |
在上述命令中使用 ``--sortby`` 選項,可以顯示工作集的大小是如何按時間順序變化的。:: |
| 99 |
|
| 100 |
$ sudo damo report wss --range 0 101 10 --sortby time |
| 101 |
# <percentile> <wss> |
| 102 |
# target_id 18446632103789443072 |
| 103 |
# avr: 107.708 MiB |
| 104 |
0 3.051 MiB | | |
| 105 |
10 190.703 MiB |***********************************************************| |
| 106 |
20 95.336 MiB |***************************** | |
| 107 |
30 95.328 MiB |***************************** | |
| 108 |
40 95.387 MiB |***************************** | |
| 109 |
50 95.332 MiB |***************************** | |
| 110 |
60 95.320 MiB |***************************** | |
| 111 |
70 95.398 MiB |***************************** | |
| 112 |
80 95.398 MiB |***************************** | |
| 113 |
90 95.340 MiB |***************************** | |
| 114 |
100 95.398 MiB |***************************** | |
| 115 |
|
| 116 |
|
| 117 |
數據訪問模式感知的內存管理 |
| 118 |
========================== |
| 119 |
|
| 120 |
以下三個命令使每一個大小>=4K的內存區域在你的工作負載中沒有被訪問>=60秒,就會被換掉。 :: |
| 121 |
|
| 122 |
$ echo "#min-size max-size min-acc max-acc min-age max-age action" > test_scheme |
| 123 |
$ echo "4K max 0 0 60s max pageout" >> test_scheme |
| 124 |
$ damo schemes -c test_scheme <pid of your workload> |
| 125 |
|