From 00db25acca24e72a63a6516aa09b04f796e1b3e9 Mon Sep 17 00:00:00 2001 From: James Nunez Date: Wed, 9 Aug 2017 13:57:58 -0600 Subject: [PATCH] LUDOC-388 stats: Correct extents_stats information The Reference section of the Lustre Manual needs minor corrections in the sections about collecting statistics. These corrections include setting the extents_stats parameter to 1 to reset statistics and specifying what can be used to activate collection of statistics. Change-Id: I4b3f91476427f6be581634c383daebd8b2c8acda Signed-off-by: James Nunez Reviewed-on: https://review.whamcloud.com/28450 Tested-by: Jenkins Reviewed-by: Joseph Gmitter --- LustreProc.xml | 29 ++++++++++++++++------------- 1 file changed, 16 insertions(+), 13 deletions(-) diff --git a/LustreProc.xml b/LustreProc.xml index e52b1f6..1d33d99 100644 --- a/LustreProc.xml +++ b/LustreProc.xml @@ -799,13 +799,14 @@ getxattr 61169 samples [regs] By default, statistics are not collected in the offset_stats, extents_stats, and extents_stats_per_process files to reduce monitoring overhead when this information is not needed. The collection of - statistics in all three of these files is activated by writing anything into any one of - the files. + statistics in all three of these files is activated by writing + anything, except for 0 (zero) and "disable", into any one of the + files. Example: # lctl get_param llite.testfs-f57dee0.offset_stats snapshot_time: 1155748884.591028 (secs.usecs) - RANGE RANGE SMALLEST LARGEST + RANGE RANGE SMALLEST LARGEST R/W PID START END EXTENT EXTENT OFFSET R 8385 0 128 128 128 0 R 8385 0 224 224 224 -128 @@ -902,20 +903,22 @@ R 8385 500 600 100 100 -610 By default, statistics are not collected in the offset_stats, extents_stats, and extents_stats_per_process files to reduce monitoring overhead when this information is not needed. The collection of - statistics in all three of these files is activated by writing anything into any one of - the files. + statistics in all three of these files is activated by writing + anything, except for 0 (zero) and "disable", into any one of the + files.
Client-Based I/O Extent Size Survey - The extent_stats histogram in the llite - directory shows the statistics for the sizes of the read/write I/O extents. This file does - not maintain the per-process statistics. + The extents_stats histogram in the + llite directory shows the statistics for the sizes + of the read/write I/O extents. This file does not maintain the per + process statistics. Example: # lctl get_param llite.testfs-*.extents_stats snapshot_time: 1213828728.348516 (secs.usecs) read | write extents calls % cum% | calls % cum% - + 0K - 4K : 0 0 0 | 2 2 2 4K - 8K : 0 0 0 | 0 0 2 8K - 16K : 0 0 0 | 0 0 2 @@ -930,10 +933,10 @@ extents calls % cum% | calls % cum% was read. The table shows cumulative extents organized according to size with statistics provided separately for reads and writes. Each row in the table shows the number of RPCs for reads and writes respectively (calls), the relative percentage of - total calls (%), and the cumulative percentage to that point in the - table of calls (cum %). - The file can be cleared by issuing the following - command:# lctl set_param llite.testfs-*.extents_stats=0 + total calls (%), and the cumulative percentage to + that point in the table of calls (cum %). + The file can be cleared by issuing the following command: + # lctl set_param llite.testfs-*.extents_stats=1
Per-Process Client I/O Statistics -- 1.8.3.1