iPhone용 HeapDeck: Postgres® Monitor

Postgres 어디에 불이 났는지 보고, 불을 끕니다.

Postgres 알림이 울렸는데 노트북은 집에 있다면? HeapDeck은 어떤 세션이 차단하고 있는지, wraparound까지 얼마나 남았는지 보여 주고, iPhone에서 바로 조치할 수 있게 해 줍니다. 인시던트는 휴대폰으로 막고, 원인은 자리로 돌아가서 고치십시오.

App Store에서 다운로드 하기
스캔해서 iPhone에서 열기

Free · Pro US$19.99 1회 구입 · PostgreSQL 13–19 · iOS 17 이상 · iPhone과 iPad

“심각” 판정을 받은 운영 서버의 HeapDeck “상태” 화면: 맨 위에 차단된 세션, 이어서 연결 수, 가장 오래 실행된 쿼리, wraparound, 복제

Postgres에서 누가 모두를 막고 있는지 확인합니다. 영향을 미리 보고 루트를 중지합니다.

“잠금” 화면은 pg_blocking_pids() 결과로 차단 트리를 만들고 차단 루트를 맨 위에 둡니다. 루트의 pid, user@app, 잠금을 잡고 있는 시간, 실행 중인 내용이 표시됩니다. 그 아래에는 대기열에 막혀 있는 모든 세션이 나옵니다.

  • 루트에 대한 버튼은 루트의 상태에 따라 바뀝니다. 구문을 실행 중이면 루트 취소, idle in transaction 상태이면 루트 종료입니다. 버튼에 표시되는 숫자는 루트 자체를 기다리는 세션 수이며, 확인 화면에 그 pid 목록이 표시됩니다. PRO
  • HeapDeck은 무엇이든 보내기 전에 잠금 체인을 다시 읽고, 숫자가 바뀌었으면 다시 확인을 요청합니다. 실행 후에는 실제로 측정한 결과, 즉 차단이 해제된 세션 수와 아직 대기 중인 세션 수를 알려 줍니다.
  • “취소”는 실행 중인 쿼리를 멈춥니다. “종료”는 루트의 pid를 입력한 뒤에 세션을 끝내고 트랜잭션을 롤백합니다. PRO
  • 대기 중인 각 세션에는 RowExclusiveLock on public.orders처럼 무엇을 기다리는지 표시됩니다. idle in transaction 상태로 버티는 루트는 따로 표시되고, 데드락은 데드락으로 표시됩니다.
“잠금” 화면: 06:48 동안 idle in transaction 상태인 차단 루트가 세션 4개를 막고 있고, 그 아래에 “루트 종료 (2개 차단 해제)” 버튼과 취소가 무시되는 이유가 있음

Postgres가 쓰기를 거부하기 전에 wraparound 진행률을 파악합니다.

“Vacuum 및 비대화” 화면은 서버가 트랜잭션 ID wraparound에 얼마나 가까운지 2³¹ 대비 비율로 보여 주고, relfrozenxid 나이 기준으로 가장 오래된 테이블을 함께 보여 줍니다. 한계에 도달하면 PostgreSQL은 database is not accepting commands to avoid wraparound data loss 오류를 내며 쓰기를 거부합니다.

  • 75%부터는 화면이 이를 분명하게 알리고, autovacuum이 따라잡지 못하는 흔한 원인을 보여 줍니다: 오래 실행 중인 열린 트랜잭션, 비활성 복제 슬롯, 멈춘 워커.
  • 테이블별 데드 튜플과 그 비율, 마지막으로 vacuum된 시점.
  • 사용되지 않는 인덱스와 그 인덱스가 차지하는 공간. HeapDeck은 DROP INDEX CONCURRENTLY를 복사해 줄 뿐, 직접 실행하지 않습니다.
  • 목록의 테이블에 VACUUM (ANALYZE) 또는 ANALYZE를 실행할 수 있습니다. VACUUM FULL은 먼저 테이블 이름을 입력해야 합니다. PRO
“Vacuum 및 비대화” 화면: 트랜잭션 ID wraparound 86%, 100%에 도달하면 데이터베이스가 쓰기를 받지 않는다는 경고, 가능성 높은 원인 세 가지

배스천을 거쳐 Postgres에 연결합니다. 롤에 이미 있는 권한만으로.

HeapDeck은 iPhone에서 서버로 직접, 또는 SSH 배스천을 거쳐 연결합니다. 중간에 HeapDeck 서버가 없고 계정도 없습니다. AI 어시스턴트를 설정했다면 어시스턴트는 내가 선택한 제공업체와만, 내 키로 통신합니다.

  • 비밀번호, Ed25519·ECDSA·RSA 키와 키 암호, 또는 Secure Enclave 키를 쓰는 SSH. 최대 3개의 호스트를 거칠 수 있습니다. 각 호스트 키는 첫 연결 때 고정됩니다.
  • TLS는 기본적으로 sslmode=require입니다. 인증서의 SHA-256 지문을 고정하며, 인증서가 바뀌면 결정할 때까지 연결을 멈춥니다.
  • 비밀번호, 키, 지문은 이 iPhone의 Keychain에 보관되며 동기화되지 않습니다. 앱은 Face ID로 엽니다.
  • 슈퍼유저가 아니라면? HeapDeck은 빈 화면 대신 필요한 GRANT pg_monitor를 정확히 보여 줍니다.
첫 연결 때 나오는 “이 서버 확인” 시트: 신뢰하기 전에 가지고 있는 기록과 대조할 서버 인증서의 SHA-256 지문

iPhone에서 해결할 수 있는 Postgres 문제

각 카드는 문제가 생겼을 때 보이는 증상에서 시작해, SQL과 임계값, 열어야 할 화면을 담은 가이드로 이어집니다. 가이드는 영어로 되어 있습니다.

이 모든 내용은 서버 한 대까지 무료로 볼 수 있습니다. 세션 종료, VACUUM, 슬롯 삭제에는 Pro가 필요합니다. US$19.99에 한 번만 구매하면 됩니다.

모든 사용 사례

Postgres 인시던트 때 여는 화면

첫 화면에는 상태 타일 10개가 있고 타일마다 네이티브 화면이 연결되어 있어, 휴대폰 키보드로 psql을 입력할 일이 없습니다. 필요할 때는 SQL 콘솔도 있으며, 모든 구문을 실행 전에 검사합니다.

  • 상태

    타일 10개: max_connections 대비 세션 수, 차단된 세션, 가장 오래 실행된 쿼리, TPS, 캐시 적중, autovacuum, wraparound, 복제, 데이터베이스 크기, 느린 쿼리. “경고” 또는 “심각” 판정에는 그 원인이 된 타일이 표시됩니다. 화면이 열려 있는 동안 10초마다 새로 고칩니다.

  • 활동

    pg_stat_activity의 모든 세션을 대기 중인 것부터 보여 줍니다. 활성, idle in transaction, 10초 초과, 대기 중으로 필터링할 수 있습니다. 행을 스와이프하면 취소하거나 종료할 수 있습니다.

  • 복제와 슬롯

    스탠바이별 재생 지연을 WAL 단계별로 나눠 보여 줍니다. 모든 슬롯이 보존 중인 WAL을 표시하고, 비활성 슬롯이 디스크를 채우고 있으면 경고합니다.

  • 느린 쿼리

    pg_stat_statements에서 가장 무거운 구문 300개를 총 시간, 평균, 호출 수, 행 수로 정렬해 보여 줍니다. 구문 상세에는 롤, 데이터베이스, 실행 시간 통계, I/O, 그리고 지금 그 구문을 실행 중인 세션이 표시됩니다(PostgreSQL 14 이상).

  • 데이터와 SQL 콘솔

    테이블을 둘러보고, 서버에서 필터링하고, 외래 키를 따라가고, 페이지를 CSV나 JSON으로 내보낼 수 있습니다. 콘솔은 입력하는 동안 각 구문을 분류하며, Free에서는 읽기를 BEGIN READ ONLY 안에서 실행합니다.

  • AI 어시스턴트 PRO

    인시던트나 잠금 체인을 설명하고 수정안을 작성합니다. 내 API 키나 내 Ollama를 사용합니다. 어시스턴트는 마스킹된 스냅샷을 받으며, 스스로 아무것도 실행하지 않습니다.

HeapDeck에 내장된 데모입니다. iOS처럼 다크와 라이트 모드로 보여 줍니다.

“차단 중인 세션의 쿼리 취소” 시트: pid 24310은 01:12 동안 실행 중인 ALTER TABLE 마이그레이션, “대기 중인 세션 2개의 차단이 해제될 것입니다.”

루트 취소 확정하기 전에 차단이 풀릴 세션을 확인.

“Vacuum 및 비대화” 화면: 테이블별 데드 튜플과 스캔이 없는 인덱스 6개(합계 34 GB)

Vacuum 및 비대화 데드 튜플과 사용되지 않는 인덱스, 그리고 차지하는 공간.

“활동” 화면: 세션별 상태, 대기 시간, SQL이 표시된 목록. 차단 중인 세션에는 “세션 4개 차단 중” 표시

활동 대기 중인 세션이 먼저.

“복제” 화면: 재생 지연이 있는 스탠바이 2개와 “비활성 슬롯 때문에 PostgreSQL은 WAL을 영구히 보관합니다”라는 경고

복제 스탠바이별 지연과 WAL을 붙잡고 있는 슬롯.

“느린 쿼리” 화면: 총 시간순으로 정렬된 구문과 호출 수, 평균 시간, 행 수

느린 쿼리 pg_stat_statements 기반.

pg_monitor 권한이 없는 롤의 “활동” 화면: “세션은 보이지만 SQL은 볼 수 없습니다” 안내와 “방법 보기” 버튼

제한된 접근 pg_monitor가 없다면? 무엇이 가려졌고 어떻게 고치는지 알려 줍니다.

SQL 콘솔: DELETE FROM public.orders가 “파괴적”으로 분류됨, WHERE 절 없음, 예상 행 수 1,810만

SQL 분류기 WHERE 없는 DELETE에 대한 판정.

어시스턴트 답변: 유휴 트랜잭션이 orders의 행 잠금을 쥐고 있고 세션 7개가 대기 중이며, 다음 단계 제안이 함께 표시됨

AI 어시스턴트 잠금 체인을 설명합니다.

“모델이 보는 것”: 모델로 보내는 스냅샷, 이름은 table_1 같은 플레이스홀더로 바뀌어 있음

모델이 보는 것 보내기 전에 정확한 텍스트를 확인.

“데이터” 탭: 그리드로 표시된 orders 테이블, 행 18,412,004개 중 200개 표시

데이터 200행 단위 페이지, 서버에서 필터링.

루트 취소 확정하기 전에 차단이 풀릴 세션을 확인.

Postgres 모니터링은 무료입니다. Pro는 한 번만 구입합니다.

먼저 내 운영 환경에서 사용해 보십시오. 모니터링 화면은 서버 1대까지 모두 무료입니다. Pro는 US$19.99 1회 구입으로 나머지 서버와 모든 조치 기능을 잠금 해제합니다. 구독도 계정도 없습니다.

Free

영구 무료

운영 서버 1대에 연결해 모든 것을 볼 수 있습니다.

  • 모든 모니터링 화면: 상태, 활동, 잠금, Vacuum 및 비대화, 복제, 스토리지, 느린 쿼리
  • TLS, SSH 터널, 지문 고정, Face ID를 갖춘 저장된 연결 1개
  • 서버 측 필터, 외래 키, CSV·JSON 내보내기를 지원하는 데이터 브라우저
  • 읽기용 SQL 콘솔(읽기 전용 트랜잭션 안에서 실행)
  • SQL 분류기와 그 설명

Pro

US$19.99

1회 구입

조치가 필요한 순간을 위해.

  • 저장된 연결 무제한: 당직으로 맡은 모든 서버
  • 세션 취소와 종료, 잠금 체인의 루트 중지
  • VACUUM, ANALYZE, 복제 슬롯 삭제
  • 콘솔에서 쓰기와 DDL(확인 절차 포함)
  • 기본 키가 있는 테이블에서 행 삽입, 편집, 삭제
  • 내 키 또는 내 모델로 쓰는 AI 어시스턴트

Pro 작업은 Free에서도 PRO 표시와 함께 보이므로 무엇을 하는지 확인할 수 있습니다. 어시스턴트는 내장 데모 인시던트에서는 무료로 작동합니다. 미국 외 지역에서는 App Store가 현지 통화로 가격을 표시합니다.

Free · Pro US$19.99 1회 구입 · PostgreSQL 13–19 · iOS 17 이상 · iPhone과 iPad

HeapDeck과 Postgres에 대해 자주 묻는 질문

Neon, Supabase, Amazon RDS, Cloud SQL, Azure에서도 작동합니까?

HeapDeck은 iPhone에서 접근할 수 있는 PostgreSQL 13–19 서버라면 자체 호스팅이든 관리형이든, 프라이머리든 스탠바이든 작동합니다. 롤이 슈퍼유저가 아니면 화면에 무엇이 가려졌는지와 이를 해결하는 GRANT pg_monitor를 보여 줍니다.

Neon, Supabase, Amazon RDS는 실제 연결로 확인되었습니다. Neon 또는 Supabase의 Connect 패널에서 연결 문자열을 복사해 붙여 넣으십시오. RDS는 RDS 콘솔에 표시된 인스턴스 엔드포인트를 입력하십시오. Neon은 직접 연결하거나 -pooler 호스트를 통해 연결할 수 있습니다. Supabase의 직접 연결 호스트에는 IPv6 주소만 있습니다. IPv6가 없는 네트워크에서는 HeapDeck이 이를 알려 주고 Session pooler 연결 문자열을 안내합니다.

인증서가 iOS가 신뢰하는 루트로 이어지면(Neon처럼) verify-full을 사용할 수 있습니다. Amazon RDS는 iOS에 포함되지 않은 자체 루트 CA로 서명합니다. RDS와 같은 제공업체에는 sslmode=require를 사용하십시오. 연결은 암호화되며, HeapDeck은 첫 연결 때 인증서 지문을 고정합니다.

배스천 뒤에 있는 데이터베이스에도 접속할 수 있습니까?

네. 연결에서 SSH 터널을 켜고 배스천의 호스트, 사용자, 비밀번호 또는 키를 입력하십시오. HeapDeck은 OpenSSH, PEM, PKCS#8 또는 PuTTY 형식의 Ed25519, ECDSA, RSA 키를 키 암호 유무와 관계없이 읽으며, iPhone 밖으로 나가지 않는 Secure Enclave 키를 만들 수도 있습니다.

여러 단계를 거쳐야 한다면 점프 호스트를 최대 2개까지 추가하고, 각각 별도의 로그인 정보를 설정할 수 있습니다. HeapDeck은 2단계 인증 요청에 응답하며, 각 호스트 키를 첫 연결 때 고정합니다. 클라이언트 인증서(mTLS)는 지원하지 않습니다.

자격 증명이나 데이터가 iPhone 밖으로 나갑니까?

HeapDeck은 서버에 직접, 또는 SSH 배스천을 거쳐 연결하며, 그 사이에 저희 서버는 없습니다. 계정도 필요 없습니다. 비밀번호, SSH 키, 고정된 지문은 이 기기의 iOS Keychain에 보관되며 iCloud와 동기화되지 않습니다.

휴대폰 밖으로 나갈 수 있는 것은 두 가지이며, 둘 다 사용자가 제어합니다. 설정한 AI 제공업체에 보내는 질문(Pro), 그리고 첫 실행 때나 설정에서 끌 수 있는 충돌 보고서와 사용 횟수 집계입니다. 어느 쪽에도 SQL, 테이블 이름, 호스트 이름, 값, 자격 증명은 들어 있지 않습니다. 자세한 내용은 개인정보 처리방침에 있습니다.

슈퍼유저 권한이 필요합니까?

아니요. 모니터링 화면에는 pg_monitor를 가진 롤이면 충분합니다: GRANT pg_monitor TO your_role;. 이 권한이 없어도 HeapDeck은 작동하며, 서버가 롤에게 숨기는 항목을 표시합니다. 다른 롤의 세션을 취소하려면 pg_signal_backend 같은 일반적인 PostgreSQL 권한이 필요합니다. 이 권한이 없으면 HeapDeck이 DBA에게 전달할 명령을 보여 줍니다.

취소와 종료, 어느 쪽을 써야 합니까?

취소(pg_cancel_backend)는 세션이 실행 중인 쿼리를 멈추며, 세션과 트랜잭션은 열린 채로 남습니다. 종료(pg_terminate_backend)는 세션 전체를 끊고 트랜잭션을 롤백합니다.

idle in transaction 상태인 세션에는 실행 중인 쿼리가 없으므로 취소해도 아무 일도 일어나지 않습니다. 잠금을 풀어 주는 것은 종료입니다. HeapDeck은 잠금 체인의 루트나 “운영” 연결의 세션을 종료하기 전에 pid를 입력하게 합니다.

HeapDeck이 데이터베이스를 망가뜨릴 수 있습니까?

Free에서는 쓰기가 전혀 일어나지 않습니다. 콘솔의 읽기는 BEGIN READ ONLY … ROLLBACK 안에서 실행됩니다. Pro에서는 모든 쓰기가 네 가지 검사를 차례로 거칩니다: Pro, 연결의 “읽기 전용” 스위치, SQL 분류기, 그리고 사용자의 확인.

VACUUM FULL, 슬롯 삭제, 잠금 루트 종료는 먼저 테이블 이름, 슬롯 이름 또는 pid를 입력해야 합니다. “운영”으로 표시한 연결에는 PROD 배지가 붙고 확인 절차가 더 엄격해집니다.

그냥 SSH로 접속해서 psql을 쓰면 되지 않습니까?

물론 그렇게 해도 됩니다. HeapDeck은 인시던트 때 확인할 질문마다 전용 화면이 있어 휴대폰 키보드로 쿼리를 입력하지 않아도 됩니다: 누가 차단하고 있고 몇 개가 기다리는지, 루트가 무엇을 실행 중인지, wraparound까지 얼마나 남았는지, 어느 슬롯이 WAL을 붙잡고 있는지. 조치하기 전에는 잠금 체인을 다시 읽고 확인을 요청합니다.

AI 어시스턴트는 무엇을 봅니까?

질문한 화면의 마스킹된 스냅샷입니다. 호스트, 포트, 비밀번호, 키는 들어가지 않으며, 값은 $1 같은 플레이스홀더로 바뀝니다. 클라우드 모델에서는 데이터베이스, 테이블, 열 이름이 기본적으로 숨겨지고, 답변이 도착하면 휴대폰에서 원래대로 되돌립니다.

요청은 iPhone에서 내 키로 선택한 제공업체(Anthropic, OpenAI, OpenRouter, Z.ai)로, 또는 내 Ollama나 OpenAI 호환 서버로 갑니다. “모델이 보는 것”에서 보내기 전에 정확한 텍스트를 확인할 수 있습니다. 어시스턴트는 Pro 기능이며 스스로 SQL을 실행하지 않습니다.

구독제입니까?

아니요. 서버 1대의 모니터링은 무료이고, 서버 무제한과 모든 조치 기능이 포함된 Pro는 Apple ID에 연결되는 US$19.99 1회 구입입니다. 계정도 체험 기간 제한도 없습니다.

문제가 생기면 알림을 보내 줍니까?

아니요. HeapDeck은 열려 있는 동안 작동하며 백그라운드 모니터링은 하지 않습니다. 기존 알림 체계는 그대로 두십시오. HeapDeck은 호출을 받은 뒤에 여는 화면입니다.

iPad에서도 실행됩니까?

네. iPad에서 HeapDeck은 모든 방향에서 전체 화면으로 실행되며, 탭 막대 대신 사이드바를 사용합니다. “잠금” 화면은 선택한 세션 옆에 잠금 트리를 보여 주고, SQL 콘솔은 화면 너비 전체를 사용합니다. Pro는 Apple ID를 따르므로 한 번 구입하면 iPhone과 iPad에서 모두 사용할 수 있습니다.

Amazon Web Services, AWS, Amazon RDS는 Amazon.com, Inc. 또는 그 계열사의 상표입니다. Neon, Supabase, Google Cloud SQL, Microsoft Azure는 각 소유자의 상표입니다. HeapDeck은 이들 중 어느 곳과도 제휴 관계가 없으며 승인을 받지 않았습니다.

Postgres 인시던트 가이드

한밤중에 호출되는 문제를 하나씩 한 페이지에 정리했습니다. 직접 확인하는 SQL과 HeapDeck에서 보이는 화면을 담았습니다. 가이드는 영어로 되어 있습니다.

블로그에서

모든 글

다음 Postgres 인시던트 전에 iPhone에 설치해 두십시오.

서버를 추가하고 인증서를 고정하면 모든 모니터링 화면을 무료로 쓸 수 있습니다. Pro는 조치가 필요한 밤을 위해 있습니다.

App Store에서 다운로드 하기
스캔해서 iPhone에서 열기

Free · Pro US$19.99 1회 구입 · PostgreSQL 13–19 · iOS 17 이상 · iPhone과 iPad