Skip to content

tpett/hastats

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

8 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

HAStats – An HAProxy socket tool for Ruby

HAStats communicates with a running HAProxy process through the “stats socket” (not enabled by default). Through this socket you can query stats, reset counters, change server weightings, put servers in maintenance mode, and more.

Setup HAProxy

Add the following to your HAProxy config (see the HAProxy documentation for more details):

# You can specify lower levels to restrict certain commands -- admin allows everything
stats socket /var/run/haproxy.sock level admin

Using the command line tool

$ hastats
Tasks:
  hastats clear                                   # [FUTURE] Clear counter maximums (see --all option)
  hastats disable [BACKEND] [SERVER]              # Put a server into MAINT mode
  hastats enable [BACKEND] [SERVER]               # Remove a server from MAINT mode
  hastats errors                                  # [FUTURE] Get current error information
  hastats get_weight [BACKEND]/[SERVER]           # [FUTURE] Get a server's weight
  hastats help [TASK]                             # Describe available tasks or one specific task
  hastats info                                    # Get information about the HAProxy process
  hastats sess                                    # [FUTURE] Get current session information
  hastats set_weight [BACKEND] [SERVER] [WEIGHT]  # [FUTURE] Set a server's weight. Weight is a number or percentage of current weight
  hastats stat                                    # Get information about all frontends/backends/servers

Options:
  -j, [--json]           # Return results in JSON for easy parsing
  -s, [--socket=SOCKET]  
                         # Default: /usr/local/var/run/haproxy.sock

About

Ruby library for talking to HAProxy's stats socket

Resources

Stars

Watchers

Forks

Packages

No packages published

Languages