pg_sage
pg_sage es un agente autónomo de DBA para PostgreSQL 14-18 que monitorea, analiza y optimiza bases de datos usando LLMs sin requerir extensiones. Funciona como binary standalone o en Docker Compose.
Ficha actualizada 28 sept 2026, 1:42 · upstream 28 sept 2026, 1:39 · release v1.5.0
Qué es pg_sage
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
pg_sage opera como un agente de gestión autónoma para bases de datos PostgreSQL 14 a 18, ejecutándose junto al servidor sin necesidad de instalar extensiones adicionales. Conecta mediante el protocolo estándar de la línea, recopila datos de rendimiento desde vistas del catálogo y pg_stat_statements, y proyecta problemas en casos de DBA con contexto temporal y acciones siguientes.
La herramienta incluye un executor con rampa de confianza que propone o aplica acciones tipificadas con guardrails, puertas de aprobación, metadatos de rollback y modo shadow para mostrar qué políticas autónomas habrían manejado. Soporta múltiples proveedores como Lakebase, Cloud SQL, AlloyDB, Aurora, RDS, Neon, Supabase y Postgres auto-gestionado.
Incluye dashboard React SPA integrado con API REST, métricas Prometheus nativas en /metrics, alertas a Slack/PagerDuty, y 20+ reglas deterministas para detección de índices duplicados, consultas lentas, bloat, dead tuples, lag de replicación y auditoría de seguridad. Requiere Go 1.24+, Node.js 20+ y opcionalmente compilador C para análisis SQL completo.
- Optimización automática de índices con validación LLM y estimación de costos HypoPG
- Detección y resolución autónoma de incidentes como consultas desbordadas, bloqueos o agotamiento de conexiones
- Tuning de consultas mediante análisis EXPLAIN, reescritura y retiro de hints rotos
- Gestión automática de vacuum, bloat, dead tuples y ajuste de autovacuum por tabla
- Monitoreo de flota con niveles de confianza, presupuestos de tokens y puntuaciones de salud por base de datos
- Executor con rampa de confianza: observación -> consejo -> autónomo con tier de riesgo y guardrails
- Modo shadow para demostrar acciones evitadas antes de activar ejecución autónoma
- Dashboard React SPA integrado con API REST y autenticación por cookie sage_session
- Métricas Prometheus nativas en /metrics con gauges de hallazgos, LLM, executor y tamaño DB
- Soporte multi-proveedor: AWS RDS, GCP AlloyDB/Cloud SQL, Azure Aurora, Neon, Supabase, Lakebase
- 20+ reglas deterministas para índices duplicados, consultas lentas, regresiones, seq scans y seguridad
- Requiere compilador C (gcc/clang) para análisis SQL completo; sin él, sql-ast: unavailable y espera aprobación manual
- El adapter solo catálogo no proporciona métricas de CPU/I/O, por lo que omite admisión automática de índices
- No incluye Dockerfile propio; se debe usar Docker Compose o descargar binary desde releases
- Configuración inicial requiere usuario admin@pg-sage.local con contraseña única en stderr del primer inicio
- Algunas funcionalidades avanzadas como agent DB deployments requieren credenciales cloud específicas y gates de seguridad
Perfil de infraestructura
Estimación inicial derivada del repositorio y de los servicios detectados.
Despliegue detectado
Qué señales reales de instalación hemos encontrado.
Despliega primero en modo shadow para validar acciones antes de activar ejecución autónoma. Usa docker run o binary directo con SAGE_DATABASE_URL configurado. Asegura permisos del usuario admin@pg-sage.local y recupera INITIAL ADMIN PASSWORD desde logs Docker. Configura alertas a Slack/PagerDuty con cooldown y quiet hours. Para análisis SQL completo, instala compilador C (gcc/clang) antes de construir o usar release binaries que ya lo incluyen.
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
Puede sustituir a
Relaciones detectadas por el análisis del repositorio y su categoría.
Experiencia real de la comunidad
Ayuda a contrastar la estimación automática con instalaciones reales.
Todavía no hay datos comunitarios para este proyecto.