postgresql-health-check

Evaluate Patroni-managed PostgreSQL cluster health on Kubernetes.

1|3|Updated Mar 23, 2026
One-click install
npx skills add https://github.com/IldarMinaev/troubleshooting-skill --skill postgresql-health-check-ildarminaev
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: postgresql-health-check
Source: https://github.com/IldarMinaev/troubleshooting-skill/tree/main/skills/postgresql-health-check
Command: npx skills add https://github.com/IldarMinaev/troubleshooting-skill --skill postgresql-health-check-ildarminaev

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Comprehensive health assessment of a Patroni-managed PostgreSQL cluster running in Kubernetes. Covers Patroni cluster state, replication, pod resources, PVC status, and key database health indicators.

Core Features & Use Cases

  • Patroni cluster status checks and history
  • Pod and PVC health verification across the cluster
  • Disk usage and resource utilization checks with actionable thresholds
  • SQL-based health indicators using provided health_check.sql and replication.sql
  • Use Case: DBAs diagnose outages and optimize PostgreSQL health in Kubernetes clusters

Quick Start

Run the health-check workflow against your Patroni PostgreSQL deployment to generate a health report and recommended actions.

Frequently Asked Questions about postgresql-health-check

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

FAQPage Schema
How do I check Patroni PostgreSQL cluster health in Kubernetes?

To check Patroni PostgreSQL cluster health in Kubernetes, you can run a health-check workflow that evaluates cluster status, replication, pod resources, PVCs, and disk usage. It executes kubectl commands, Patroni tools, and SQL queries to provide a structured health summary.

What does a Patroni PostgreSQL health check include?

A Patroni PostgreSQL health check includes verifying cluster state and history, pod and PVC health, disk usage, resource utilization, and SQL-based health indicators. It uses health_check.sql and replication.sql to evaluate key database metrics across all Patroni pods.

Can I diagnose PostgreSQL replication issues in Kubernetes using kubectl and Patroni tools?

Yes, you can diagnose PostgreSQL replication issues by executing kubectl commands and Patroni tools alongside SQL replication queries. This process evaluates replication status across Patroni pods to identify failures and provide actionable remediation guidance.

How do I monitor PVC and disk usage for PostgreSQL pods in a Kubernetes cluster?

You monitor PVC and disk usage for PostgreSQL pods by running a health assessment that checks PVC status and resource utilization across all Patroni pods. The evaluation applies actionable thresholds to identify capacity limits and prevent disk exhaustion.

Do I need a running Kubernetes cluster with Patroni to use this health check?

Yes, you need a running Kubernetes cluster hosting a Patroni-based PostgreSQL deployment. The health check applies specifically to Kubernetes environments running Patroni to evaluate cluster status, replication, and pod resources accurately.

Why is my Patroni PostgreSQL cluster failing replication in Kubernetes?

Patroni PostgreSQL cluster replication failures in Kubernetes can stem from pod resource exhaustion, PVC issues, or disk limits. Running a health check executes SQL replication queries and evaluates pod resources to identify the root cause and recommend remediation.