dataiotech Labs
dbaguide.com · Senior DBA & SRE Diagnostic Standard v2.0
Home/Hata Kütüphanesi/POSTGRESQL/postgresql-too-many-clients
PostgreSQL
PG 14 - 17SEVERITY: P1 HIGH
7 dk okuma
FATAL: sorry, too many clients already

PostgreSQL "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ü.

İnceleyen:Kıdemli Veritabanı Mimarı & SRE (dataiotech Labs)·29 Ekim 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

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)

Gerekli Yetki

SUPERUSER veya pg_read_all_stats / pg_signal_backend (standart kullanıcılar yalnızca kendi oturumlarını görebilir)

Risk & Etki Alanı
Mediumİşlemdeki oturumları pg_terminate_backend ile topluca sonlandırmak uygulama katmanında HTTP 500 ve rollback dalgası yaratır
Geri Alma (Rollback)

Geçici session timeout parametrelerini sıfırlama, PgBouncer reload veya uygulama havuz boyutunu eski haline alma

Beklenen Çıktı & Doğrulama Kriteri

pg_stat_activity sorgusunda bağlantı sayısının güvenli bütçe altına inmesi ve pg_stat_database.numbackends stabilitesi

Resmî Dokümantasyon Referansı

PostgreSQL Docs: Connections & Authentication

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.

İPUCU
Kavramları ve Mimariyi Öğrenin: Bağlantı yaşam döngüsü, oturum ve transaction sınırları, aktif/boşta kaynak maliyetleri, iki katmanlı havuzlama mimarisi ve kapasite bütçelemesi hakkında kapsamlı mimari rehberimiz için inceleyin: PostgreSQL Bağlantı Yönetimi: Bağlantı Yaşam Döngüsü, Kapasite ve Havuzlama.

▸1. Belirti ve Hata Kodlarının Ayrımı

NOT
Hata Türünü Doğrulayın: - Eğer hata mesajınız 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:

plaintext
-- 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 connections
ÖNEMLİ
Hata Mekanizması ve Rezerve Kapasite: PostgreSQL resmi bağlantı mimarisine göre max_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:

  1. 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ı.
  2. 2Kapatılmayan İşlemler (`state = 'idle in transaction'`): Uygulama kodunun BEGIN ile işlem başlatıp, harici bir HTTP servisini beklerken veya hata alıp COMMIT / ROLLBACK gö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.
  3. 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.

NOT
Yetki ve Görünürlük Sınırları: PostgreSQL güvenlik modeli gereği, 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)

sql
-- 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

sql
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

sql
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 BulgusuKök NedenYanlış / Riskli TepkiÖlçüme Dayalı Güvenli Müdahale
bosta_bekleyen yüksekMikroservis filosu her thread için kalıcı socket tutuyormax_connections'ı rastgele 1000'e çekmekİki katmanlı havuzlama (PgBouncer Transaction Modu) planlamak
islemde_kilitli_bosta varKodda BEGIN sonrası açık kalan transaction / sızıntıSunucuyu plansız restart etmekidle_in_transaction_session_timeout (örn. 60s) tanımlamak
kilit_bekleyen_oturum yüksekBir DDL veya uzun UPDATE arkasında onlarca sorgu birikmişRastgele tüm podları kapatmakKilit tutan kök oturumu (pg_blocking_pids) tespit edip hedefli iptal etmek
aktif_sorgu tavan yapmışYavaş sorgular veya eksik indeks kaynaklı kuyrukYalnızca CPU/RAM artırmakYavaş 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

sql
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):

sql
-- İş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.

DİKKAT / TEHLİKE
Operatör Kararı ve Kapsam Kuralı: 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.
sql
-- 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:

sql
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:

  1. 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_mem ve bağlantı sayısı çarpımı toplam fiziksel RAM sınırları içinde kalıyorsa max_connections ölçülü biçimde (örneğin 100'den 200'e) artırılabilir.
  1. 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_mem dahil yaklaşık 6–8 MB ayrıldığı kabul edilirse, 500 bağlantı tek başına 3–4 GB RAM bağlayarak shared_buffers ve işletim sistemi sayfa önbelleğini daraltır. Bu profilde çözüm max_connections artı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:

  1. 1Güvenli Kapasite Payı: pg_stat_activity üzerindeki toplam standart istemci sayısı, normal rol tavanının altında kalmalıdır.
  2. 2İşlem Verimi vs. Bağlantı Oranı: pg_stat_database.xact_commit hızı düşmeden pg_stat_database.numbackends sayı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

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
İlişkili Mühendislik Zincirleri

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 Bağlantı Tükenmesi ve too many clients Teşhisi · Kanıt Odaklı Teşhis Standardı
Son Güncelleme: 2 Kasım 2026 · Format v2.0