pgrundev/pgbot

해결하는 문제

pgbot은 모니터링 에이전트, 시계열 데이터베이스 또는 외부 서비스의 배포 없이도 데이터베이스 상태를 즉시 확인할 수 있는 PostgreSQL용 시점 진단 도구입니다. 전체 모니터링 플랫폼의 오버헤드 없이 데이터베이스 성능 문제를 빠르게 분류하고, 사용되지 않는 인덱스를 식별하며, 쿼리 성능 저하나 테이블 블로트(bloat)를 감지하는 문제를 해결합니다.

작동 방식

pgbot은 pg_monitor 권한을 가진 읽기 전용 역할(role)을 사용하여 PostgreSQL 인스턴스에 연결되는 단일 정적 바이너리입니다. 데이터베이스 자체의 내부 통계 뷰를 읽어 상태 점수와 분석 결과를 계산합니다. 시간에 따른 변화를 추적하기 위해 사용자 기기에 로컬 베이스라인 저장소를 유지하여 이전 실행 이후 무엇이 변경되었는지 보고할 수 있습니다. 핵심 분석 결과는 결정론적이며 Go로 계산되지만, 이러한 결과를 일반 언어로 설명할 수 있는 선택적 AI 레이어(OpenAI 또는 Gemini를 통해)를 제공합니다.

대상 사용자

로컬 인스턴스, AWS RDS와 같은 관리형 제공업체 또는 소유하지 않은 데이터베이스 등, PostgreSQL 데이터베이스의 상태를 빠르게 읽기 전용으로 검사해야 하는 데이터베이스 관리자, 개발자 및 AI 에이전트를 위해 설계되었습니다.

주요 특징

• Zero-Deployment: 수집기(collector)나 외부 서비스가 필요 없는 단일 정적 바이너리입니다.
• Read-Only Guarantee: 안전을 위해 전용 pg_monitor 역할과 세션 수준의 읽기 전용 고정(pinning)을 사용합니다.
• Baseline Tracking: 이전 실행을 기억하여 성능 저하 및 데이터베이스 동작의 변화를 식별합니다.
• AI-Powered Analysis: 결정론적 분석 결과에 대해 일반 언어로 해석을 제공하는 선택적 ask 및 explain 명령어를 제공합니다.
• Agent-Ready: AI 에이전트에게 분석 결과를 노출하기 위해 버전 관리된 JSON 계약과 Model Context Protocol (MCP) 서버를 제공합니다.
• Comprehensive Diagnostics: 인덱스, 쿼리, vacuum 상태 및 테이블 저장소 분석을 위한 특화된 명령어를 포함합니다.