Debian 12 High I/O Wait Caused by Swap Thrashing

📖 ~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

Application latency spikes as memory pressure forces excessive swap read and write cycles.

Environment & Reproduction

Overcommitted RAM workloads and default swappiness in dense service nodes.

vmstat 1 10

Root Cause Analysis

Memory working set exceeds physical RAM and frequent page reclaim causes heavy I/O wait.

Quick Triage

Identify top memory consumers and verify swap churn levels.

free -m

Step-by-Step Diagnosis

Correlate process memory growth with disk latency and reclaim metrics.

sar -B 1 10

Solution – Primary Fix

Reduce memory pressure, tune swappiness, and right-size workload capacity.

sudo sysctl vm.swappiness=10

Solution – Alternative Approaches

Add RAM, split services, or enable zram for constrained environments.

Verification & Acceptance Criteria

iowait and swap-in rates return to acceptable baseline levels.

iostat -x 1 5

Rollback Plan

Restore prior kernel memory settings if new tuning causes side effects.

Prevention & Hardening

Capacity planning and memory SLO alerts prevent sustained reclaim storms.

Related Errors & Cross-Refs

Reference daemon crashes and out-of-memory kills in similar periods.

Related tutorial: View the step-by-step tutorial for debian-12.

View all debian-12 tutorials on the Tutorials Hub →

Browse all common problems & solutions on the Tutorials Hub.

References & Further Reading

Review Linux memory management and Debian performance tuning guides.