Debian 11 – sustained high CPU load from runaway processes – Fix & Prevention

📖 ~1 min read

Table of contents

1. Symptom & Impact
2. Environment & Reproduction
3. Root Cause Analysis
4. Quick Triage
5. Step-by-Step Diagnosis
6. Solution – Primary Fix
7. Solution – Alternative Approaches
8. Verification & Acceptance Criteria
9. Rollback Plan
10. Prevention & Hardening
11. Related Errors & Cross-Refs
12. References & Further Reading

Symptom & Impact

System responsiveness degrades and services time out under high CPU usage.

Environment & Reproduction

Often seen after workload spikes, bad deployments, or stuck loops.

cat /etc/os-release
uptime
top -b -n1 | head -n 20

Root Cause Analysis

One or more processes consume disproportionate CPU due to bugs or misconfiguration.

Quick Triage

Identify top CPU consumers and related services.

ps -eo pid,ppid,cmd,%cpu,%mem --sort=-%cpu | head
systemctl --type=service --state=running | head

Step-by-Step Diagnosis

Correlate process activity with logs, recent changes, and request load.

pidstat 1 5
journalctl -S '1 hour ago' | tail -n 200
sar -u 1 5

Solution – Primary Fix

Throttle or restart runaway process and apply configuration fixes.

sudo renice +10 -p PID
sudo systemctl restart SERVICE
sudo systemctl set-property SERVICE CPUQuota=70%

Solution – Alternative Approaches

Scale horizontally or move heavy batch jobs off peak windows.

crontab -e
# shift heavy jobs to off-hours

Verification & Acceptance Criteria

CPU usage stabilizes and latency returns to acceptable baseline.

uptime
mpstat 1 3
ps -eo cmd,%cpu --sort=-%cpu | head

Rollback Plan

Revert recent deployment or package updates tied to CPU regression.

sudo apt install PACKAGE=PREV_VERSION -y
sudo systemctl restart SERVICE

Prevention & Hardening

Set CPU alerts and resource limits for high-risk services.

sudo systemctl edit SERVICE
# add CPUQuota and restart policies

Related Errors & Cross-Refs

Related signals include load average spikes and watchdog restarts.

Related tutorial: View the step-by-step tutorial for Debian 11.

View all Debian 11 tutorials on the Tutorials Hub →

Browse all common problems & solutions on the Tutorials Hub.

References & Further Reading

Debian performance tuning and systemd resource control docs.