dataiotech Labs
dbaguide.com · Senior DBA & SRE Diagnostic Standard v2.0
Home/Hata Kütüphanesi/POSTGRESQL/postgresql-terminating-connection-administrator-command
PostgreSQL
PostgreSQL 14–18SEVERITY: P2 MEDIUM
8 dk okuma
FATAL: terminating connection due to administrator command (57P01)

PostgreSQL "terminating connection due to administrator command" — Bağlantıyı Kim Kesti?

57P01 hatasının gerçek kaynakları: pg_terminate_backend, sunucu yeniden başlatma, bulut failover'ı ve pooler. Hangi log satırının hangi olayı gösterdiği.

İnceleyen:Principal Database Reliability Architect·30 Ekim 2026

Teshis & Ayırt Etme Protokolü (Disambiguation)

Ne Zaman Görülür?

PostgreSQL 14–18 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 18.6 & 17.11 (Alpine Linux / Docker 29.7) | Tarihsel: PostgreSQL 14.10, 15.6, 16.4

Gerekli Yetki

SUPERUSER veya pg_read_all_stats / pg_signal_backend (log_disconnections için ALTER SYSTEM)

Risk & Etki Alanı
MediumKörlemesine yapılan retry istekleri idempotent olmayan transactionlarda mükerrer işleme yol açabilir
Geri Alma (Rollback)

log_disconnections ayarını geri alma ve PgBouncer server_idle_timeout yapılandırmasını normalize etme

Beklenen Çıktı & Doğrulama Kriteri

Log satırlarında PID termination sebebi ve disconnect süresinin net tespiti; 57P01 vs 57P02/57P05 ayrımı

Resmî Dokümantasyon Referansı

PostgreSQL Docs: Error Codes & Session Signals

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

plaintext
FATAL: terminating connection due to administrator command

Uygulama tarafında (Node.js pg, Go pgx, Python psycopg2, JDBC) genellikle şu hata fırlatılır:

plaintext
server closed the connection unexpectedly This probably means the server terminated abnormally before or while processing the request.

SQLSTATE hata kodu: 57P01 (admin_shutdown).

ÖNEMLİ
Kritik Yanılgı: "Administrator Command" Bir DBA Komutu Değildir! Mesajdaki *"administrator command"* ifadesi neredeyse her zaman yanlış okunur. Bir veritabanı yöneticisinin elle pg_terminate_backend() çalıştırdığı anlamına gelmez. PostgreSQL bu metni, bir backend sürecine işletim sistemi düzeyinde bir SIGTERM (signal 15) ulaştığında yazar. Sinyali kimin veya hangi servisin gönderdiği hata metninde yer almaz — bu yüzden teşhis, hata mesajını değil PostgreSQL engine log'unun komşu satırlarını okumakla başlar.

▸1. Önce Hangi Olay Olduğunu Ayırın

Aynı 57 sınıfı altındaki dört farklı mesaj, dört tamamen farklı olayı temsil eder. Bunları birbirine karıştırmak en sık yapılan teşhis hatasıdır:

Log MetniGerçekte Ne Oldu?SQLSTATE
terminating connection due to administrator commandSürece SIGTERM geldi: pg_terminate_backend, pg_ctl stop/restart, systemd servis yöneticisi, bulut failover'ı57P01
terminating connection because of crash of another server processBaşka bir backend çöktü (Segmentation Fault vb.), postmaster paylaşımlı belleği korumak için tüm süreçleri anında düşürdü57P02
terminating connection due to idle-session timeoutidle_session_timeout aşıldı (PostgreSQL 14+)57P05
terminating connection due to idle-in-transaction timeoutİşlem içinde açık bekleyen oturum sınırı (idle_in_transaction_session_timeout) aşıldı25P03

Eğer 57P01 görüyorsanız, neden bir süre aşımı (timeout) değildir: birinin veya bir dış orkestratörün o oturuma açıkça son verdiği kesindir. Soru artık "neden koptu" değil, "bağlantıyı kim sonlandırdı" sorusudur.


▸2. Adım Adım Teşhis Akışı

Adım 1: Log'da Eşleşen Kapanış Satırını ve Son Sorguyu Bulun

PostgreSQL, bir backend SIGTERM aldığında olayı ayrıntılandırır:

plaintext
LOG: server process (PID 48213) was terminated by signal 15: Terminated DETAIL: Failed process was running: SELECT * FROM rapor_aylik WHERE ay = '2026-09'

DETAIL satırı altın değerindedir: kopan oturumun çalıştırmakta olduğu son SQL ifadesini verir. Uzun süren bir analitik sorgu görüyorsanız, bir izleme aracı (watchdog), PgBouncer havuz zaman aşımı veya cron scripti bu sorguyu kasten öldürmüş olabilir.

Adım 2: Tüm Oturumlar Aynı Anda mı Düştü, Birkaçı mı?

Canlı sunucuda oturum başlangıç sürelerini inceleyin:

sql
SELECT count(*) FILTER (WHERE state = 'active') AS aktif, count(*) FILTER (WHERE state = 'idle') AS bos, min(backend_start) AS en_eski, max(backend_start) AS en_yeni FROM pg_stat_activity WHERE backend_type = 'client backend';
  • •Tüm oturumlar aynı anda düştüyse: Sunucu yeniden başlatılmıştır (restart/crash-recovery). PostgreSQL logunda received fast shutdown request veya database system is shut down satırlarını arayın.
  • •Sadece birkaç oturum düştüyse: Sunucu ayaktadır ve SIGTERM hedefe yönelik olarak gönderilmiştir.

Adım 3: Sunucu Ayaktaysa Bağlantı Kesilmelerini Görünür Kılın

PostgreSQL, pg_terminate_backend çağrısını varsayılan olarak loglamaz. Gelecek olaylarda çağıranı ve süreyi yakalamak için şu ayarı açın:

sql
ALTER SYSTEM SET log_disconnections = on; SELECT pg_reload_conf();

Bu ayar, her oturum sonlandığında oturumun süresini, istemci IP'sini ve oturum kapatma nedenini log dosyasına kaydeder.

Adım 4: En Sık Üç Kaynağı Sırayla Eleyin

  1. 1Yönetimli Bulut Servisleri (AWS RDS / Aurora / GCP Cloud SQL / Azure Database): Sağlayıcının otomatik minor versiyon güncellemesi, depolama alanı genişletme failover'ı veya Multi-AZ bakım geçişi tam olarak bu 57P01 mesajını üretir. Sağlayıcınızın konsolundaki Olay Geçmişini (Event Log) mutlaka kontrol edin.
  2. 2Bağlantı Havuzlayıcılar (PgBouncer / Odyssey): PgBouncer gibi bir katman arka uç bağlantılarını kendi politikasıyla döndürür. Havuzun server_idle_timeout değeri sunucunun bekleme süresinden kısaysa, havuz "sağlıklı" sandığı ölü bir bağlantıyı uygulamaya teslim eder ve hata uygulama tarafında patlar.
  3. 3Otomatik İzleme ve Uzun Sorgu Öldürücüler: Uygulama bağlantı dizgilerine mutlaka application_name ekleyin:

postgresql://user:pass@host:5432/db?application_name=siparis_api_v2 Bu sayede pg_stat_activity üzerinden kimin kimi sonlandırdığı netleşir.


▸3. Çözüm ve Dayanıklılık Standartları

1. Uygulama Katmanında Doğru Retry Sınıflandırması

57P01 geçici bir bağlantı kopmasıdır; ancak körlemesine retry yapmak tehlikelidir:

plaintext
57P01, 57P02, 08006 → Bağlantı koptu: Yalnızca IDEMPOTENT sorgularda (SELECT vb.) yeni bağlantıyla yeniden dene. 57P03 → Sunucu başlatılıyor (startup): Üstel geri çekilme (exponential backoff) ile bekle. 25P03, 57P05 → Politika zaman aşımı: Retry yapma; işlem mantığını optimize et.
UYARI
Bir INSERT veya UPDATE işlemi sırasında bağlantı 57P01 ile koptuğunda, işlemin sunucuda COMMIT edilip edilmediği istemci tarafından bilinemez. İstemci tarafında tekil bir işlem kimliği (Idempotency Key) yoksa retry mükerrer fatura/sipariş oluşturabilir!

2. Bağlantı Havuzunda "Ölü Bağlantı" Doğrulaması

Havuzdan ödünç alınan (borrow) bağlantının ayakta olup olmadığını kontrol edin:

sql
SELECT 1;

HikariCP veya PgBouncer kullanıyorsanız, maxLifetime değerini güvenlik duvarının ve PostgreSQL'in boşta kalma eşiklerinden en az 30 saniye daha kısa ayarlayın. Altın kural: Bağlantıyı sunucu veya güvenlik duvarı değil, her zaman havuzlayıcı emekliye ayırmalıdır.


▸İlgili Hata Rehberleri & Hub Bağlantıları

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 "terminating connection due to administrator command" Çözümü · Kanıt Odaklı Teşhis Standardı
Son Güncelleme: 2 Kasım 2026 · Format v2.0