troubleshoot-proxysql

Official

Triage ProxySQL issues with MCP-backed signals

Authornetdata
Version1.0.0
Installs0

System Documentation

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."

Dependency Matrix

Required Modules

None required

Components

references

💻 Claude Code Installation

Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.

Please help me install this Skill:
Name: troubleshoot-proxysql
Download link: https://github.com/netdata/skills/archive/main.zip#troubleshoot-proxysql

Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
View Source Repository

Agent Skills Search Helper

Install a tiny helper to your Agent, search and equip skill from 471,000+ vetted skills library on demand.