(Click to open topic with navigation)
N.230.1 Synopsis
showstats -f <statistictype>
N.230.2 Overview
Shows table of various scheduler statistics.
This command displays a table of the selected Moab Scheduler statistics, such as expansion factor, bypass count, jobs, proc-hours, wallclock accuracy, and backfill information.
Statistics are aggregated over time. This means statistical information is not available for time frames and the -t option is not supported with showstats -f.
N.230.3 Access
This command can be run by any Moab Scheduler Administrator.
Options | Description |
---|---|
AVGBYPASS | The number of times a priority job has been 'bypassed' by backfill, allowing a lower priority job to run ahead of it. See Example N-194 for more information. |
AVGQTIME | Average queue time. Includes summary of job-weighted queue time and total samples. |
AVGXFACTOR | Average expansion factor. Includes summary of job-weighted expansion factor, processor-weighted expansion factor, processor-hour-weighted expansion factor, and total number of samples. |
BFCOUNT | Number of jobs backfilled. Includes summary of job-weighted backfill job percent and total samples. |
BFPHRUN | Number of proc-hours backfilled. Includes summary of job-weighted backfill proc-hour percentage and total samples. |
ESTSTARTTIME | Job start time estimate for jobs meeting specified processor/duration criteria. This estimate is based on the reservation start time analysis algorithm. |
JOBCOUNT | Number of jobs. Includes summary of total jobs and total samples. |
MAXBYPASS | Maximum bypass count. Includes summary of overall maximum bypass and total samples. |
MAXXFACTOR | Maximum expansion factor. Includes summary of overall maximum expansion factor and total samples. |
PHREQUEST | proc-hours requested. Includes summary of total proc-hours requested and total samples. |
PHRUN | proc-hours run. Includes summary of total proc-hours run and total samples. |
QOSDELIVERED | Quality of service delivered. Includes summary of job-weighted quality of service success rate and total samples. |
WCACCURACY | Wallclock accuracy. Includes summary of overall wall clock accuracy and total samples. |
N.230.5 Examples
Example N-193:
> showstats -f AVGXFACTOR Average XFactor Grid [ NODES ][ 00:02:00 ][ 00:04:00 ][ 00:08:00 ][ 00:16:00 ][ 00:32:00 ][ 01:04:00 ][ 02:08:00 ][ 04:16:00 ][ 08:32:00 ][ 17:04:00 ][ 34:08:00 ][ TOTAL ] [ 1 ][ -------- ][ -------- ][ -------- ][ -------- ][ -------- ][ -------- ][ -------- ][ -------- ][ -------- ][ -------- ][ -------- ][ -------- ] [ 2 ][ -------- ][ -------- ][ -------- ][ -------- ][ -------- ][ -------- ][ -------- ][ -------- ][ -------- ][ -------- ][ -------- ][ -------- ] [ 4 ][ -------- ][ -------- ][ -------- ][ -------- ][ -------- ][ -------- ][ 1.00 1][ -------- ][ 1.12 2][ -------- ][ -------- ][ 1.10 3] [ 8 ][ -------- ][ -------- ][ -------- ][ -------- ][ -------- ][ -------- ][ 1.00 2][ 1.24 2][ -------- ][ -------- ][ -------- ][ 1.15 4] [ 16 ][ -------- ][ -------- ][ -------- ][ -------- ][ -------- ][ 1.01 2][ -------- ][ -------- ][ -------- ][ -------- ][ -------- ][ 1.01 2] [ 32 ][ -------- ][ -------- ][ -------- ][ -------- ][ -------- ][ -------- ][ -------- ][ -------- ][ -------- ][ -------- ][ -------- ][ -------- ] [ 64 ][ -------- ][ -------- ][ -------- ][ -------- ][ -------- ][ -------- ][ -------- ][ -------- ][ -------- ][ -------- ][ -------- ][ -------- ] [ 128 ][ -------- ][ -------- ][ -------- ][ -------- ][ -------- ][ -------- ][ -------- ][ -------- ][ -------- ][ -------- ][ -------- ][ -------- ] [ 256 ][ -------- ][ -------- ][ -------- ][ -------- ][ -------- ][ -------- ][ -------- ][ -------- ][ -------- ][ -------- ][ -------- ][ -------- ] [ T TOT ][ -------- ][ -------- ][ -------- ][ -------- ][ -------- ][ 1.01 2][ 1.00 3][ 1.24 2][ 1.12 2][ -------- ][ -------- ] Job Weighted X Factor: 1.0888 Node Weighted X Factor: 1.1147 NS Weighted X Factor: 1.1900 Total Samples: 9
The showstats -f command returns a table with data for the specified STATISTICTYPE parameter. The left-most column shows the maximum number of processors required by the jobs shown in the other columns. The column headers indicate the maximum wallclock time (in HH:MM:SS notation) requested by the jobs shown in the columns. The data returned in the table varies by the STATISTICTYPE requested. For table entries with one number, it is of the data requested. For table entries with two numbers, the left number is the data requested and the right number is the number of jobs used to calculate the average. Table entries that contain only dashes (-------) indicate no job has completed that matches the profile associated for this inquiry. The bottom row shows the totals for each column. Following each table is a summary, which varies by the STATISTICTYPE requested.
The column and row break down can be adjusted using the STATPROC* and STATTIME* parameters respectively.
This particular example shows the average expansion factor grid. Each table entry indicates two pieces of information — the average expansion factor for all jobs that meet this slot's profile and the number of jobs that were used to calculate this average. For example, the XFactors of two jobs were averaged to obtain an average XFactor of 1.24 for jobs requiring over 2 hours 8 minutes, but not more than 4 hours 16 minutes and between 5 and 8 processors. Totals along the bottom provide overall XFactor averages weighted by job, processors, and processor-hours.
> showstats -f AVGBYPASS Average Bypass (bypass count) [ PROCS ][ 0:15:00 ][ 1:00:00 ][ 4:00:00 ][ 16:00:00 ][ 64:00:00 ][ 256:00:00 ][ TOTAL ] [ 1 ][ 0.00 10][ 0.00 70][ 0.00 31][ 0.00 34][ 0.00 6][------------][ 0.00 150] [ 4 ][------------][------------][------------][------------][------------][------------][------------] [ 16 ][ 0.08 37687][ 0.08 164307][ 0.32 117767][ 0.10 34073][ 0.58 1282][------------][ 0.16 355116] [ 64 ][ 0.18 769][ 0.13 1839][ 0.18 8084][ 0.82 2812][ 0.00 34][------------][ 0.31 13538] [ 256 ][ 0.39 316][ 1.40 778][ 4.40 494][ 1.77 28917][ 0.33 6][------------][ 1.79 30511] [ TOTAL ][ 0.08 38782][ 0.09 166994][ 0.33 126376][ 0.86 65835][ 0.57 1328][------------] Job Weighted X Bypass: 0.2932 Total Samples: 399315
The showstats -f command returns a table with data for the specified STATISTICTYPE parameter, in this case for AVGBYPASS. In this particular example, the upper left cell indicates that 10 jobs were run by Moab which had 0-15 minutes of requested walltime and 0-1 procs allocated. The 0.00 indicates that of the 10 jobs, the average number of times the jobs were bypassed was 0, meaning it did not occur. Further, looking at row 256 and column 4:00, we see that 494 jobs have been run by Moab which meet this criteria. On average, these jobs were each bypassed 4.40 times.
Related Topics