dalibo/pg_activity

어떤 프로젝트인가요?

핵심 기능

• 01쿼리, 실행 시간, CPU 및 메모리 사용량, I/O 속도를 포함해 PostgreSQL 백엔드를 실시간으로 표시합니다.
• 02실행 중·대기 중·다른 쿼리를 차단하는 쿼리 보기 간에 전환합니다.
• 03인터페이스에서 바로 백엔드를 종료하거나 쿼리를 취소합니다.
• 04표시할 열을 설정하고 내장 디스플레이 프로필을 사용할 수 있습니다.
• 05데이터베이스 이름으로 필터링하고 실행 중인 쿼리를 CSV로 내보냅니다.

활용 사례

• 운영 PostgreSQL 서버에서 느린 쿼리나 잠금 경합을 진단합니다.
• SSH로 원격 데이터베이스 호스트에 접속해 연결 및 I/O 활동을 실시간으로 살펴봅니다.
• 장애 대응 중 다른 세션을 차단하는 세션을 파악합니다.

빠른 시작

1. 1

   psycopg를 사용해 PyPI에서 설치하기

   python3 -m pip install "pg_activity[psycopg]"
2. 2

   postgres 사용자로 로컬 서버에 연결해 실행하기

   sudo -u postgres pg_activity -U postgres

사용 전 알아둘 점

• !모든 데이터를 사용하려면 슈퍼유저 권한이 있는 PostgreSQL 사용자가 필요합니다. 그렇지 않으면 기능이 제한된 모드로 실행됩니다.

포함된 컬렉션

토픽

자주 묻는 질문

pg_activity은(는) 무엇인가요?

PostgreSQL 서버의 활동, 세션, 실행 중인 쿼리를 실시간으로 모니터링하는 top 스타일의 CLI 도구입니다. pg_activity는 top과 비슷한 터미널 인터페이스에서 PostgreSQL 서버의 현재 상태를 보여줍니다. 활성 백엔드와 각 백엔드의 쿼리, 실행 시간, CPU 및 메모리 사용량, 읽기·쓰기 속도를 표시하고, 실행 중·대기 중·다른 쿼리를 차단하는 쿼리 보기 간에 전환할 수 있습니다. 프로세스 테이블을 정렬하고, 새로고침을 일시 중지하고, 선택한 쿼리를 클립보드에 복사하며, 인터페이스에서 바로 백엔드를 종료하거나 쿼리를 취소할 수 있습니다.

pg_activity은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?

pg_activity은(는) PostgreSQL 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.

pg_activity은(는) 아직 유지보수되고 있나요?

6개월 이내 업데이트. pg_activity의 마지막 커밋은 2026년 9월 21일입니다.

pg_activity은(는) 어디에 사용할 수 있나요?

운영 PostgreSQL 서버에서 느린 쿼리나 잠금 경합을 진단합니다. SSH로 원격 데이터베이스 호스트에 접속해 연결 및 I/O 활동을 실시간으로 살펴봅니다. 장애 대응 중 다른 세션을 차단하는 세션을 파악합니다.

pg_activity는 어떻게 설치하나요?

psycopg를 사용해 PyPI에서 설치하기: python3 -m pip install "pg_activity[psycopg]" postgres 사용자로 로컬 서버에 연결해 실행하기: sudo -u postgres pg_activity -U postgres

pg_activity은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/dalibo/pg_activity