CentOS Stream 10 – Common Problem 091 – Diagnosis and Fix

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

Transparent huge pages cause database latency spikes on CentOS Stream 10 disrupts services and slows incident response until the root cause is resolved.

Environment & Reproduction

PostgreSQL latency spikes correlate with THP defrag scans on Stream 10.

cat /sys/kernel/mm/transparent_hugepage/enabled
perf top

Root Cause Analysis

Misalignment between performance configuration and CentOS Stream 10 defaults causes the failure path described above.

Quick Triage

Confirm package state, service status, and recent changes before deeper diagnostics.

systemctl status
rpm -qa | grep -i 
journalctl -p err -b --no-pager | tail -100

Step-by-Step Diagnosis

Capture detailed logs, configuration deltas, and runtime state to isolate the failing component.

perf record -g -a sleep 30
grep -i thp /proc/vmstat
cat /sys/kernel/mm/transparent_hugepage/defrag

Solution – Primary Fix

Apply the targeted configuration change and restart the relevant services to restore expected behavior.

echo madvise | sudo tee /sys/kernel/mm/transparent_hugepage/enabled
echo defer | sudo tee /sys/kernel/mm/transparent_hugepage/defrag
sudo grubby --args='transparent_hugepage=madvise' --update-kernel=ALL

Solution – Alternative Approaches

Disable THP entirely (never) only for workloads that explicitly need it.

Verification & Acceptance Criteria

Validate the fix with deterministic checks and ensure no regressions in dependent services.

cat /sys/kernel/mm/transparent_hugepage/enabled
pg_stat_statements latency

Rollback Plan

Revert configuration and restart services to return to the previous known-good state.

echo always | tee /sys/kernel/mm/transparent_hugepage/enabled

Prevention & Hardening

Bake THP setting into kernel cmdline and validate via Ansible.

Related Errors & Cross-Refs

Related: THP, khugepaged, defrag latency; see also adjacent topics in the CentOS Stream 10 common problems series.

Related tutorial: View the step-by-step tutorial for centos-stream-10.

View all centos-stream-10 tutorials on the Tutorials Hub →

Browse all common problems & solutions on the Tutorials Hub.

References & Further Reading

CentOS Stream documentation, Red Hat upstream guides, and CentOS Stream 10 release notes covering this subsystem.