Giter VIP home page Giter VIP logo

plugin-haproxy's Introduction

Boundary HAProxy Plugin

Collects statistics from an HAProxy instance. To get statistics from HAProxy instance, you need to instruct HAProxy where to host the statistics. Either a filesocket or webpage can be specified.

Prerequisites

OS Linux Windows SmartOS OS X
Supported v v v v
Runtime lua Python Java
Required +

Plugin Setup

The plugin requires either a file socket or a web page to collect HAProxy statistics. The sections below describe configuration for each.

Using a File Socket

The following snippet of configuration will host the statistics on a file socket.

  • the mode parameter sets the mode of the file socket. If the relay is running as the same user as haproxy, mode 777 can be omitted'

  • the level parameter limits the commands available from the file socket

    global stats socket /tmp/haproxy mode 777 level operator

Using a Web Page

The following snippet of configuration will tell haproxy to host a webpage the plugin will scrape (you can view the webpage as well)

  • stats enable tell haproxy to enable the webpage

  • stats uri /stats tell haproxy to host the webpage at /stats, this needs to be a unique URL not being used in your application. If your website already has a /stats page, change this values to something else

  • stats auth username:password tell haproxy to password protect the page with the username and password combination

  • stats refresh 10 tells haproxy to refresh the webpage every 10s if your browser is viewing it

    defaults stats enable stats uri /stats stats auth username:password stats refresh 10

Once you make the update, reload your haproxy configuration sudo service haproxy reload

Plugin Configuration Fields

Field Name Description
Source The Source to display in the legend for the haproxy data. It will default to the hostname of the server
Statistics URL The URL endpoint of where the haproxy statistics are hosted. Socket or URL is required
Username If the endpoint is password protected, what username should graphdat use when calling it.
Password If the endpoint is password protected, what password should graphdat use when calling it.
Filter Which Server groups would you like to view
Poll Seconds How often should the plugin poll the Haproxy endpoint

Metrics Collected

Tracks the following metrics for haproxy

Metric Name Description
Haproxy Queued Requests current queued requests
Haproxy Queue Limit queue Limit
Haproxy Handled Requests total number of HTTP requests handled
Haproxy Client Aborts number of data transfers aborted by the client
Haproxy Server aborts number of data transfers aborted by the server
Haproxy Current Sessions current sessions
Haproxy Session Limit session limit
Haproxy Bytes In bytes in
Haproxy Bytes Out bytes out
Haproxy Warnings retries + redispatched
Haproxy Errors request errors + connection errors + response errors
Haproxy Failed Health Checks the number of failed health checks
Haproxy Downtime the number of seconds haproxy is down
Haproxy 1XX Resp The number of 1XX HTTP responses
Haproxy 2XX Resp the number of 2XX HTTP responses
Haproxy 3XX Resp the number of 3XX HTTP responses
Haproxy 4XX Resp the number of 4XX HTTP responses
Haproxy 5XX Resp the number of 5XX HTTP responses
Haproxy Other Resp http responses with other codes (protocol error)

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.