FATAL: sorry, too many clients alreadyPostgreSQL "too many clients already": Salt Okunur Teşhis, Darboğaz Ayrımı ve Güvenli Müdahale
FATAL: sorry, too many clients already ve remaining connection slots hatalarının üç temel kök nedeni, yetki sınırlarıyla salt okunur pg_stat_activity teşhisi ve kalıcı iki katmanlı havuzlama çözümü.
Teshis & Ayırt Etme Protokolü (Disambiguation)
PG 14 - 17 ortamında istemci ile veritabanı arasındaki bağlantı, soket veya ağ zaman aşımı durumunu ifade eder.
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ü.
Canlı Laboratuvar: PostgreSQL 17.11 (Alpine Linux / Docker 29.7, PgBouncer 1.26.1) | Tarihsel Doğrulama: PostgreSQL 14.10, 15.6, 16.4 (Ubuntu 24.04 LTS, Docker 26.1, Kernel 6.8)
SUPERUSER veya pg_read_all_stats / pg_signal_backend (standart kullanıcılar yalnızca kendi oturumlarını görebilir)
Geçici session timeout parametrelerini sıfırlama, PgBouncer reload veya uygulama havuz boyutunu eski haline alma
pg_stat_activity sorgusunda bağlantı sayısının güvenli bütçe altına inmesi ve pg_stat_database.numbackends stabilitesi
PostgreSQL Docs: Connections & Authentication
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.
▸1. Belirti ve Hata Kodlarının Ayrımı
FATAL: remaining connection slots are reserved... ise, normal slotlar dolmuş fakat süper kullanıcı kurtarma penceresi hâlâ açıktır. İnceleyin: PostgreSQL remaining connection slots reserved Hatası.
- Eğer hata soket düzeyinde Connection refused ise, sorun bağlantı kotası değil servisin kapalı veya portun dinlemede olmamasıdır. İnceleyin: PostgreSQL connection refused: 8 Adımda Kesin Teşhis.Uygulama sunucuları aniden veritabanına erişemez hale gelir; uygulama loglarında ve PostgreSQL hata günlüğünde iki farklı hata mesajı gözlemlenir:
-- Durum A: Tüm genel bağlantı slotları tükendiğinde
FATAL: sorry, too many clients already
-- Durum B: Standart slotlar dolup yalnızca süper kullanıcı/rezerve slotlar kaldığında
FATAL: remaining connection slots are reserved for non-replication superuser connectionsmax_connections parametresi, veritabanı kümesine aynı anda açılabilecek toplam TCP oturumu tavanıdır.
- Standart (ayrıcalıksız) uygulama kullanıcılarının erişebileceği tavan: max_connections - superuser_reserved_connections - reserved_connections formülüyle belirlenir (PostgreSQL 16+ sürümünde reserved_connections eklenmiştir).
- Örneğin max_connections = 50, superuser_reserved_connections = 3 ve reserved_connections = 2 olarak yapılandırıldığında, standart bir uygulama rolünün teorik kapasite tavanı 45 bağlantıdır. Eşzamanlı bağlantı atağında normal yuvalar dolduğunda ek bağlantı talepleri rezerv yuvalar gerekçesiyle (remaining connection slots are reserved) reddedilir.
- Bu ayrım, veritabanı kilitlendiğinde dahi nöbetçi mühendisin veya izleme servisinin sisteme erişip teşhis yapabilmesini garanti eder.▸2. Kök Neden Darboğazını Ayırt Etme
"Too many clients" hatası tek bir nedenden kaynaklanmaz. Üretim sistemlerinde bağlantı tükenmesi üç farklı operasyonel darboğazın sonucudur:
- 1Boşta Bağlantı Sızıntısı (`state = 'idle'`): Mikroservislerin veya arka plan worker'larının havuzsuz doğrudan bağlantı açması ve işlem yapmadığı halde soketi açık tutması.
- 2Kapatılmayan İşlemler (`state = 'idle in transaction'`): Uygulama kodunun
BEGINile işlem başlatıp, harici bir HTTP servisini beklerken veya hata alıpCOMMIT/ROLLBACKgöndermeden oturumu askıda bırakması. Bu durum hem bağlantı slotunu işgal eder hem de tablo/satır kilitlerini (Lock) tutarak diğer oturumları arkasına kilitler. - 3Eşzamanlı Yavaş Sorgu Yığılması (`state = 'active'`): Veritabanında eksik indeks, kilit çekişmesi (
wait_event_type = 'Lock') veya ani trafik dalgası nedeniyle normalde 5ms süren sorguların yüzlerce worker sürecini dakikalarca meşgul etmesi.
▸3. Salt Okunur Teşhis Protokolü (`pg_stat_activity`)
Üretim sisteminde bağlantı tükendiğinde panikle sunucuyu yeniden başlatmak veya bağlantıları körlemesine kesmek durumu daha da kötüleştirebilir. Önce sistemin ne yaptığını salt okunur kontrollerle analiz edin.
SUPERUSER veya pg_read_all_stats (PG 10+) yetkisine sahip olmayan standart kullanıcılar pg_stat_activity tablosunda yalnızca kendi oturumlarının query ve client_addr bilgilerini görebilir. Diğer kullanıcıların sorguları <insufficient privilege> olarak maskelenir. Bu nedenle teşhis sorguları rezerve slot üzerinden süper kullanıcıyla veya pg_monitor / pg_read_all_stats rolüne sahip bir gözlemci hesabıyla çalıştırılmalıdır.Adım 3.1: Filo Dağılım Özeti (Tek Bakışta Durum Tespiti)
-- Güvenli ve salt okunur durum dağılımı
SELECT
count(*) AS toplam_baglanti,
count(*) FILTER (WHERE state = 'active') AS aktif_sorgu,
count(*) FILTER (WHERE state = 'idle') AS bosta_bekleyen,
count(*) FILTER (WHERE state = 'idle in transaction') AS islemde_kilitli_bosta,
count(*) FILTER (WHERE wait_event_type = 'Lock') AS kilit_bekleyen_oturum
FROM pg_stat_activity
WHERE backend_type = 'client backend';Adım 3.2: En Çok Bağlantı Tutan Uygulama ve İstemci IP'leri
SELECT
COALESCE(client_addr::text, 'local') AS istemci_ip,
COALESCE(application_name, '[isimsiz]') AS uygulama_adi,
usename AS veritabani_kullanicisi,
state AS oturum_durumu,
count(*) AS baglanti_adedi
FROM pg_stat_activity
WHERE backend_type = 'client backend'
GROUP BY 1, 2, 3, 4
ORDER BY baglanti_adedi DESC
LIMIT 15;Adım 3.3: Kilit Tutan ve Uzun Süredir Askıda Kalan Oturumlar
SELECT
pid,
usename,
application_name,
client_addr,
state,
now() - xact_start AS islem_suresi,
now() - state_change AS son_durum_suresi,
wait_event_type,
wait_event,
pg_blocking_pids(pid) AS bloke_eden_pidler,
left(query, 80) AS son_sorgu_ozeti
FROM pg_stat_activity
WHERE state IN ('idle in transaction', 'active')
AND (now() - xact_start) > interval '60 seconds'
ORDER BY islem_suresi DESC
LIMIT 10;▸4. Müdahale Seçenekleri ve Operatör Kararı
| Teşhis Bulgusu | Kök Neden | Yanlış / Riskli Tepki | Ölçüme Dayalı Güvenli Müdahale |
|---|---|---|---|
bosta_bekleyen yüksek | Mikroservis filosu her thread için kalıcı socket tutuyor | max_connections'ı rastgele 1000'e çekmek | İki katmanlı havuzlama (PgBouncer Transaction Modu) planlamak |
islemde_kilitli_bosta var | Kodda BEGIN sonrası açık kalan transaction / sızıntı | Sunucuyu plansız restart etmek | idle_in_transaction_session_timeout (örn. 60s) tanımlamak |
kilit_bekleyen_oturum yüksek | Bir DDL veya uzun UPDATE arkasında onlarca sorgu birikmiş | Rastgele tüm podları kapatmak | Kilit tutan kök oturumu (pg_blocking_pids) tespit edip hedefli iptal etmek |
aktif_sorgu tavan yapmış | Yavaş sorgular veya eksik indeks kaynaklı kuyruk | Yalnızca CPU/RAM artırmak | Yavaş sorguları EXPLAIN ile optimize etmek + istemci havuz sınırlarını kısmak |
▸5. Operatör Kontrolünde Güvenli Müdahale
1. Sınırları ve Rezerve Kapasiteyi Teyit Edin
SHOW max_connections;
SHOW superuser_reserved_connections;
SHOW reserved_connections; -- PostgreSQL 16+2. Kapatılmayan İşlemlere Sunucu Seviyesinde Zaman Aşımı Koyun
PostgreSQL'in askıda kalan oturumları otomatik olarak sonlandırmasını sağlayın (yeniden başlatma gerektirmez):
-- İşlem içinde 60 saniyeden uzun süre boşta bekleyen oturumları kes
ALTER SYSTEM SET idle_in_transaction_session_timeout = '60s';
-- Normal boşta bekleyen oturumları 10 dakika sonra kapat (PG 14+)
ALTER SYSTEM SET idle_session_timeout = '10min';
-- Ayarları yürürlüğe al
SELECT pg_reload_conf();3. Hedefli ve Bilinçli Oturum Sonlandırma (pg_terminate_backend)
Toplu ve rastgele pg_terminate_backend çalıştırmak uygulama katmanında anlık HTTP 500 dalgası, transaction rollback ve yeniden bağlanma fırtınası (thundering herd) yaratır.
pg_terminate_backend yalnızca diğer oturumları kilitleyen kök blocker PID tespit edildiğinde ve operatörün onayıyla tekil olarak çalıştırılmalıdır. Bir cron scriptine bağlanarak otomatik döngüye alınmamalıdır.-- Yalnızca diğer oturumları bloke eden kök oturumu hedefleyin
SELECT pg_terminate_backend(blocking_pid)
FROM (
SELECT unnest(pg_blocking_pids(pid)) AS blocking_pid
FROM pg_stat_activity
WHERE wait_event_type = 'Lock'
) sub
GROUP BY blocking_pid;4. Rol Bazlı Bağlantı Kotası Belirleyin
Bir arka plan analitik veya raporlama kullanıcısının tüm bağlantı kotasını tüketmesini önleyin:
ALTER ROLE raporlama_servisi CONNECTION LIMIT 5;▸6. `max_connections` Ne Zaman Artırılır, Ne Zaman Havuzlama Gerekir?
"max_connections asla artırılmaz" dogmatik bir yargıdır; doğru yaklaşım iş yükü profiline göre ödünleşimleri hesaplamaktır:
- 1Ne Zaman Artırılabilir?
- •Sunucuda yeterli bellek (RAM) ve CPU çekirdeği varsa,
- •Bağlantı açan istemciler seyrek fakat paralel analitik sorgular (örneğin Data Warehouse / BI) çalıştırıyorsa,
- •
work_memve bağlantı sayısı çarpımı toplam fiziksel RAM sınırları içinde kalıyorsamax_connectionsölçülü biçimde (örneğin 100'den 200'e) artırılabilir.
- 1Ne Zaman Havuzlama (PgBouncer) Zorunludur?
- •Yüzlerce Kubernetes podunun veya sunucusuz fonksiyonun (Lambda/Cloud Functions) kısa süreli OLTP sorguları çalıştırdığı durumlarda,
- •İşletim sistemi proses (
fork) maliyeti ve CPU context-switching süresi asıl sorgu süresini aştığında, - •Varsayımsal bellek modeli: Her backend süreci için katalog önbellekleri, soket tamponları ve varsayılan
work_memdahil yaklaşık 6–8 MB ayrıldığı kabul edilirse, 500 bağlantı tek başına 3–4 GB RAM bağlayarakshared_buffersve işletim sistemi sayfa önbelleğini daraltır. Bu profilde çözümmax_connectionsartırmak değil, bağlantıları ara katmanda çoğullamaktır.
▸7. Başarı Ölçütleri ve Doğrulama
Müdahalenin başarılı olduğunu şu kriterlerle doğrulayın:
- 1Güvenli Kapasite Payı:
pg_stat_activityüzerindeki toplam standart istemci sayısı, normal rol tavanının altında kalmalıdır. - 2İşlem Verimi vs. Bağlantı Oranı:
pg_stat_database.xact_commithızı düşmedenpg_stat_database.numbackendssayısının stabil kalması sağlanmalıdır.
▸8. Sonraki Adım ve Tamamlayıcı İçerikler (Triad)
PostgreSQL bağlantı kapasitesini kalıcı olarak çözmek için tamamlayıcı triad rehberlerini inceleyin:
- •📖 Derin Mimari & Yaşam Döngüsü (dbaguide): Bağlantı yaşam döngüsü, oturum durumları, kaynak maliyetleri ve doğrulanmış laboratuvar bulguları:
👉 PostgreSQL Bağlantı Yönetimi: Bağlantı Yaşam Döngüsü, Kapasite ve Havuzlama
- •🛠️ Araç ve Mimari Seçimi (dataxtools): İki katmanlı havuzlama, PgBouncer 1.21+ prepared statements gerçeği ve session vs. transaction modları:
👉 Uygulama Havuzu ile PgBouncer Hangi İhtiyacı Çözer?
- •📐 SRE Kapasite ve Ölçeklenme Bütçesi (dataopsphere): İki mimaride kapasite formülü, rolling deployment surge örtüşmesi ve nöbetçi eskalasyon kartı:
👉 Uygulama Ölçeklenirken Bağlantı Bütçesini Nasıl Koruruz?
▸Resmî Kaynaklar ve İnceleme Notu
- •PostgreSQL Documentation: Chapter 20. Server Configuration - Connections
- •PostgreSQL Documentation: System Information Functions and Monitoring
- •PgBouncer Official Documentation: Features & Configuration
- •Son İnceleme Tarihi: 29 Ekim 2026 | dataiotech Labs Kıdemli Veritabanı ve SRE Ekibi
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.
- İ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
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
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
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.
POSTGRESQL Hata Kütüphanesinden Diğer Başlıklar
Kriz anında başvurabileceğiniz diğer doğrulanmış teşhis rehberleri.
PostgreSQL password authentication failed Hatası: Neden ve Çözüm
psql password authentication failed hatasının dört nedeni: yanlış şifre, md5/SCRAM uyuşmazlığı, pg_hba.conf sırası ve yanlış cluster. Adım adım teşhis.
PostgreSQL connection refused: 8 Adımda Kesin Teşhis
Connection refused, timeout ve "no pg_hba.conf entry" arasındaki fark; listen_addresses, port, firewall ve Docker port yayınlama kontrolleri.
PostgreSQL duplicate key Hatası: Sequence Kayması Düzeltme
Restore veya toplu içe aktarma sonrası "duplicate key value violates unique constraint" hatasının nedeni, tek komutla düzeltme ve tüm sequence'ları tarayan DO bloğu.