HATOP(1)						      General Commands Manual							  HATOP(1)

NAME

       HATop - interactive ncurses client for haproxy

SYNOPSIS

       hatop -s SOCKET [OPTIONS]

DESCRIPTION

       HATop is an interactive ncurses client and real-time monitoring, statistics displaying tool for the HAProxy TCP/HTTP load balancer.

       HATop's	appearance  is similar to top(1). It supports various modes for detailed statistics of all configured proxies and services in near
       realtime.  In addition, it features an interactive CLI for the haproxy unix socket.   This  allows  administrators  to  control	the  given
       haproxy instance (change server weight, put servers into maintenance mode, ...) directly out of hatop (using keybinds or the CLI) and moni-
       tor the results immediately.

       HATop uses a unix domain socket to communicate with HAProxy.  This can be configured in the HAProxy configuration using the "stats  socket"
       option.	To enable all of HATop's features the "level" parameter of this option should be set to "admin".

OPTIONS

       --version
	      show version number and exit

       -h, --help
	      show help message and exit

       -s SOCKET, --unix-socket=SOCKET
	      path to the haproxy stats socket

       -i INTERVAL, --update-interval=INTERVAL
	      update interval in seconds (1-30, default: 3)

       -m MODE, --mode=MODE
	      start in specific mode (1-5, default: 1)

       -n, --read-only
	      disable the cli and query for stats only

       The following filter options may be given multiple times:

       -f FILTER, --filter=FILTER
	      stat filter in format "<iid> <type> <sid>"

       -p PROXY, --proxy=PROXY
	      proxy filter in format "<pxname>"

KEYBINDS

       Hh?    Display help screen

       Qq     Quit

       TAB    Cycle mode forwards

       S-TAB  Cycle mode backwards

       ESC-n  Switch to mode n, where n is the numeric mode id

       ESC    Jump to previous mode

       ENTER  Display hotkey menu for selected service

       SPACE  Copy and paste selected service identifier to the CLI

       UP / DOWN / PGUP / PGDOWN / HOME / END
	      Scroll the stat views to select a given service

HOTKEYS

       F4     Restore initial server weight

       F5     Decrease server weight:	  - 10

       F6     Decrease server weight:	  -  1

       F7     Increase server weight:	  +  1

       F8     Increase server weight:	  + 10

       F9     Enable server (return from maintenance mode)

       F10    Disable server (put into maintenance mode)

SEE ALSO

       haproxy(1)

       A much better documentation can be found online:

       http://feurix.org/projects/hatop/

AUTHOR

       HATop and this man page was written by John Feuerstein.

								  19 August 2010							  HATOP(1)