Ubuntu 18.04 LTS PHP-FPM Pool Exhaustion

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

Dynamic pages fail or stall when PHP-FPM workers are exhausted.

Environment & Reproduction

Ubuntu 18.04 web stacks with high concurrency and default PHP-FPM pool limits.

Root Cause Analysis

Insufficient pm settings and slow scripts consume all workers, creating request backlog.

Quick Triage

Check FPM status and logs for max_children warnings and queue growth.

Step-by-Step Diagnosis

Profile request durations, inspect pool config, and correlate saturation with traffic peaks.

Solution – Primary Fix

Adjust pool sizing, tune timeouts, and remediate slow endpoints driving worker occupancy.

Solution – Alternative Approaches

Split workloads across pools or horizontal scale PHP workers behind load balancer.

Verification & Acceptance Criteria

No max_children alerts under peak load and request latency stabilizes.

Rollback Plan

Restore prior pool values if memory pressure increases beyond safe limits.

Prevention & Hardening

Monitor FPM utilization and enforce performance budgets for application endpoints.

Related Errors & Cross-Refs

Often co-occurs with Apache/Nginx upstream timeout and 503 incidents.

Related tutorial: View the step-by-step tutorial for Ubuntu 18.04 LTS.

View all Ubuntu 18.04 LTS tutorials on the Tutorials Hub →

Browse all common problems & solutions on the Tutorials Hub.

References & Further Reading

Review PHP-FPM process manager documentation and Ubuntu web tuning practices.