PgBouncer 연결 풀링 — PostgreSQL 성능 최적화

# Ubuntu / Debian
sudo apt install -y pgbouncer

# 상태 확인
sudo systemctl status pgbouncer

# /etc/pgbouncer/pgbouncer.ini

[databases]
; 데이터베이스 별칭 = 연결 정보
myapp = host=127.0.0.1 port=5432 dbname=myapp
; 원격 서버 연결
myapp_prod = host=db.example.com port=5432 dbname=myapp

[pgbouncer]
listen_addr    = 127.0.0.1       ; 리슨 주소 (외부 노출 시 0.0.0.0)
listen_port    = 6432            ; PgBouncer 포트
auth_type      = md5             ; 인증 방식
auth_file      = /etc/pgbouncer/userlist.txt

pool_mode      = transaction     ; 풀링 모드
max_client_conn = 1000           ; 최대 클라이언트 연결 수
default_pool_size = 25           ; DB당 연결 풀 크기
min_pool_size   = 5
reserve_pool_size = 5

; 로그
logfile        = /var/log/postgresql/pgbouncer.log
pidfile        = /var/run/postgresql/pgbouncer.pid

; 타임아웃
server_idle_timeout = 600
client_idle_timeout = 0
query_timeout       = 0

; 관리자
admin_users    = postgres
stats_users    = monitor

# userlist.txt 형식: "사용자명" "패스워드 해시"

# PostgreSQL에서 해시 추출
sudo -u postgres psql -c "SELECT usename, passwd FROM pg_shadow WHERE usename = 'appuser';"

# /etc/pgbouncer/userlist.txt
echo '"appuser" "md5해시값"' | sudo tee /etc/pgbouncer/userlist.txt
echo '"postgres" "md5해시값"' | sudo tee -a /etc/pgbouncer/userlist.txt

# 권한 설정
sudo chmod 640 /etc/pgbouncer/userlist.txt
sudo chown postgres:postgres /etc/pgbouncer/userlist.txt

# 재시작
sudo systemctl restart pgbouncer

# 기존 PostgreSQL 연결
postgresql://appuser:pass@localhost:5432/myapp

# PgBouncer 경유 연결 (포트만 변경)
postgresql://appuser:pass@localhost:6432/myapp

# PgBouncer 관리 콘솔 접속
psql -h 127.0.0.1 -p 6432 -U postgres pgbouncer

# 풀 상태
SHOW POOLS;
# database | user | cl_active | cl_waiting | sv_active | sv_idle

# 통계
SHOW STATS;

# 클라이언트 목록
SHOW CLIENTS;

# 서버(DB) 연결 목록
SHOW SERVERS;

# 설정 재로드 (pgbouncer.ini 변경 후)
RELOAD;

# 연결 종료 없이 설정 갱신
RELOAD;

; 웹 앱 (100 동시 접속, DB max_connections=100)
pool_mode         = transaction
max_client_conn   = 500
default_pool_size = 20     ; PgBouncer → PostgreSQL 연결 수
min_pool_size     = 5
reserve_pool_size = 5