troubleshoot-proxysql

Diagnose ProxySQL incidents by mapping symptoms to Netdata signal domains.

1|Updated Apr 17, 2026
One-click install
npx skills add https://github.com/netdata/skills --skill troubleshoot-proxysql
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: troubleshoot-proxysql
Source: https://github.com/netdata/skills/tree/main/skills/troubleshoot-proxysql
Command: npx skills add https://github.com/netdata/skills --skill troubleshoot-proxysql

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

It helps you rapidly diagnose and troubleshoot ProxySQL incidents such as backend connection starvation, multiplexing collapse, monitor false decisions, query rule CPU overload, and configuration drift using Netdata-observed signals.

Core Features & Use Cases

  • Operator-playbook triage tree for ProxySQL failure archetypes, guiding an on-call or developer through a structured diagnostic path.
  • MCP-driven verification that queries Netdata via MCP for backend health, monitor results, connection pool usage, client connection metrics, question/query rates, and related host context.
  • Remediation validation loop that re-checks the same load-bearing metrics after applying changes to confirm the fix actually resolves the signal drift.

Quick Start

Use the troubleshoot-proxysql skill to diagnose a live ProxySQL incident by asking an AI agent: "Diagnose why my ProxySQL is timing out and backends look unhealthy, and tell me the most likely failure archetype and what to check next in Netdata via MCP."

Frequently Asked Questions about troubleshoot-proxysql

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I troubleshoot ProxySQL backend connection starvation during an incident?

To troubleshoot ProxySQL backend connection starvation, you map observed failure symptoms to Netdata operator playbook signal domains. This diagnostic path uses MCP query access to verify backend health and connection pool usage metrics, providing evidence-based remediation suggestions.

What are common ProxySQL failure archetypes I should check during on-call triage?

Common ProxySQL failure archetypes include backend connection starvation, multiplexing collapse, monitor false decisions, query rule CPU overload, and configuration drift. Mapping these symptoms to Netdata contexts via MCP helps identify the root cause during on-call triage.

How can I validate if my ProxySQL configuration drift remediation actually worked?

You validate ProxySQL configuration drift remediation by re-querying expected metric bands through MCP. This remediation validation loop re-checks the same load-bearing Netdata metrics after applying changes to confirm the signal drift is resolved.

Can I diagnose ProxySQL multiplexing collapse using Netdata observability data?

Yes, you can diagnose ProxySQL multiplexing collapse using Netdata observability data. The diagnostic process queries proxysql contexts via MCP to correlate anomaly rankings and client connection metrics, identifying if multiplexing limits are causing the collapse.

Do I need MCP query access to Netdata contexts for ProxySQL incident response?

Yes, MCP query access to Netdata contexts is required for ProxySQL incident response. The diagnostic skill queries proxysql metrics, correlates anomalies, and validates remediation by re-querying expected metric bands through the MCP connection.