You are here: 3 Scheduler Commands > Commands > showstats > showstats -f

3.47 showstats -f

3.47.1 Synopsis

showstats -f <statistictype>

3.47.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.

3.47.3 Access

This command can be run by any Moab Scheduler Administrator.

3.47.4 Options

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 3-65 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.

3.47.5 Examples

Example 3-64:  

> 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.

Example 3-65:

> 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 

© 2016 Adaptive Computing