pg_activity
htop like application for PostgreSQL server activity monitoring.
Dependencies
python >= 2.6
psycopg2 >= 2.2.1
psutil >= 0.5.1
setuptools >= 0.6.14
Installation
sudo python setup.py install
Installation with man page
sudo python setup.py install --with-man
Usage
pg_activity works localy or remotely. In a local execution context, to obtain sufficient rights to display system informations, the system user running pg_activity must be the same user running postgresql server (postgres by default), or have more rights like root. Otherwise, pg_activity can fallback to a degraded mode without displaying system informations. On the same way, postgres role used to connect to the database must be super user.
ex:
sudo -u postgres pg_activity -U postgres
Options
pg_activity [options]
Options:
--version Show program's version number and exit
-U USERNAME, --username=USERNAME
Database user name (default: "postgres").
-p PORT, --port=PORT Database server port (default: "5432").
-h HOSTNAME, --host=HOSTNAME
Database server host or socket directory (default:
"localhost").
-d DBNAME, --dbname=DBNAME
Database name to connect to (default: "postgres").
-C, --no-color Disable color usage.
--help Show this help message and exit.
--debug Enable debug mode for traceback tracking.
--blocksize=BLOCKSIZE Filesystem blocksize (default: 4096).
Display options, you can exclude some columns by using them :
--no-database Disable DATABASE.
--no-user Disable USER.
--no-client Disable CLIENT.
--no-cpu Disable CPU%.
--no-mem Disable MEM%.
--no-read Disable READ/s.
--no-write Disable WRITE/s.
--no-time Disable TIME+.
--no-wait Disable W.
Interactives commands
C Activate/deactivate colors
r Sort by READ/s, descending
w Sort by WRITE/s, descending
c Sort by CPU%, descending
m Sort by MEM%, descending
t Sort by TIME+, descending
Space Pause on/off
v Change queries display mode: full, truncated, indented
UP/DOWN Scroll processes list
q Quit
+ Increase refresh time. Maximum value : 3s
- Decrease refesh time. Minimum Value : 1s
F1/1 Running queries list
F2/2 Waiting queries list
F3/3 Blocking queries list
h Help page
R Refresh
Navigation mode
UP Move up the cursor
DOWN Move down the cursor
k Terminate the current backend/tagged backends
Space Tag or untag the process
q Quit
Other Back to activity
