troubleshoot-php-fpm

What problem does it solve?

Troubleshoots PHP-FPM performance and availability incidents by pinpointing likely failure archetypes such as worker exhaustion, slow request cascades, memory leak spirals, socket backlog overflow, and session lock serialization.

Core Features & Use Cases

• Structured diagnostic tree: Guides an agent through a domain-based triage sequence aligned to the Netdata operator playbook (Availability & Liveness, Saturation & Capacity, Performance & Latency, Resource Utilization, Process Lifecycle, Connectivity).
• MCP-driven service verification: Uses MCP queries to confirm service liveness and pull the key PHP-FPM chart contexts needed to validate hypotheses and track anomalies over time.
• Targeted remediation validation: Re-runs the same MCP verification queries after applying remediation to ensure signals return to expected ranges, reducing false fixes and misdiagnoses.
• Use Case: An on-call engineer sees increased 502/504 errors and latency for a PHP-FPM-backed app and needs a fast, repeatable way to decide whether the root cause is capacity saturation, slow downstream dependencies, memory growth, or session contention.

Quick Start

Tell the AI: "Diagnose and remediate my PHP-FPM incident using Netdata via MCP, validate the root cause with the load-bearing phpfpm.* contexts, and propose the smallest fix that moves the signals back to normal."