Repolode
dalibo

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. 1

    Instalar desde PyPI con psycopg

    python3 -m pip install "pg_activity[psycopg]"
  2. 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