lua-haproxy

lua-haproxy provides:

• a high-level Lua binding for the HAProxy stats interface
• an embedded HTTP API that runs as a service inside HAProxy

Requirements

• Linux

• HAProxy 1.6+ with Lua support

  To check if your version includes Lua, run:

  haproxy -vv | grep Lua
  

• HAProxy must run in single-process mode (default)

• Lua 5.3 and Luarocks for development

Install

1. Clone the repo.

   git clone https://github.com/benwebber/lua-haproxy
   

2. Install the rock.

   luarocks install haproxy-scm-0.rockspec
   

3. Configure HAProxy to run the Lua service.

   It might be convenient to run the API on a dedicated port:

   global
     stats socket /run/haproxy/admin.sock mode 660 level admin
     lua-load /usr/local/bin/lua-haproxy-api
   
   listen http
     bind *:8000
     mode http
     http-request use-service lua.haproxy-api
   

Embedded API

The main entry point for this package provides an embedded HTTP API. The API runs as a Lua service inside HAProxy. Use it to introspect the parent process.

Overview

Requests that create or modify resources should be encoded as JSON (Content-Type: application/json).

The API will return structured data as JSON, and unstructured data as plain text (Content-Type: text/plain).

Endpoints

config

stats

Documentation

Refer to the Lua API documentation for details:

https://benwebber.github.io/lua-haproxy/

Caveats

lua-haproxy is not production-ready. Both the internal Lua API and embedded HTTP APIs are unstable.

License

MIT