Cliente de bases de datos para PostgreSQL, MySQL, SQLite, DuckDB y más, con interfaz de terminal (TUI) y atajos de teclado al estilo de Vim.
dalibo/pg_activity
Herramienta de línea de comandos, similar a top, para supervisar en tiempo real la actividad, las sesiones y las consultas de PostgreSQL.
- Estrellas
- 3,051
- Forks
- 196
- Issues abiertos
- 18
- Último commit
- el mes pasado
¿Qué es?
pg_activity muestra en una interfaz de terminal similar a top qué está haciendo un servidor PostgreSQL en ese momento. Presenta los backends activos y sus consultas, duración, uso de CPU y memoria, y tasas de lectura y escritura; además, permite alternar entre las vistas de consultas en ejecución, en espera y bloqueantes. Los usuarios pueden ordenar la tabla de procesos, pausar las actualizaciones, copiar al portapapeles la consulta seleccionada y terminar o cancelar backends directamente desde la interfaz.
La herramienta funciona de forma local o remota y acepta cadenas de conexión y opciones estándar de libpq. Puede mostrar información de la instancia y del sistema en el encabezado, y admite archivos de configuración y perfiles integrados, como narrow, wide y minimal, para controlar qué columnas aparecen. También permite filtrar por nombre de base de datos, exportar a CSV las consultas en ejecución y utilizar AWS RDS.
Se puede instalar mediante paquetes de distribuciones de Linux, desde PyPI con psycopg o a partir del código fuente. Es compatible con Python 3.10 y versiones posteriores.
Funciones clave
- 01Tabla en tiempo real de los backends de PostgreSQL con sus consultas, duración, uso de CPU y memoria, y tasas de E/S.
- 02Alterna entre las vistas de consultas en ejecución, en espera y bloqueantes.
- 03Termina o cancela backends directamente desde la interfaz.
- 04Columnas configurables y perfiles de visualización integrados.
- 05Filtra por nombre de base de datos y exporta a CSV las consultas en ejecución.
Casos de uso
- Diagnosticar consultas lentas o contención por bloqueos en un servidor PostgreSQL de producción.
- Supervisar en tiempo real las conexiones y la actividad de E/S mediante SSH en un host de base de datos remoto.
- Identificar qué sesiones están bloqueando a otras durante un incidente.
Inicio rápido
- 1
Instalar desde PyPI con psycopg
python3 -m pip install "pg_activity[psycopg]" - 2
Ejecutar en un servidor local como usuario postgres
sudo -u postgres pg_activity -U postgres
Antes de usarlo
- Para acceder a todos los datos, se necesita un usuario de PostgreSQL con permisos de superusuario; de lo contrario, se ejecuta en modo degradado.
Temas
Preguntas frecuentes
- ¿Qué es pg_activity?
- Herramienta de línea de comandos, similar a top, para supervisar en tiempo real la actividad, las sesiones y las consultas de PostgreSQL. pg_activity muestra en una interfaz de terminal similar a top qué está haciendo un servidor PostgreSQL en ese momento. Presenta los backends activos y sus consultas, duración, uso de CPU y memoria, y tasas de lectura y escritura; además, permite alternar entre las vistas de consultas en ejecución, en espera y bloqueantes. Los usuarios pueden ordenar la tabla de procesos, pausar las actualizaciones, copiar al portapapeles la consulta seleccionada y terminar o cancelar backends directamente desde la interfaz.
- ¿pg_activity es gratuito? ¿Qué licencia tiene?
- pg_activity es open source bajo la licencia PostgreSQL. Revisa los términos de la licencia antes de usarlo en productos comerciales.
- ¿pg_activity sigue mantenido?
- Actualizado en los últimos 6 meses. El último commit de pg_activity fue el 21 sept 2026.
- ¿Para qué puedo usar pg_activity?
- Diagnosticar consultas lentas o contención por bloqueos en un servidor PostgreSQL de producción. Supervisar en tiempo real las conexiones y la actividad de E/S mediante SSH en un host de base de datos remoto. Identificar qué sesiones están bloqueando a otras durante un incidente.
- ¿Cómo se instala pg_activity?
- Instalar desde PyPI con psycopg: python3 -m pip install "pg_activity[psycopg]" Ejecutar en un servidor local como usuario postgres: sudo -u postgres pg_activity -U postgres
- ¿Dónde consigo pg_activity?
- El código fuente y las instrucciones de instalación están en GitHub: https://github.com/dalibo/pg_activity
Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.
Proyectos relacionados
Interfaz de terminal controlada con el teclado para conectarse a muchas bases de datos SQL y consultarlas, inspirada en lazygit.
Monitor de sistema multiplataforma para terminal y web que muestra CPU, memoria, disco, red, procesos y contenedores, con API REST y exportación de datos.
GoAccess analiza logs web en tiempo real y muestra estadísticas de tráfico en la terminal o en un dashboard HTML en vivo.
Cliente de bases de datos multiplataforma y ligero para más de 100 bases de datos, con app de escritorio, Docker, CLI, asistente de SQL con IA y servidor MCP.
Herramienta de migraciones de bases de datos escrita en Go, con CLI y biblioteca para aplicar cambios de esquema ordenados en numerosas bases de datos.