pgrundev/pgbot

해결하는 문제

pgbot은 외부 에이전트, 모니터링 서비스 또는 쓰기 권한 없이도 PostgreSQL 데이터베이스에 대한 즉각적인 읽기 전용 진단 상태 보고서를 제공합니다. 데이터베이스의 내부 통계를 분석하여 개발자와 DBA가 성능 병목 현상, 사용되지 않는 인덱스 및 구성 문제를 신속하게 식별하도록 돕습니다.

작동 방식

단일 정적 바이너리로, pg_monitor 권한이 있는 읽기 전용 역할을 사용하여 데이터베이스에 연결합니다. PostgreSQL의 내부 통계 뷰를 샘플링하여 결정론적인 상태 보고서를 생성합니다. 선택적으로 AI 모델(API 키 사용)을 활용하여 이미 계산된 결과에 대해 쉬운 언어로 설명을 제공할 수도 있습니다. 로컬 기준선을 지원하여 시간 경과에 따른 성능 회귀를 추적하며, CI/CD 파이프라인이나 AI 에이전트 워크플로우에 통합할 수 있도록 기계 판독 가능한 JSON 출력을 제공합니다.

대상 사용자

데이터베이스 성능 문제를 신속하게 분류해야 하거나, 임시 상태 점검을 수행해야 하거나, 전체 모니터링 플랫폼의 오버헤드 없이 데이터베이스 관측 가능성을 자동화된 CI/CD 파이프라인에 통합하려는 개발자 및 데이터베이스 관리자에게 적합합니다.

주요 특징

• 제로 풋프린트: 에이전트나 외부 서비스가 필요 없으며, 쓰기 권한도 요구하지 않습니다.
• 결정론적 결과: 모든 진단은 Go에서 로컬로 계산됩니다. AI는 결과를 생성하는 것이 아니라 요약하는 데에만 사용됩니다.
• CI/CD 준비 완료: JSON 출력, SARIF 보고서 및 자동화된 게이트키핑을 위한 종료 코드를 지원합니다.
• AI 에이전트 친화적: MCP (Model Context Protocol) 서버가 포함되어 있어 AI 에이전트가 데이터베이스 상태를 직접 쿼리할 수 있습니다.
• 회귀 추적: 현재 상태를 과거 기준선과 비교하여 쿼리 성능이나 테이블 사용량의 구체적인 변화를 강조합니다.