LinuxCommandLibrary

sstat

TLDR

Display status of a running job
$ sstat -j [job_id]
copy
Show specific fields in parsable format
$ sstat -p -j [job_id] -o JobID,AveCPU,AveVMSize
copy
List available fields
$ sstat -e
copy
Show all job steps
$ sstat -a -j [job_id]
copy
Show PIDs for each step
$ sstat -i -j [job_id]
copy

SYNOPSIS

sstat [OPTIONS...]

DESCRIPTION

sstat displays real-time status information for running Slurm jobs including CPU usage, memory consumption, and I/O statistics. It queries the jobacct_gather plugin for metrics on currently executing jobs and their steps.
Root users can view all running jobs; regular users can only see their own jobs. The command is useful for monitoring resource usage during job execution and diagnosing performance issues.

PARAMETERS

-j, --jobs job[.step]

Job ID or job.step to query (required)
-o, --format, --fields fields
Comma-separated list of fields to display
-e, --helpformat
List available format fields
-a, --allsteps
Show all steps for specified job
-i, --pidformat
Display PIDs for each job step
-n, --noheader
Omit header from output
-p, --parsable
Pipe-delimited with trailing pipe
-P, --parsable2
Pipe-delimited without trailing pipe
--noconvert
Keep original units (don't convert)
-v, --verbose
Verbose output
-V, --version
Print version

COMMON FIELDS

JobID: Job identifier
AveCPU: Average CPU time
AveRSS: Average resident set size
AveVMSize: Average virtual memory
MaxRSS: Maximum RSS
MaxVMSize: Maximum VM size
NTasks: Number of tasks
MinCPU: Minimum CPU time

CAVEATS

Only works on running jobs; use sacct for completed jobs. Requires the jobacct_gather plugin. Available metrics depend on the specific plugin (linux, cgroup). Non-root users have limited visibility.

HISTORY

sstat is part of Slurm, developed at Lawrence Livermore National Laboratory starting in 2002. Job accounting features help users and administrators monitor resource consumption in real-time. Slurm is now maintained by SchedMD.

SEE ALSO

sacct(1), squeue(1), scontrol(1), srun(1)

> TERMINAL_GEAR

Curated for the Linux community

Copied to clipboard