haupdown is a server for the HAproxy Agent Check protocol. It is expected to run as a sidecar everywhere you run HAproxy-managed services; configure HAProxy to talk to it via the agent-check flag. It accepts TCP connections of the HAproxy agent protocol on the port specified by the environment variable $PORT (or --port) and binds a simple admin socket at the UNIX domain socket path specified by $SOCKET_BIND_PATH (or --socket-bind-path).

This is basically a replacement for hacheck that only does the agent-check parts.

Using the --required-groups option, you can require that connectors to the administrative socket be in one of the listed Unix groups in order to change state. By default, everyone who can write to it can change its state.

If the --global-down-file (-G) option is provided with a path, haupdown will behave as through the "all" service is down when that path exists.

This work is licensed under the ISC license, a copy of which can be found at LICENSE.txt.

Admin Socket Commands

• up servicename: mark servicename as administratively up (READY in agent parlance)
• down servicename: mark servicename as administratively down (MAINT in agent parlance)
• status servicename: show the status of servicename
• ping: confirm that the socket works
• showall: dump all downed services' state as JSON
• quit: disconnect from the admin socket

Logging / Monitoring

Logging can be configured with the --syslog, --stderr, and --log-level options. If neither --syslog nor --stderr are set, haupdown will attempt to guess a destination.

If syslog is selected and the environment $LOG_DGRAM_SYSLOG is set to a domain socket path, this service will log some stuff using the RFC 3164 syslog protocol to that path. Otherwise, 3164-protocol syslog will be sent to the default destination.