postgresql-connection-check

Diagnose PgBouncer health, pool utilization, and max_connections usage in Kubernetes.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Diagnose PgBouncer health, pool utilization, max_connections usage, and service endpoint verification to prevent outages and optimize connection pools.

Core Features & Use Cases

  • PgBouncer health checks and status verification across the cluster
  • Pool utilization metrics and max_connections usage reporting
  • Idle-in-transaction and leak-detection insights with actionable remediation
  • Service endpoint validation for PgBouncer and PostgreSQL endpoints in Kubernetes

Quick Start

Follow the steps in this Skill to verify PgBouncer deployment, inspect pool stats, and confirm service endpoints in your Kubernetes cluster.

Frequently Asked Questions about postgresql-connection-check

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

FAQPage Schema
How do I diagnose PgBouncer health and connection pool utilization in Kubernetes?

Diagnose PgBouncer health by checking pool utilization and max_connections usage via kubectl and psql. This process verifies service endpoints and outputs a structured summary with actionable remediation steps to prevent outages.

How does a PostgreSQL connection check detect idle-in-transaction leaks?

PostgreSQL connection checks detect idle-in-transaction leaks by querying Patroni-aware endpoints and reading PgBouncer configuration. This mechanism identifies leaked connections and provides targeted remediation steps to optimize pool capacity.

Can I run a PostgreSQL health check in a Kubernetes cluster using PgBouncer and Patroni?

Yes, you can run health checks in Kubernetes clusters using PgBouncer and Patroni. The process verifies deployments, inspects pool statistics, and confirms service endpoints for both PgBouncer and PostgreSQL to ensure cluster stability.

What is the best way to verify PgBouncer max_connections usage for capacity planning?

The best way to verify max_connections usage for capacity planning is by inspecting PgBouncer pool stats and service endpoints. This approach reports current utilization and identifies idle-in-transaction issues for proactive connection management.

Why does my PostgreSQL connection pool show high utilization during peak load?

PostgreSQL connection pools show high utilization during peak load when max_connections limits are approached or idle-in-transaction leaks occur. Inspecting PgBouncer status and Patroni-aware metrics reveals the bottleneck and suggests remediation steps.