dmosk / pgtune

PostgreSQL 설정 튜너

서버에 맞는 postgresql.conf 스니펫을 생성합니다. 버전, OS, 워크로드, RAM, CPU, 연결 수, 스토리지를 지정하면 값마다 설명이 붙고, 모든 계산은 브라우저에서 이루어집니다.

하드웨어와 워크로드

pgtune를 쓰는 이유

  • 하드웨어에 맞는 설정. RAM, CPU, 스토리지, 워크로드를 입력하면 shared_buffers, work_mem, WAL, 병렬 처리 설정을 얻습니다.
  • PostgreSQL 14–19. 선택한 버전에 따라 파라미터가 달라집니다(18 이상의 io_method, wal_compression, vacuum 옵션 등).
  • 설명과 경고. 각 파라미터에 짧은 이유가 붙고, OOM 위험, huge pages, LZ4, io_uring, 재시작이 필요한 설정을 표시합니다.
  • 5가지 워크로드와 스토리지 유형. Web, OLTP, 데이터 웨어하우스, 데스크톱, 혼합; SSD, HDD, SAN, NVMe.
  • 브라우저에서만 동작. 서버도 API도 없어 파라미터가 기기 밖으로 나가지 않습니다. 무료, 23개 언어, 공유 링크 제공.

PostgreSQL 튜닝 방법

  1. PostgreSQL 버전, 운영체제, 워크로드 유형을 선택합니다.
  2. 전체 RAM과 단위를 입력하고, 알고 있다면 CPU 코어 수와 최대 연결 수도 입력합니다.
  3. 스토리지 유형과 데이터가 RAM보다 작은지, 비슷한지, 큰지를 선택합니다.
  4. “생성”을 누르고 설명과 경고를 읽은 뒤 스니펫을 postgresql.conf에 복사합니다.

생성된 설정에 대해

결과는 메모리, WAL, 플래너, 병렬 처리에 대한 널리 알려진 경험칙에 기반한 출발점입니다. 직접 가진 데이터로 하는 부하 테스트와 모니터링을 대신하지 않습니다.

팁:

  • 재시작이 필요한 설정은 별도 배지로 표시됩니다.
  • work_mem은 연결이 아니라 작업 단위로 적용되며, 복잡한 쿼리는 여러 번 사용할 수 있습니다.
  • 클라이언트가 많다면 max_connections를 올리기보다 PgBouncer 같은 풀러를 쓰세요.
  • Linux에서 shared_buffers가 2GB 이상이면 huge pages를 켜세요.
  • 변경 후 EXPLAIN (ANALYZE, BUFFERS)와 pg_stat_statements로 확인하고, 파라미터는 그룹 단위로 바꾸며 이전 설정을 보관하세요.

활용 사례

  • 새 PostgreSQL 서버의 합리적인 초기 설정 얻기;
  • RAM·CPU 증설이나 메이저 버전 업그레이드 후 다시 계산하기;
  • 같은 하드웨어에서 프로필(web, OLTP, 분석) 비교하기;
  • 리뷰나 런북에서 파라미터 선택 근거 설명하기.

자주 묻는 질문

pgtune이 입력값을 서버로 보내나요?

아니요. 모든 계산은 브라우저에서 이루어지며 API가 없습니다.

어떤 PostgreSQL 버전을 지원하나요?

14부터 19까지입니다. 파라미터 구성과 값은 선택한 버전에 따라 달라집니다.

결과를 그대로 운영에 적용해도 되나요?

출발점으로 보세요. 경고를 확인하고, 테스트 인스턴스에 적용한 뒤 실제 부하에서 지표를 살펴보세요.

큰 데이터베이스인데도 max_connections가 낮은 이유는?

연결마다 메모리를 쓰고 work_mem이 그 사이에서 나뉘기 때문입니다. 수천 개의 직접 연결보다 PgBouncer 같은 풀러가 보통 낫습니다.

CPU나 연결 수를 모르면 어떻게 하나요?

비워 두세요. 프로필과 RAM에 맞춰 값이 선택되고 결과에 가정한 연결 수가 표시됩니다.