dataiotech Labs
dbaguide.com · Senior DBA & SRE Diagnostic Standard v2.0
Home/Hata Kütüphanesi/POSTGRESQL/postgresql-too-many-connections-for-role
PostgreSQL
PG 14 - 17SEVERITY: P2 MEDIUM
5 dk okuma
FATAL: too many connections for role "app_user"

PostgreSQL Rol Bağlantı Limiti Aşımı: Nedenleri, Acil Limit Artırımı ve Rol Bazlı Havuzlama

ALTER ROLE ... CONNECTION LIMIT kısıtlamasının uygulama pod artışıyla dolması, acil limit düzenleme ve PgBouncer kullanıcı bazlı havuz mimarisi.

İnceleyen:Kıdemli Veritabanı Mimarı & SRE (dataiotech Labs)·2 Kasım 2026

Teshis & Ayırt Etme Protokolü (Disambiguation)

Ne Zaman Görülür?

PG 14 - 17 ortamında istemci ile veritabanı arasındaki bağlantı, soket veya ağ zaman aşımı durumunu ifade eder.

Ne Zaman Bu Hata DEĞİLDİR?

Sorgu optimizasyonu veya veri bozulması değildir; bağlantı ve kimlik doğrulama katmanına aittir.

Operasyonel Kanıt & Laboratuvar Doğrulaması

Gerçek veritabanı sürümlerinde test edilmiş teknik sınırlar ve güvenlik protokolü.

Laboratuvarda Doğrulandı
Test Edilen Sürümler

PostgreSQL 14.10, 15.6, 16.4, 17.11 (Ubuntu 24.04)

Gerekli Yetki

SUPERUSER veya CREATEROLE

Risk & Etki Alanı
MediumCONNECTION LIMIT değerini -1 (sınırsız) yapmak kümenin max_connections sınırını tüketebilir
Geri Alma (Rollback)

ALTER ROLE app_user CONNECTION LIMIT 50;

Beklenen Çıktı & Doğrulama Kriteri

Rol bağlantı sayısının CONNECTION LIMIT değerinin altına inmesi

Resmî Dokümantasyon Referansı

PostgreSQL Docs: ALTER ROLE Connection Limits

Belgeyi Yeni Sekmede Aç
İlk 60 Saniye Teşhis Protokolü (Read-Only Safety Rule):

Hata mesajı bir semptomdur, kök neden değildir. Sunucuyu veya veritabanı servisini körü körüne yeniden başlatmayın! Önce aşağıdaki salt-okunur (read-only) teşhis sorgularını çalıştırarak gerçek arıza modunu tespit edin; ardından kontrollü müdahaleye geçin.

▸Belirti

Belirli bir mikroservis bağlantı kurmaya çalıştığında reddedilirken diğer servisler sorunsuz çalışır:

plaintext
FATAL: too many connections for role "app_user"

▸Sahada Ne Görürsün?

Süper kullanıcı ve diğer roller bağlanabilir. Ancak app_user kullanan pod'lar bağlantı havuzu zaman aşımına (HikariPool - Connection is not available) uğrar.


▸Kök Neden Matrisi

OlasılıkKök NedenAçıklama
%65Uygulama Pod ÖlçeklenmesiCONNECTION LIMIT 20 belirlenmiştir. Pod sayısı 2'den 6'ya çıkınca kota anında patlar.
%25Bağlantı Sızıntısı (Connection Leak)Uygulama idle oturumları kapatmamış, kotayı doldurmuştur.
%10Katı Limit PolitikasıDBA limiti trafik artışına göre güncellenmemiştir.

▸ACİL RUNBOOK (0-5dk)

sql
-- 1. Rol limitini ve mevcut oturumları gör SELECT rolname, rolconnlimit FROM pg_roles WHERE rolname = 'app_user'; SELECT count(*), state FROM pg_stat_activity WHERE usename = 'app_user' GROUP BY state; -- 2. Acil kotayı geçici kaldır (-1 = sınırsız) ALTER ROLE app_user CONNECTION LIMIT -1; -- 3. Boştaki oturumları sonlandır SELECT pg_terminate_backend(pid) FROM pg_stat_activity WHERE usename = 'app_user' AND state = 'idle' AND state_change < now() - interval '5 minutes';

▸KALICI BLUEPRINT

  1. 1PgBouncer Havuzlama: İstemciler doğrudan değil PgBouncer üzerinden bağlanmalıdır.
  2. 2Rol Limiti: Pod Sayısı x Havuz x 1.2 formülü uygulanmalıdır:
sql
ALTER ROLE app_user CONNECTION LIMIT 60;
  1. 1Oturum Zaman Aşımları: ALTER ROLE app_user SET idle_in_transaction_session_timeout = '1min';

▸Doğrulama

sql
SELECT r.rolname, r.rolconnlimit, count(s.pid) AS active_connections FROM pg_roles r LEFT JOIN pg_stat_activity s ON r.rolname = s.usename WHERE r.rolname = 'app_user' GROUP BY r.rolname, r.rolconnlimit;
YENİ KONSEPTMÜHENDİSLİK BECERİSİ
Senior Mülakat Hazırlığı

POSTGRESQL Bağlantı Havuzu (Connection Pooling), Ağ Zaman Aşımları ve Soket Yönetimi.

Bu hata yalnızca bir parametre eksikliği değil; veri tutarlılığı, concurrency mimarisi ve kapasite planlaması dersidir.

Öğrenme Hedefleri (Ölçülebilir Çıktılar):
  • İstemci bağlantı havuzu tükenmesi ile veritabanı listener arızasını ayırt edebilmek.
  • Ağ güvenlik duvarı ve keepalive parametrelerini production standardına getirebilmek.

Senior Mülakatında Bu Hatadan Ne Sorulur?

Q1POSTGRESQL üzerinde bağlantı kesintilerini izlerken ilk hangi işletim sistemi ve veritabanı metriğine bakılmalıdır?
Mid
Senior Mühendis / Mimar Yanıtı:

Veritabanı aktif/idle bağlantı sayıları, OS seviyesinde netstat/ss soket durumları (TIME_WAIT, CLOSE_WAIT) ve listener hata logları kontrol edilmelidir.

Q2Keepalive ayarları bağlantı kopmalarını nasıl engeller?
Senior
Senior Mühendis / Mimar Yanıtı:

Güvenlik duvarları veya load balancerlar boşta kalan TCP oturumlarını sessizce düşürür. TCP keepalive periyodik boş paket göndererek oturumun canlı kalmasını sağlar.

Q3Uygulama katmanında bağlantı sızıntısı (connection leak) nasıl tespit edilir?
Junior
Senior Mühendis / Mimar Yanıtı:

Veritabanı oturum listesinde uzun süre idle kalan bağlantılar, artan havuz kullanım oranları ve uygulama APM araçlarındaki unclosed connection uyarıları izlenir.

Kıdemli DBA & SRE Kariyer Yol Haritası

Veritabanı güvenilirliği, kriz yönetimi ve mimarlık aşamalarını keşfedin.

Yol Haritasını İncele

POSTGRESQL Hata Kütüphanesinden Diğer Başlıklar

Kriz anında başvurabileceğiniz diğer doğrulanmış teşhis rehberleri.

Tümünü Gör
dbaguide.com · PostgreSQL FATAL: too many connections for role Teşhisi · Kanıt Odaklı Teşhis Standardı
Son Güncelleme: 2 Kasım 2026 · Format v2.0