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 X-Spam-Level: X-Spam-Status: No, score=-8.1 required=3.0 tests=DKIM_INVALID,DKIM_SIGNED, HEADER_FROM_DIFFERENT_DOMAINS,INCLUDES_PATCH,MAILING_LIST_MULTI,SIGNED_OFF_BY, SPF_HELO_NONE,SPF_PASS,USER_AGENT_SANE_1 autolearn=ham autolearn_force=no version=3.4.0 Received: from mail.kernel.org (mail.kernel.org [198.145.29.99]) by smtp.lore.kernel.org (Postfix) with ESMTP id 22833C43603 for ; Thu, 5 Dec 2019 03:40:47 +0000 (UTC) Received: from vger.kernel.org (vger.kernel.org [209.132.180.67]) by mail.kernel.org (Postfix) with ESMTP id D4BB7206DB for ; Thu, 5 Dec 2019 03:40:46 +0000 (UTC) Authentication-Results: mail.kernel.org; dkim=fail reason="signature verification failed" (2048-bit key) header.d=infradead.org header.i=@infradead.org header.b="PTQ2sf8b" Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1728764AbfLEDkq (ORCPT ); Wed, 4 Dec 2019 22:40:46 -0500 Received: from bombadil.infradead.org ([198.137.202.133]:41166 "EHLO bombadil.infradead.org" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1728098AbfLEDkq (ORCPT ); Wed, 4 Dec 2019 22:40:46 -0500 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=infradead.org; s=bombadil.20170209; h=Content-Transfer-Encoding: Content-Type:In-Reply-To:MIME-Version:Date:Message-ID:From:References:To: Subject:Sender:Reply-To:Cc:Content-ID:Content-Description:Resent-Date: Resent-From:Resent-Sender:Resent-To:Resent-Cc:Resent-Message-ID:List-Id: List-Help:List-Unsubscribe:List-Subscribe:List-Post:List-Owner:List-Archive; bh=cORBGJCboUCyUCzpMFSqE0ZjXLLsuEogHAyPWQ3G2OE=; b=PTQ2sf8bQ9ubb/hjqPzBwmkJq SjXgdoIxrbd2LCubcP6ti2+2hL5PU7fB7zHWA/nhrBnUvzHwRyI1aJ6HSLtQ+gt5bKXT3qsOjW6Q+ qhleRWY/ytYaWXV2DW+3/zRfYNoLvug3NaU9/D03sv398DzJt0xLt4H7KFlzhRBjRR6pjzRJA8ggP PQ48WHAacs3nxpYbtSXzSWFWWx53IszKUT0gkjhbt3HNkFV8uFI0TpISKQuazG9b1Vi8p5SrXRD9I vERjgJ2EfjSnQK/h2Q9jQtMW++LY+nfy77YiFOBx+x/9p7XfdqV60GqQFsRR4KAO1Agqy7stYc1lD lr3W3aKEA==; Received: from [2601:1c0:6280:3f0::3deb] by bombadil.infradead.org with esmtpsa (Exim 4.92.3 #3 (Red Hat Linux)) id 1ici0P-0006Mw-Kq; Thu, 05 Dec 2019 03:40:42 +0000 Subject: Re: [PATCH v4 2/2] sched/numa: documentation for per-cgroup numa statistics To: =?UTF-8?B?546L6LSH?= , Ingo Molnar , Peter Zijlstra , Juri Lelli , Vincent Guittot , Dietmar Eggemann , Steven Rostedt , Ben Segall , Mel Gorman , Luis Chamberlain , Kees Cook , Iurii Zaikin , =?UTF-8?Q?Michal_Koutn=c3=bd?= , linux-fsdevel@vger.kernel.org, linux-kernel@vger.kernel.org, linux-doc@vger.kernel.org, "Paul E. McKenney" , Jonathan Corbet References: <743eecad-9556-a241-546b-c8a66339840e@linux.alibaba.com> <207ef46c-672c-27c8-2012-735bd692a6de@linux.alibaba.com> <040def80-9c38-4bcc-e4a8-8a0d10f131ed@linux.alibaba.com> <25cf7ef5-e37e-7578-eea7-29ad0b76c4ea@linux.alibaba.com> From: Randy Dunlap Message-ID: Date: Wed, 4 Dec 2019 19:40:40 -0800 User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:68.0) Gecko/20100101 Thunderbird/68.2.1 MIME-Version: 1.0 In-Reply-To: Content-Type: text/plain; charset=utf-8 Content-Language: en-US Content-Transfer-Encoding: 8bit Sender: linux-doc-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-doc@vger.kernel.org On 12/4/19 12:00 AM, 王贇 wrote: > Add the description for 'numa_locality', also a new doc to explain > the details on how to deal with the per-cgroup numa statistics. > > Cc: Peter Zijlstra > Cc: Michal Koutný > Cc: Mel Gorman > Cc: Jonathan Corbet > Cc: Iurii Zaikin > Cc: Randy Dunlap > Signed-off-by: Michael Wang > --- > Documentation/admin-guide/cg-numa-stat.rst | 178 ++++++++++++++++++++++++ > Documentation/admin-guide/index.rst | 1 + > Documentation/admin-guide/kernel-parameters.txt | 4 + > Documentation/admin-guide/sysctl/kernel.rst | 9 ++ > init/Kconfig | 6 +- > 5 files changed, 196 insertions(+), 2 deletions(-) > create mode 100644 Documentation/admin-guide/cg-numa-stat.rst > > diff --git a/Documentation/admin-guide/cg-numa-stat.rst b/Documentation/admin-guide/cg-numa-stat.rst > new file mode 100644 > index 000000000000..5d1f623451d5 > --- /dev/null > +++ b/Documentation/admin-guide/cg-numa-stat.rst > @@ -0,0 +1,178 @@ > +.. SPDX-License-Identifier: GPL-2.0 > + > +=============================== > +Per-cgroup NUMA statistics > +=============================== > + > +Background > +---------- > + > +On NUMA platforms, remote memory accessing always has a performance penalty. > +Although we have NUMA balancing working hard to maximize the access locality, > +there are still situations it can't help. > + > +This could happen in modern production environment. When a large number of > +cgroups are used to classify and control resources, this creates a complex > +configuration for memory policy, CPUs and NUMA nodes. In such cases NUMA > +balancing could end up with the wrong memory policy or exhausted local NUMA > +node, which would lead to low percentage of local page accesses. > + > +We need to detect such cases, figure out which workloads from which cgroup > +have introduced the issues, then we get chance to do adjustment to avoid > +performance degradation. > + > +However, there are no hardware counters for per-task local/remote accessing > +info, we don't know how many remote page accesses have occurred for a > +particular task. > + > +NUMA Locality > +------------- > + > +Fortunately, we have NUMA Balancing which scans task's mapping and triggers > +page fault periodically, giving us the opportunity to record per-task page > +accessing info, when the CPU fall into PF is from the same node of pages, we > +consider task as doing local page accessing, otherwise the remote page > +accessing, we call these two counter the locality info. > + > +On each tick, we acquire the locality info of current task on that CPU, update > +the increments into it's cgroup, becoming the group locality info. its (it's means it is, which is not correct here) > + > +By "echo 1 > /proc/sys/kernel/numa_locality" at runtime or adding boot parameter > +'numa_locality', we will enable the accounting of per-cgroup NUMA locality info, > +the 'cpu.numa_stat' entry of CPU cgroup will show statistics:: > + > + page_access local=NR_LOCAL_PAGE_ACCESS remote=NR_REMOTE_PAGE_ACCESS > + > +We define 'NUMA locality' as:: > + > + NR_LOCAL_PAGE_ACCESS * 100 / (NR_LOCAL_PAGE_ACCESS + NR_REMOTE_PAGE_ACCESS) > + > +This per-cgroup percentage number help to represent the NUMA Balancing behavior. helps > + > +Note that the accounting is hierarchical, which means the NUMA locality info for > +a given group represent not only the workload of this group, but also the > +workloads of all its descendants. > + > +For example the 'cpu.numa_stat' show:: shows:: > + > + page_access local=129909383 remote=18265810 > + > +The NUMA locality calculated as:: > + > + 129909383 * 100 / (129909383 + 18265810) = 87.67 > + > +Thus we know the workload of this group and its descendants have totally done > +129909383 times of local page accessing and 18265810 times of remotes, locality > +is 87.67% which imply most of the memory access are local. > + > +NUMA Consumption > +---------------- > + > +There are also other cgroup entry help us to estimate NUMA efficiency, which is > +'cpuacct.usage_percpu' and 'memory.numa_stat'. > + > +By reading 'cpuacct.usage_percpu' we will get per-cpu runtime (in nanoseconds) > +info (in hierarchy) as:: > + > + CPU_0_RUNTIME CPU_1_RUNTIME CPU_2_RUNTIME ... CPU_X_RUNTIME > + > +Combined with the info from:: > + > + cat /sys/devices/system/node/nodeX/cpulist > + > +We would be able to accumulate the runtime of CPUs into NUMA nodes, to get the > +per-cgroup node runtime info. > + > +By reading 'memory.numa_stat' we will get per-cgroup node memory consumption > +info as:: > + > + total=TOTAL_MEM N0=MEM_ON_NODE0 N1=MEM_ON_NODE1 ... NX=MEM_ON_NODEX > + > +Together we call these the per-cgroup NUMA consumption info, tell us how many > +resources a particular workload has consumed, on a particular NUMA node. > + > +Monitoring > +---------- > + > +By monitoring the increments of locality info, we can easily know whether NUMA > +Balancing is working well for a particular workload. > + > +For example we take a 5 seconds sample period, then on each sampling we have:: > + > + local_diff = last_nr_local_page_access - nr_local_page_access > + remote_diff = last_nr_remote_page_access - nr_remote_page_access > + > +and we get the locality in this period as:: > + > + locality = local_diff * 100 / (local_diff + remote_diff) > + > +We can plot a line for locality, when the line close to 100% things are good, > +when getting close to 0% something is wrong, we can pick a proper watermark to > +trigger warning message. > + > +You may want to drop the data if the local/remote_diff is too small, which > +implies there are not many available pages for NUMA Balancing to scan, ignoring > +would be fine since most likely the workload is insensitive to NUMA, or the > +memory topology is already good enough. > + > +Monitoring root group helps you control the overall situation, while you may > +also want to monitor all the leaf groups which contain the workloads, this > +helps to catch the mouse. > + > +Try to put your workload into also the cpuacct & memory cgroup, when NUMA > +Balancing is disabled or locality becomes too small, we may want to monitoring to monitor > +the per-node runtime & memory info to see if the node consumption meet the > +requirements. > + > +For NUMA node X on each sampling we have:: > + > + runtime_X_diff = runtime_X - last_runtime_X > + runtime_all_diff = runtime_all - last_runtime_all > + > + runtime_percent_X = runtime_X_diff * 100 / runtime_all_diff > + memory_percent_X = memory_X * 100 / memory_all > + > +These two percentages are usually matched on each node, workload should execute > +mostly on the node that contains most of its memory, but it's not guaranteed. > + > +The workload may only access a small part of its memory, in such cases although > +the majority of memory are remotely, locality could still be good. > + > +Thus to tell if things are fine or not depends on the understanding of system > +resource deployment, however, if you find node X got 100% memory percent but 0% > +runtime percent, definitely something is wrong. > + > +Troubleshooting > +--------------- > + > +After identifying which workload introduced the bad locality, check: > + > +1). Is the workload bound to a particular NUMA node? > +2). Has any NUMA node run out of resources? > + > +There are several ways to bind task's memory with a NUMA node, the strict way > +like the MPOL_BIND memory policy or 'cpuset.mems' will limit the memory > +node where to allocate pages. In this situation, admin should make sure the > +task is allowed to run on the CPUs of that NUMA node, and make sure there are > +available CPU resource there. > + > +There are also ways to bind task's CPU with a NUMA node, like 'cpuset.cpus' or > +sched_setaffinity() syscall. In this situation, NUMA Balancing help to migrate > +pages into that node, admin should make sure there are available memory there. > + > +Admin could try to rebind or unbind the NUMA node to erase the damage, make a > +change then observe the statistics to see if things get better until the > +situation is acceptable. > + > +Highlights > +---------- > + > +For some tasks, NUMA Balancing may found no necessary to scan pages, and may be found to be unnecessary > +locality could always be 0 or small number, don't pay attention to them > +since they most likely insensitive to NUMA. > + > +There is no accounting until the option is turned on, so enable it in advance > +if you want to have the whole history. > + > +We have per-task migfailed counter to tell how many page migration has been > +failed for a particular task, you will find it in /proc/PID/sched entry. HTH. -- ~Randy