lustre/doc/lljobstat.8

   1 .TH lljobstat 8 "Oct 14, 2022" Lustre "utilities"
   2
   3 .SH NAME
   4 lljobstat \- display top jobs and statistics
   5
   6 .SH SYNOPSIS
   7 .B "llobdstat"
   8 .RB [ -c|--count
   9 .IR COUNT ]
  10 .RB [ -i|--interval
  11 .IR INTERVAL ]
  12 .RB [ -n|--repeats
  13 .IR REPEATS ]
  14 .RB [ -m|--mdt ]
  15 .RB [ -o|--ost ]
  16 .RB [ --param
  17 .IR PARAM ]
  18 .RB [ --fullname ]
  19 .RB [ --no-fullname ]
  20
  21 .SH DESCRIPTION
  22 .B lljobstat
  23 reads and parses the job_stats files on local node,
  24 sums up the operations of each job, and displays the top jobs.
  25 Repeat for some times or forever with given interval.
  26 .P
  27 Type Ctrl-C to stop printing.
  28
  29 .SS Abbreviations
  30 \fBlljobstat\fR displays abbreviations of operation names as listed below:
  31 .P
  32 .nf
  33 ops: total number of operations
  34 cl: close,      cr: create,     dt: destroy,    fa: fallocate, ga: getattr
  35 gi: get_info,   gx: getxattr,   ln: link,       mi: migrate,   mk: mkdir
  36 mn: mknod,      mv: rename,     op: open,       pa: prealloc,  pu: punch
  37 qc: quotactl,   rd: read,       rm: rmdir,      sa: setattr,   si: set_info
  38 st: statfs,     sx: setxattr,   sy: sync,       ul: unlink,    wr: write
  39 .fi
  40
  41 .SH "OPTIONS"
  42 .TP
  43 \fB-c|--count\fR \fICOUNT\fR
  44 how many top jobs are listed. Default 5.
  45 .TP
  46 \fB-i|--interval\fR \fIINTERVAL\fR
  47 interval in seconds before list top jobs again. Default 10.
  48 .TP
  49 \fB-n|--repeats\fR \fIREPEATS\fR
  50 how many times to repeat. Default unlimited.
  51 .TP
  52 \fB-m|--mdt\fR
  53 get data from only job_stats of MDTs.
  54 .TP
  55 \fB-o|--ost\fR
  56 get data from only job_stats of OSTs.
  57 .TP
  58 \fB--param\fR \fIPARAM\fR
  59 get data from only PARAM path. For example, "*.lustre-*.job_stat".
  60 .TP
  61 \fB--fullname\fR
  62 show full name of operations. Default no.
  63 .TP
  64 \fB--no-fullname\fR
  65 show abbreviated name of operations.
  66 .TP
  67 \fB-h|--help\fR
  68 print help message.
  69
  70 .SH EXAMPLE
  71 .nf
  72 # lljobstat -n 1 -c 3
  73 ---
  74 timestamp: 1665623345
  75 top_jobs:
  76 - rm.0:            {ops: 99, cl: 32, ul: 16, rm: 16, ga: 19, st: 16}
  77 - touch.500:       {ops: 48, op: 8, cl: 8, mn: 8, ga: 8, sa: 16}
  78 - dd.0:            {ops: 38, op: 4, cl: 4, mn: 1, ga: 1, sa: 3, gx: 3, wr: 19, pu: 3}
  79 \[char46]..
  80 .fi