Skip to content

docs: add slurmwatch for live job monitoring (Midway3 module)#251

Open
PursuitOfDataScience wants to merge 1 commit into
rcc-uchicago:mainfrom
PursuitOfDataScience:docs/add-slurmwatch
Open

docs: add slurmwatch for live job monitoring (Midway3 module)#251
PursuitOfDataScience wants to merge 1 commit into
rcc-uchicago:mainfrom
PursuitOfDataScience:docs/add-slurmwatch

Conversation

@PursuitOfDataScience

@PursuitOfDataScience PursuitOfDataScience commented Jul 15, 2026

Copy link
Copy Markdown
Contributor

Adds slurmwatch to the job-monitoring documentation. It is installed as a module on Midway3 (module load slurmwatchslurmwatch/0.8.2(default) under /software/modulefiles) and shows live per-process CPU / memory / GPU usage of a running job as a terminal dashboard.

Changes

  • slurm/sbatch.md → "Monitoring running jobs": lead with slurmwatch (module load + basic usage, and why it complements htop — it isolates your job's own processes, reports GPU utilization/VRAM, and hops to the compute node automatically), keeping the existing SSH + htop method as the alternative.
  • slurm/sinteractive.md: new "Monitoring an interactive session" subsection with the recommended pattern — run it in a second tmux pane on the compute node so it watches your work without creating a contending Slurm step.

The two pages cross-link; no nav change.

Tool repo: https://github.com/PursuitOfDataScience/slurmwatch

slurmwatch is installed as a module on Midway3 (module load slurmwatch)
and shows live per-process CPU / memory / GPU usage of a running job.

- slurm/sbatch.md: lead "Monitoring running jobs" with slurmwatch
  (module load + usage), keeping the SSH + htop method as an alternative.
- slurm/sinteractive.md: add "Monitoring an interactive session" with the
  tmux-second-pane-on-the-node pattern.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant