NAME¶
sstat - Display various status information of a running job/step.
SYNOPSIS¶
sstat [
OPTIONS...]
DESCRIPTION¶
Status information for running jobs invoked with SLURM.
The
sstat command displays job status information for your analysis. The
sstat command displays information pertaining to CPU, Task, Node,
Resident Set Size (RSS) and Virtual Memory (VM). You can tailor the output
with the use of the
--fields= option to specify the fields to be shown.
For the root user, the
sstat command displays job status data for any
job running on the system.
For the non-root user, the
sstat output is limited to the user's jobs.
Note: the
sstat command requires that the
jobacct_gather plugin
be installed and operational.
- -a, --allsteps
- Print all steps for the given job(s) when no step is
specified.
- -e, --helpformat
- Print a list of fields that can be specified with the
'--format' option.
- -h, --help
- Displays a general help message.
- -i, --pidformat
- Predefined format to list the pids running for each job
step. (JobId,Nodes,Pids)
- -j, --jobs
- Format is <job(.step)>. Stat this job step or
comma-separated list of job steps. This option is required. The step
portion will default to lowest step running if not specified, unless the
--allsteps flag is set where not specifying a step will result in all
running steps to be displayed. NOTE: A step id of 'batch' will display the
information about the batch step.
- -n, --noheader
- No heading will be added to the output. The default action
is to display a header.
- -o, --format,
--fields
- Comma separated list of fields. (use '--helpformat' for a
list of available fields).
NOTE: When using the format option for listing various fields you can put a
%NUMBER afterwards to specify how many characters should be printed.
i.e. format=name%30 will print 30 characters of field name right justified.
A -30 will print 30 characters left justified.
- -p, --parsable
- output will be '|' delimited with a '|' at the end
- -P, --parsable2
- output will be '|' delimited without a '|' at the end
- --usage
- Display a command usage summary.
- -v, --verbose
- Primarily for debugging purposes, report the state of
various variables during processing.
- -V, --version
- Print version.
Job Status Fields¶
The following are the field options:
- AveCPU
- Average (system + user) CPU time of all tasks in job.
- AvePages
- Average number of page faults of all tasks in job.
- AveRSS
- Average resident set size of all tasks in job.
- AveVMSize
- Average Virtual Memory size of all tasks in job.
- JobID
- The number of the job or job step. It is in the form:
job.jobstep.
- MaxPages
- Maximum number of page faults of all tasks in job.
- MaxPagesNode
- The node on which the maxpages occurred.
- MaxPagesTask
- The task ID where the maxpages occurred.
- MaxRSS
- Maximum resident set size of all tasks in job.
- MaxRSSNode
- The node on which the maxrss occurred.
- MaxRSSTask
- The task ID where the maxrss occurred.
- MaxVMSize
- Maximum Virtual Memory size of all tasks in job.
- MaxVMSizeNode
- The node on which the maxvsize occurred.
- MaxVMSizeTask
- The task ID where the maxvsize occurred.
- MinCPU
- Minimum (system + user) CPU time of all tasks in job.
- MinCPUNode
- The node on which the mincpu occurred.
- MinCPUTask
- The task ID where the mincpu occurred.
- NTasks
- Total number of tasks in a job or step.
EXAMPLES¶
- sstat --format=AveCPU,AvePages,AveRSS,AveVMSize,JobID -j
11
- 25:02.000 0K 1.37M 5.93M 9.0
- sstat -p --format=AveCPU,AvePages,AveRSS,AveVMSize,JobID
-j 11
- 25:02.000|0K|1.37M|5.93M|9.0|
COPYING¶
Copyright (C) 2009 Lawrence Livermore National Security. Produced at Lawrence
Livermore National Laboratory (cf, DISCLAIMER). CODE-OCEC-09-009. All rights
reserved.
This file is part of SLURM, a resource management program. For details, see
<
http://www.schedmd.com/slurmdocs/>.
SLURM is free software; you can redistribute it and/or modify it under the terms
of the GNU General Public License as published by the Free Software
Foundation; either version 2 of the License, or (at your option) any later
version.
SLURM is distributed in the hope that it will be useful, but WITHOUT ANY
WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR
A PARTICULAR PURPOSE. See the GNU General Public License for more details.
SEE ALSO¶
sacct(1)
