troubleshoot-postgresql

Official

Diagnose PostgreSQL failures with Netdata signals

Authornetdata
Version1.0.0
Installs0

System Documentation

What problem does it solve?

It helps you rapidly triage PostgreSQL incidents by identifying likely failure archetypes (connection exhaustion, lock contention cascades, autovacuum starvation/bloat, transaction ID wraparound emergencies, checkpoint storms, and replication lag spirals) and validating them with the same Netdata signals used by the operator playbook.

Core Features & Use Cases

  • Structured diagnostic tree for PostgreSQL: Guides an AI operator through a deterministic triage order aligned to Netdata’s PostgreSQL playbook domains (Availability, Throughput, Latency, Internal State, Replication, Security & Integrity).
  • Signal-driven MCP verification: Uses Netdata MCP query patterns to confirm process liveness, recovery state, connection health, transaction/row throughput, and domain-specific metrics before recommending remediation.
  • Archetype-focused remediation guidance: Connects observed anomalies to likely root causes and suggests next remediation steps with “re-run to verify” validation behavior.

Quick Start

Ask an AI agent: "Diagnose my PostgreSQL incident using Netdata via MCP and recommend the most likely remediation after verification."

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-postgresql
Download link: https://github.com/netdata/skills/archive/main.zip#troubleshoot-postgresql

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.