From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from kanga.kvack.org (kanga.kvack.org [205.233.56.17]) by smtp.lore.kernel.org (Postfix) with ESMTP id EF184EE801F for ; Mon, 11 Sep 2023 04:59:19 +0000 (UTC) Received: by kanga.kvack.org (Postfix) id 5F1246B0160; Mon, 11 Sep 2023 00:59:19 -0400 (EDT) Received: by kanga.kvack.org (Postfix, from userid 40) id 5A1666B0168; Mon, 11 Sep 2023 00:59:19 -0400 (EDT) X-Delivered-To: int-list-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix, from userid 63042) id 4908D6B0169; Mon, 11 Sep 2023 00:59:19 -0400 (EDT) X-Delivered-To: linux-mm@kvack.org Received: from relay.hostedemail.com (smtprelay0013.hostedemail.com [216.40.44.13]) by kanga.kvack.org (Postfix) with ESMTP id 38BCA6B0160 for ; Mon, 11 Sep 2023 00:59:19 -0400 (EDT) Received: from smtpin12.hostedemail.com (a10.router.float.18 [10.200.18.1]) by unirelay05.hostedemail.com (Postfix) with ESMTP id E0A2940810 for ; Mon, 11 Sep 2023 04:59:18 +0000 (UTC) X-FDA: 81223112796.12.0026534 Received: from ams.source.kernel.org (ams.source.kernel.org [145.40.68.75]) by imf03.hostedemail.com (Postfix) with ESMTP id 089BB20002 for ; Mon, 11 Sep 2023 04:59:16 +0000 (UTC) Authentication-Results: imf03.hostedemail.com; dkim=pass header.d=kernel.org header.s=k20201202 header.b=IqHzNhQy; dmarc=pass (policy=none) header.from=kernel.org; spf=pass (imf03.hostedemail.com: domain of sj@kernel.org designates 145.40.68.75 as permitted sender) smtp.mailfrom=sj@kernel.org ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=hostedemail.com; s=arc-20220608; t=1694408357; h=from:from:sender:reply-to:subject:subject:date:date: message-id:message-id:to:to:cc:cc:mime-version:mime-version: content-type:content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references:dkim-signature; bh=uOx8ScWSHBi0cBUuCTXtnmBmYJYt+uGhSfTmXKZCMoM=; b=wZYSX/mHZjMlP6HU4zGFflpOA5P2dHMDkLrs3RAKSNIdhHAbABY6z6Brg3pDJ9KADBLg7H ZmKqIzOSaFKjccxs9A8Q6IpfEf/4J8Runxbn5pXbu4AX5GFqriellQ7FmgQhGrAsX1F4DG 9ijfuK+GhVfBwGvD1qCEBpj4HVMV244= ARC-Authentication-Results: i=1; imf03.hostedemail.com; dkim=pass header.d=kernel.org header.s=k20201202 header.b=IqHzNhQy; dmarc=pass (policy=none) header.from=kernel.org; spf=pass (imf03.hostedemail.com: domain of sj@kernel.org designates 145.40.68.75 as permitted sender) smtp.mailfrom=sj@kernel.org ARC-Seal: i=1; s=arc-20220608; d=hostedemail.com; t=1694408357; a=rsa-sha256; cv=none; b=j8GziVUBG4RSoYu5CyBWoL0mbEXair+byWx7a4a2wq5ez3/dYYWB3gylNoJtFJyB7KpKeT s907jW1vq31wwxUwFGpqdf6OXIbE/pF/gSJZA4gNFiq6RB2EIlmFx3ktWJ4S6notKawdlv QaNnygAknd5BIFtGqueR2RQAnC9QO30= Received: from smtp.kernel.org (relay.kernel.org [52.25.139.140]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (2048 bits)) (No client certificate requested) by ams.source.kernel.org (Postfix) with ESMTPS id 1188DB80139; Mon, 11 Sep 2023 04:59:15 +0000 (UTC) Received: by smtp.kernel.org (Postfix) with ESMTPSA id 29486C433CB; Mon, 11 Sep 2023 04:59:13 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1694408353; bh=yCdyENSSr2jBoqcU5uuhQp9Eg5ZiZzpyIfgAEWQFG08=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=IqHzNhQypANFa8iW43c8T+CdTyJNbZILeHGR5vSckO9OyBoFNScts3NkhNUB0hUdK Rx5bC7TPP6c1kPbTEQm4UdifFD22iGQnZOYHwLiu6/w9NW3rAlGLD3u3xc2w32aOoi Nwc02GNkWg4NlNb9IM0GaoGG0vBlM1yRLDmB0t9ggDMobW8Qees4i9hw4wfPsBX+rL 9ReNouLD2afycjPERmYjFbmeVk/RljkfbhU+Oj9GNhovKG9UKWU0/PnHfb8K6FMVBK gyc0JMX3jmy2dgaPh5Fktf3uJRTXqchjoXp1EoKv+dZhBQwxh5fiW9XEZVHusV6w5j ZNfpLBdyi3K5g== From: SeongJae Park To: Andrew Morton Cc: SeongJae Park , Jonathan Corbet , damon@lists.linux.dev, linux-mm@kvack.org, linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org Subject: [PATCH 2/2] Docs/admin-guide/mm/damon/usage: document damos_before_apply tracepoint Date: Mon, 11 Sep 2023 04:59:08 +0000 Message-Id: <20230911045908.97649-3-sj@kernel.org> X-Mailer: git-send-email 2.25.1 In-Reply-To: <20230911045908.97649-1-sj@kernel.org> References: <20230911045908.97649-1-sj@kernel.org> MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Rspamd-Queue-Id: 089BB20002 X-Rspam-User: X-Rspamd-Server: rspam02 X-Stat-Signature: qurp8kh3eoo45hdyk15wbhg1j9eeurq3 X-HE-Tag: 1694408356-626064 X-HE-Meta: U2FsdGVkX19gaQaHEfz6Bk3Ux2QOmSh33duLL+ZRyQwTtJNUtTtvMlIDJlVmyumk0HqCHhrRmdNdIvdoxWkVTD2y7e1QITjDCFjmjvP2xZ+p3OeYxJa/atYGUWKNeXJ+z7Ms0dRQ3yG+4oHi/vauH2QbxRf2kM7t2Mr0Co5I01nNUkP7VSWcB4bbCpol+X58vgT8Ez1YrNjTbSP24DcQuQdmYEHJ8WWOruXU9qv+5+1lQOZ1VaQly/L/eovfQzYNg+x+ttXTIgk2TyFhdJ8jlKnmE0YrbjKOb7qP0RjrknTFE0BxX1atsHwVsqvl62sY8nLQyv6fe0FbaK3zD641Rr5Tudl2aEFuLVwoAiRFtwSzd7biTeX3TEp3t2g0X4gsYGZI1KlJnPVyroIthqcNGSisq2Zq6cCENTCYjhCeQ5dEzBJuP81jeHI8A6QngJjB33spMPu0bQXg7/SJUJ9Tmjcde62XVrrDnyeGIfCgrr0ix5WH3QlC/PjQgbAxYKCuXbgAx7gofcmQ0J9BZmEkfMnpEqqNrUfgY30PtiOWjjNx8JuvYNUmzh4/cSWKHBNJxtFhBKwSFAaOpxpgdfDbGXryAK2Mt3hLcjbdtMTvtqnY2wti488/5hVvr8RZaNXJ/uf8fBqqzob3neq0AaSGHcILBfT9nOgs5xITMvOySunHKwsI92VmGzaxOMhC3QiEiyAV3tBBz4weCiJ5EPucil4puoZaggJfqxLHwXzCetEsr3OfEzTb+tlpBTZ5xR1KFwOU7XIOZQcwInJKl2KCEYQZ57xPATpqGbIYWKmnS/vWXhb0mErkOhtQCiNoUROFRMakIAqwjruZmlTWw//F8fQDVrCkkwHJIP+FwLKLQmwHQoBQ6gxRJE0ij3ezLjJcL9pKTNFZfq5Lzha2WPBelSGIBdN3k7ySik6sV0UH9v49cGNuBeGaDFtRWU5DN2JzpypxLUyKj3EzJ22WB5m YFImmQQ9 QoGOfqV/gGUser75abhHtwctE+gNFXd5dhhzb80eRjpGVOWYZlTiEcxginCxosOa4OHyKjQjwz07YwGbdcvU+ncd38LhWGiu49Prv6kAL6LtnQu86x+F6R0dRjIm479xb4b2qYEK8A2rEx990tYkOv+sYuPIig6McxaYM4T/RkYNJiHRcc9mVEYiutHvf1LZB4PEOEY3npmDZW8zNk04DTjdpxxeDQzm58SJic7LkLoN0GVTMiDynY7s3dr6sYgNdmrt9JjGJkSPHVf1My5G2ue1DGB9SY+Rivrm9yYW7qfZpnfKVMMSkUB2P3RqWj4aEr1CdUDSWG9EwLWm1tb7R491bDNC6QNQhhf1SK+WGPi1LMscFcL9exjgnoiKgkpQuTMZvswzBOnnbRZqTAtHvAx5QCIGSs+AjfuSE X-Bogosity: Ham, tests=bogofilter, spamicity=0.000000, version=1.2.4 Sender: owner-linux-mm@kvack.org Precedence: bulk X-Loop: owner-majordomo@kvack.org List-ID: Document damos_before_apply tracepoint on the usage document. Signed-off-by: SeongJae Park --- Documentation/admin-guide/mm/damon/usage.rst | 37 ++++++++++++++++---- 1 file changed, 30 insertions(+), 7 deletions(-) diff --git a/Documentation/admin-guide/mm/damon/usage.rst b/Documentation/admin-guide/mm/damon/usage.rst index 282062b6f134..6272cd36590a 100644 --- a/Documentation/admin-guide/mm/damon/usage.rst +++ b/Documentation/admin-guide/mm/damon/usage.rst @@ -496,15 +496,24 @@ the files as above. Above is only for an example. .. _tracepoint: -Tracepoint for Monitoring Results -================================= +Tracepoints for Monitoring Results +================================== Users can get the monitoring results via the :ref:`tried_regions -` or a tracepoint, ``damon:damon_aggregated``. -While the tried regions directory is useful for getting a snapshot, the -tracepoint is useful for getting a full record of the results. While the -monitoring is turned on, you could record the tracepoint events and show -results using tracepoint supporting tools like ``perf``. For example:: +`. The interface is useful for getting a +snapshot, but it could be inefficient for fully recording all the monitoring +results. For the purpose, two trace points, namely ``damon:damon_aggregated`` +and ``damon:damos_before_apply``, are provided. ``damon:damon_aggregated`` +provides the whole monitoring results, while ``damon:damos_before_apply`` +provides the monitoring results for regions that each DAMON-based Operation +Scheme (:ref:`DAMOS `) is gonna be applied. Hence, +``damon:damos_before_apply`` is more useful for recording internal behavior of +DAMOS, or DAMOS target access +:ref:`pattern ` based query-like efficient +monitoring results recording. + +While the monitoring is turned on, you could record the tracepoint events and +show results using tracepoint supporting tools like ``perf``. For example:: # echo on > monitor_on # perf record -e damon:damon_aggregated & @@ -527,6 +536,20 @@ counter). Finally the tenth field (``X``) shows the ``age`` of the region (refer to :ref:`design ` for more details of the counter). +If the event was ``damon:damos_beofre_apply``, the ``perf script`` output would +be somewhat like below:: + + kdamond.0 47293 [000] 80801.060214: damon:damos_before_apply: ctx_idx=0 scheme_idx=0 target_idx=0 nr_regions=11 121932607488-135128711168: 0 136 + [...] + +Each line of the output represents each monitoring region that each DAMON-based +Operation Scheme was about to be applied at the traced time. The first five +fields are as usual. It shows the index of the DAMON context (``ctx_idx=X``) +of the scheme in the list of the contexts of the context's kdamond, the index +of the scheme (``scheme_idx=X``) in the list of the schemes of the context, in +addition to the output of ``damon_aggregated`` tracepoint. + + .. _debugfs_interface: debugfs Interface (DEPRECATED!) -- 2.25.1