Skip to main content

Tests codecov PyPI License: GPL v2 DOI

Job Defense Shield

Job Defense Shield is a software tool for identifying and reducing instances of underutilization by the users of high-performance computing systems. The software can (1) send automated email alerts to users, (2) create reports for system administrators, and (3) automatically cancel GPU jobs at 0% utilization. Job Defense Shield is a component of the Jobstats job monitoring platform.

Below is an example report for 0% GPU utilization:

                         GPU-Hours at 0% Utilization
---------------------------------------------------------------------
    User   GPU-Hours-At-0%  Jobs             JobID             Emails
---------------------------------------------------------------------
1  u12998        308         39   62285369,62303767,62317153+   1 (7)
2  u9l487         84         14   62301737,62301738,62301742+   0         
3  u39635         25          2            62184669,62187323    2 (4)         
4  u24074         24         13   62303182,62303183,62303184+   0         
---------------------------------------------------------------------
   Cluster: della
Partitions: gpu, llm
     Start: Wed June 10, 2026 at 09:50 AM
       End: Wed June 17, 2026 at 09:50 AM

Below is an example email to a user that is requesting too much CPU memory:

Hi Alan (u12345),

Below are your jobs that ran on the Stellar cluster in the past 7 days:

     JobID   Memory-Used  Memory-Allocated  Percent-Used  Cores  Hours
    5761066      2 GB          100 GB            2%         1     48
    5761091      4 GB          100 GB            4%         1     48
    5761092      3 GB          100 GB            3%         1     48

It appears that you are requesting too much CPU memory for your jobs since
you are only using on average 3% of the allocated memory. For help on
allocating CPU memory with Slurm, please see:

    https://your-institution.edu/knowledge-base/memory

Replying to this automated email will open a support ticket with Research
Computing.

Getting Started

See the documentation for installing and running the software.

Metadata

Release files for job-defense-shield 1.3.3

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for job-defense-shield 1.3.3
File Size Uploaded
job_defense_shield-1.3.3.tar.gz 121.6 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for job-defense-shield 1.3.3
File Interpreter ABI Platform
job_defense_shield-1.3.3-py3-none-any.whl Python 3 none any Details

Total release size: 217.1 kB

Release files / job_defense_shield-1.3.3.tar.gz

Download URL job_defense_shield-1.3.3.tar.gz
Size 121.6 kB
Tags Source
SHA-256 checksum
How to use checksums
f1811bcead357a32bbfb139591b519a5b9f133083c2549cc5368788d31ebfc3e
BLAKE2b-256 checksum
How to use checksums
fdd3563d59f2b0a022891cdc36a45f847e98e62c2027bd95a2b7709c47cd9eea
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.13.13

Release files / job_defense_shield-1.3.3-py3-none-any.whl

Download URL job_defense_shield-1.3.3-py3-none-any.whl
Size 95.4 kB
Tags Python 3
SHA-256 checksum
How to use checksums
639d2dde6a56d8c4404adbd4181b89f28c8221595930b8aa005a965f5af57d07
BLAKE2b-256 checksum
How to use checksums
7c4a105cc5021f705acc024b5d588d9c211363c5de1d2328d37df51c8bd4995d
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.13.13

Release history Release notifications | RSS feed

1.3.4

2 release files

This release

1.3.3 This release

2 release files

1.3.2

2 release files

1.3.1

2 release files

1.3.0

2 release files

1.2.6

2 release files

1.2.5

2 release files

1.2.4

2 release files

1.2.3

2 release files

1.2.2

2 release files

1.2.1

2 release files

1.2.0

2 release files

1.1.2

2 release files

1.1.1

2 release files

1.1.0

2 release files

1.0.2

2 release files

1.0.1

2 release files

1.0.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page