Repolode
dalibo

dalibo/pg_activity

Консольный инструмент в духе top для мониторинга активности PostgreSQL-сервера, сессий и выполняющихся запросов в реальном времени.

Звёзды
3,051
Форки
196
Открытые issues
18
Последний коммит
в прошлом месяце

Что это?

pg_activity показывает, что происходит на PostgreSQL-сервере прямо сейчас, в терминальном интерфейсе, похожем на top. Он выводит активные бэкенды, их запросы и длительность выполнения, нагрузку на CPU и память, а также скорость чтения и записи. Можно переключаться между выполняющимися, ожидающими и блокирующими запросами. Пользователи могут сортировать таблицу процессов, приостанавливать обновление, копировать выбранный запрос в буфер обмена, а также завершать или отменять бэкенды прямо в интерфейсе.

Инструмент работает локально и удалённо, принимает стандартные строки подключения и параметры libpq. В заголовке можно отображать сведения об экземпляре и системе. Также поддерживаются файлы конфигурации и встроенные профили — narrow, wide и minimal, — задающие отображаемые столбцы. Доступны фильтрация по имени базы данных, экспорт выполняющихся запросов в CSV и поддержка AWS RDS.

Установить инструмент можно из пакетов для дистрибутивов Linux, через PyPI с psycopg или из исходного кода. Поддерживается Python 3.10 и новее.

Ключевые возможности

  • 01Таблица бэкендов PostgreSQL в реальном времени с запросами, длительностью выполнения, нагрузкой на CPU и память, а также скоростью операций ввода-вывода.
  • 02Переключение между представлениями выполняющихся, ожидающих и блокирующих запросов.
  • 03Завершение или отмена бэкендов прямо в интерфейсе.
  • 04Настраиваемые столбцы и встроенные профили отображения.
  • 05Фильтрация по имени базы данных и экспорт выполняющихся запросов в CSV.

Сценарии использования

  • Поиск причин медленного выполнения запросов или конкуренции за блокировки на рабочем сервере PostgreSQL.
  • Мониторинг активности подключений и операций ввода-вывода на удалённом сервере базы данных через SSH.
  • Определение сессий, блокирующих другие сессии во время инцидента.

Быстрый старт

  1. 1

    Установите из PyPI с помощью psycopg

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

    Запустите на локальном сервере от имени пользователя postgres

    sudo -u postgres pg_activity -U postgres

Что важно знать

  • Для доступа ко всем данным требуется пользователь PostgreSQL с правами суперпользователя; в противном случае программа будет работать в ограниченном режиме.

Темы

Частые вопросы

Что такое pg_activity?
Консольный инструмент в духе top для мониторинга активности PostgreSQL-сервера, сессий и выполняющихся запросов в реальном времени. pg_activity показывает, что происходит на PostgreSQL-сервере прямо сейчас, в терминальном интерфейсе, похожем на top. Он выводит активные бэкенды, их запросы и длительность выполнения, нагрузку на CPU и память, а также скорость чтения и записи. Можно переключаться между выполняющимися, ожидающими и блокирующими запросами. Пользователи могут сортировать таблицу процессов, приостанавливать обновление, копировать выбранный запрос в буфер обмена, а также завершать или отменять бэкенды прямо в интерфейсе.
pg_activity можно использовать бесплатно? Какая у него лицензия?
pg_activity распространяется с открытым исходным кодом под лицензией PostgreSQL. Перед использованием в коммерческих продуктах проверьте условия лицензии.
pg_activity всё ещё поддерживается?
Обновлялся за последние 6 месяцев. Последний коммит в pg_activity — 21 сент. 2026 г..
Для чего можно использовать pg_activity?
Поиск причин медленного выполнения запросов или конкуренции за блокировки на рабочем сервере PostgreSQL. Мониторинг активности подключений и операций ввода-вывода на удалённом сервере базы данных через SSH. Определение сессий, блокирующих другие сессии во время инцидента.
Как установить pg_activity?
Установите из PyPI с помощью psycopg: python3 -m pip install "pg_activity[psycopg]" Запустите на локальном сервере от имени пользователя postgres: sudo -u postgres pg_activity -U postgres
Где скачать pg_activity?
Исходный код и инструкции по установке — на GitHub: https://github.com/dalibo/pg_activity

Описание создано ИИ на основе README проекта. Статистика GitHub обновляется ежедневно.

Похожие проекты