Linux kernel mirror (for testing) git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel os linux

Documentation: remove overloads-avoided counter from knfsd-stats.txt

The 'overloads-avoided' counter itself was removed several years ago by
commit 78c210e (Revert "knfsd: avoid overloading the CPU scheduler with
enormous load averages").

Signed-off-by: Scott Mayhew <smayhew@redhat.com>
Signed-off-by: J. Bruce Fields <bfields@redhat.com>

authored by

Scott Mayhew and committed by
J. Bruce Fields
72faedae fd891454

+4 -40
+4 -40
Documentation/filesystems/nfs/knfsd-stats.txt
··· 68 68 rate of change for this counter is zero; significantly non-zero 69 69 values may indicate a performance limitation. 70 70 71 - This can happen either because there are too few nfsd threads in the 72 - thread pool for the NFS workload (the workload is thread-limited), 73 - or because the NFS workload needs more CPU time than is available in 74 - the thread pool (the workload is CPU-limited). In the former case, 75 - configuring more nfsd threads will probably improve the performance 76 - of the NFS workload. In the latter case, the sunrpc server layer is 77 - already choosing not to wake idle nfsd threads because there are too 78 - many nfsd threads which want to run but cannot, so configuring more 79 - nfsd threads will make no difference whatsoever. The overloads-avoided 80 - statistic (see below) can be used to distinguish these cases. 71 + This can happen because there are too few nfsd threads in the thread 72 + pool for the NFS workload (the workload is thread-limited), in which 73 + case configuring more nfsd threads will probably improve the 74 + performance of the NFS workload. 81 75 82 76 threads-woken 83 77 Counts how many times an idle nfsd thread is woken to try to ··· 81 87 network-facing NFS work is being handled quickly, which is a good 82 88 thing. The ideal rate of change for this counter will be close 83 89 to but less than the rate of change of the packets-arrived counter. 84 - 85 - overloads-avoided 86 - Counts how many times the sunrpc server layer chose not to wake an 87 - nfsd thread, despite the presence of idle nfsd threads, because 88 - too many nfsd threads had been recently woken but could not get 89 - enough CPU time to actually run. 90 - 91 - This statistic counts a circumstance where the sunrpc layer 92 - heuristically avoids overloading the CPU scheduler with too many 93 - runnable nfsd threads. The ideal rate of change for this counter 94 - is zero. Significant non-zero values indicate that the workload 95 - is CPU limited. Usually this is associated with heavy CPU usage 96 - on all the CPUs in the nfsd thread pool. 97 - 98 - If a sustained large overloads-avoided rate is detected on a pool, 99 - the top(1) utility should be used to check for the following 100 - pattern of CPU usage on all the CPUs associated with the given 101 - nfsd thread pool. 102 - 103 - - %us ~= 0 (as you're *NOT* running applications on your NFS server) 104 - 105 - - %wa ~= 0 106 - 107 - - %id ~= 0 108 - 109 - - %sy + %hi + %si ~= 100 110 - 111 - If this pattern is seen, configuring more nfsd threads will *not* 112 - improve the performance of the workload. If this patten is not 113 - seen, then something more subtle is wrong. 114 90 115 91 threads-timedout 116 92 Counts how many times an nfsd thread triggered an idle timeout,