dalibo/pg_activity

O que é?

Recursos principais

• 01Tabela em tempo real dos backends do PostgreSQL, com consultas, duração, CPU, memória e taxas de I/O.
• 02Alternância entre as visualizações de consultas em execução, aguardando e bloqueadoras.
• 03Encerramento ou cancelamento de backends diretamente pela interface.
• 04Colunas configuráveis e perfis de exibição integrados.
• 05Filtro por nome de banco de dados e exportação das consultas em execução para CSV.

Casos de uso

• Diagnosticar consultas lentas ou contenção por locks em um servidor PostgreSQL de produção.
• Acompanhar em tempo real as conexões e a atividade de I/O por SSH em um host remoto de banco de dados.
• Identificar quais sessões estão bloqueando outras durante um incidente.

Início rápido

1. 1

   Instale pelo PyPI com psycopg

   python3 -m pip install "pg_activity[psycopg]"
2. 2

   Execute em um servidor local como usuário postgres

   sudo -u postgres pg_activity -U postgres

Antes de usar

• !Para acessar todos os dados, é necessário um usuário do PostgreSQL com privilégios de superusuário; caso contrário, o programa será executado em modo degradado.

Tópicos

Perguntas frequentes

O que é pg_activity?

Ferramenta de linha de comando no estilo top para monitorar em tempo real a atividade, as sessões e as consultas em execução no PostgreSQL. pg_activity mostra o que um servidor PostgreSQL está fazendo no momento, em uma interface de terminal parecida com o top. A ferramenta lista os backends ativos e suas consultas, duração, uso de CPU e memória e taxas de leitura e gravação, além de permitir alternar entre consultas em execução, aguardando e bloqueadoras. É possível ordenar a tabela de processos, pausar as atualizações, copiar uma consulta selecionada para a área de transferência e encerrar ou cancelar backends diretamente pela interface.

pg_activity é gratuito? Qual é a licença?

pg_activity é open source sob a licença PostgreSQL. Confira os termos da licença antes de usá-lo em produtos comerciais.

pg_activity ainda é mantido?

Atualizado nos últimos 6 meses. O último commit de pg_activity foi em 21 de set. de 2026.

Para que posso usar pg_activity?

Diagnosticar consultas lentas ou contenção por locks em um servidor PostgreSQL de produção. Acompanhar em tempo real as conexões e a atividade de I/O por SSH em um host remoto de banco de dados. Identificar quais sessões estão bloqueando outras durante um incidente.

Como instalar pg_activity?

Instale pelo PyPI com psycopg: python3 -m pip install "pg_activity[psycopg]" Execute em um servidor local como usuário postgres: sudo -u postgres pg_activity -U postgres

Onde consigo pg_activity?

O código-fonte e as instruções de instalação estão no GitHub: https://github.com/dalibo/pg_activity