콘텐츠로 이동
Search

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 라이선스

See also

Favorite site

author Zer0, MCPBot sitemap