troubleshoot-nginx

What problem does it solve?

It helps you rapidly triage common nginx incident patterns by turning ambiguous symptoms into a structured diagnosis backed by Netdata measurements queried via MCP.

Core Features & Use Cases

• Signal-driven nginx triage: Guides an agent through Availability, Throughput, Latency, Errors, Saturation & Resource Utilization, Upstream Health, SSL/TLS, and related domains using the Netdata operator playbook’s diagnostic tree.
• MCP-based verification: Queries worker counts, stub status availability, request rate, active connections, and processing time, then recommends targeted remediation paths.
• Archetype-focused troubleshooting: Detects and routes toward dominant failure modes like connection exhaustion, file descriptor exhaustion, backend cascade failure, buffer spill to disk, SSL CPU saturation, and DNS resolution failures.
• Post-fix validation loop: Re-runs the same MCP queries to confirm signals return to expected ranges, reducing the chance of “fix didn’t hold” outcomes.

Quick Start

Use troubleshoot-nginx when investigating nginx behaving abnormally (connection drops, errors, rising latency, resource saturation, or unexpected restarts) and ask the agent to query Netdata via MCP to determine the most likely failure archetype and remediation.