원문 캡처 · github.com
원문 캡처 · github.com

RDST는 로컬 컴퓨터에서 PostgreSQL과 MySQL의 쿼리 통계를 살펴 느린 쿼리를 찾고, 인덱스 추가·삭제나 설정 변경 등 개선안을 제시하는 에이전트다. 데이터베이스에는 읽기 전용으로 연결하며, 실행할 변경 사항은 사용자가 직접 적용한다.

RDST는 PostgreSQL의 pg_stat_statements 또는 MySQL의 performance_schema를 1분마다 읽어 실제 실행된 쿼리를 확인한다. 데이터베이스 시간에서 차지하는 비중을 기준으로 쿼리를 정렬하고, 느려지거나 급증했거나 실행이 멈춘 쿼리를 표시한다. 중요한 쿼리에는 EXPLAIN과 스키마를 바탕으로 누락된 인덱스, 서버 설정, 쿼리 재작성 또는 진공 작업 등 가능한 조치를 제안한다.

각 제안에는 예상 절감 시간, 영향을 받는 쿼리, 직접 적용할 단계별 안내와 복사 가능한 SQL이 포함된다. 해당하는 경우 변경을 되돌리는 SQL도 제공한다. 설치 후 읽기 전용 사용자를 지정하고 RDST Agent를 켜면 몇 분 안에 첫 개선 계획이 표시된다. 제안된 변경을 적용한 뒤 완료로 표시하면 에이전트가 효과를 확인한다.

RDST는 데이터베이스에 쓰기 작업을 하지 않는다고 설명한다. 모니터링 기록과 보고서, 설정은 로컬에 저장되고 비밀번호는 운영체제의 자격 증명 저장소에 보관된다. AI 기능에는 SQL 문, 실행 계획, 스키마가 전송되며 테이블의 행 데이터는 전송되지 않는다. 데이터 처리 방식 안내

저장소에는 Python CLI와 HTTP API, 브라우저 UI, Electron 데스크톱 앱, 공유 디자인 시스템이 포함된다. 소스에서 빌드하려면 JavaScript 구성에 Node 22 이상과 pnpm 11, CLI에 Python 3.10 이상과 uv가 필요하다. 데스크톱 사이드카를 빌드하려면 Python 3.12와 먼저 빌드한 웹 번들이 필요하다.

macOS 또는 Linux에서는 다음 명령으로 CLI를 설치할 수 있다.

sh
curl -fsSL https://downloads.readyset.io/packages/rdst-cli/install.sh | sh

CLI는 PyPI나 저장소에서도 설치할 수 있으며, rdst init으로 PostgreSQL 또는 MySQL 대상을 설정하고 rdst top으로 느린 쿼리를 확인할 수 있다. 전체 문서는 RDST 문서에서 볼 수 있다.