Pg-status
lastmod 2026-11-16created 2026-01-312 edits
pg-status는 PostgreSQL 호스트들의 상태(살아 있는지, 어느 쪽이 마스터이고 어느 쪽이 리플리카인지, 리플리카가 마스터보다 얼마나 뒤처졌는지)를 HTTP API 로 알려 주는 사이드카 서비스이다. 백그라운드에서 각 호스트를 주기적으로 폴링해 결과를 메모리에 두었다가 요청마다 바로 돌려주므로, 애플리케이션이 매 요청마다 물어봐도 부담이 적다. 애플리케이션 옆에 붙여 띄우거나, 여러 애플리케이션 인스턴스가 함께 쓰는 독립 서비스로 둘 수 있다.
About
- 설정은 환경 변수(
pg_status__hosts,pg_status__sleep_ms등)로 함. 호스트별 포트, 호스트마다의 DC·geo 위치, PostgreSQL TLS 연결 지정 가능 -
/master는 현재 마스터,/replica는 라운드로빈으로 고른 리플리카의 호스트 이름을 평문으로,Accept: application/json이면 JSON 으로 돌려줌. 조건에 맞는 리플리카가 없으면 마스터를 돌려줌 -
/sync_by_time,/sync_by_bytes,/most_sync_by_bytes는 시간·바이트 지연 기준으로 리플리카를 고름.lag_ms,lag_bytes쿼리 파라미터로 요청마다 기준을 바꿀 수 있음 -
min_lsn,timeline파라미터를 주면 방금 쓴 WAL 위치까지 재생한 리플리카만 골라 read-your-writes 일관성을 맞춤. 장애 조치 뒤 버려진 타임라인에 남은 리플리카는 제외함 - 위치 정보를 넣으면 같은 DC, 그다음 같은 geo 의 리플리카를 먼저 고름
- 단일 스레드가 libpq 비동기 API 로 모든 호스트를 동시에 폴링해 느린 호스트가 다른 호스트 갱신을 막지 않음. 연속 실패가
pg_status__max_fails에 이르러야 죽은 것으로 보고, 그 전에는possible_dead로 표시함. 기본값으로는 장애를 약 4초 안에 감지 -
/hosts,/status는 호스트별 역할·지연·LSN 을 JSON 으로,/live,/ready는 헬스 체크 결과를 돌려줌 - vCPU 1개에 고정한 벤치마크에서
/master기준 52,500 RPS, p99 4.17ms, 메모리 10 MiB RSS. 0.1 vCPU 할당에서도 혼합 부하 3,000 RPS - Debian 패키지, Docker 이미지, 정적·동적 링크 바이너리로 배포. Docker Compose 데모로 프록시를 바꿔 마스터 전환을 흉내 내 볼 수 있음
- MIT 라이선스