=head1 NAME

pg_activity - Realtime PostgreSQL database server monitoring tool

=head1 SYNOPSIS

B<pg_activity> [-UphdC]

=head1 DESCRIPTION

pg_activity is a htop like application for PostgreSQL server activity monitoring.

=head1 COMMAND-LINE OPTIONS

=over 2

=item B<-U USERNAME>, B<--username=USERNAME>

	Database user name (default: $USER).

=item B<-p PORT>, B<--port=PORT>

	Database server port (default: "5432").

=item B<-h HOSTNAME>, B<--host=HOSTNAME>

	Database server host or socket directory (default: "localhost").

=item B<-d DBNAME>, B<--dbname=DBNAME>

    Database name to connect to (default: "postgres").

=item B<-C>, B<--no-color>

	Disable color usage.

=item B<--blocksize=BLOCKSIZE>

	Filesystem blocksize (default: 4096).

=item B<--help>

	Show this help message and exit.

=item B<--version>

	Show program's version number and exit.

=back

=head1 ENVIRONMENT VARIABLES

=over 2

=item B<PGPASSWORD>

    PostgreSQL password

=item B<PGPASSFILE>

    Path to .pgpass file (default is ~/.pgpass)

=back

=head1 DISPLAY OPTIONS

=over 2

=item B<--no-database>

	Disable DATABASE.

=item B<--no-user>

	Disable USER.

=item B<--no-client>

	Disable CLIENT.

=item B<--no-cpu>

	Disable CPU%.

=item B<--no-mem>

	Disable MEM%.

=item B<--no-read>

	Disable READ/s.

=item B<--no-write>

	Disable WRITE/s.

=item B<--no-time>

	Disable TIME+.

=item B<--no-wait>

	Disable W.

=back

=head1 INTERACTIVE COMMANDS

=over 2

=item B<C>     Activate/deactivate colors.

=item B<r>     Sort by READ/s, descending.

=item B<w>     Sort by WRITE/s, descending.

=item B<c>     Sort by CPU%, descending.

=item B<m>     Sort by MEM%, descending.

=item B<t>     Sort by TIME+, descending.

=item B<Space> Pause on/off.

=item B<v>     Change queries display mode: full, truncated, indented

=item B<UP / DOWN> Scroll process list.

=item B<q>     Quit

=item B<+>     Increase refresh time. Maximum value : 3s

=item B<->     Decrease refesh time. Minimum Value : 1s

=item B<F1/1>  Running queries monitoring.

=item B<F2/2>  Waiting queries monitoring.

=item B<F3/3>  Blocking queries monitoring.

=item B<h>     Help page.

=item B<R>     Refresh.

=back

=head1 NAVIGATION MODE

=over 2
	
=item B<UP>    Move up the cursor.

=item B<DOWN>  Move down the cursor.

=item B<k>     Terminate the current backend/tagged backends.

=item B<Space> Tag or untag the process.

=item B<q>     Quit.

=item B<Other> Back to activity.

=back

=head1 EXAMPLES

PGPASSWORD='mypassword' pg_activity -U pgadmin -h 127.0.0.1 --no-client -C

pg_activity -h /tmp

=cut
