mikoi is a HAProxy's proxy protocol enabler for command line tools.
It is designed to work to monitor ProxyProtocol enabled server with usual monitoring plugins such as nagios-plugins and sensu-plugins.
In normal situation, existing monitoring plugins can not monitor ProxyProtocol enabled server without modifications.
mikoi launches a proxy server lisening to an ephemeral port (dynamically allocated port) and forks a plugin with passing the port number to let the pluging connect to that port.
mikoi adds a ProxyProtocol header to traffic comes from a plugin and proxies to real server.
+----------+
+---> | plugin | forked by mikoi
| +----------+
| /|\ |
| | |
| | \|/
| +---------+ +----------+
| | | <--------- | |
+----- | mikoi | | server | (proxy protocol enabled)
| | ---------> | |
+---------+ w/ header +----------+
Download from releases.
Or
go get -u github.com/nabeken/mikoi$ mikoi -h
Usage:
mikoi [OPTIONS]
Application Options:
-H, --hostname= host name
-p, --port= port number
-t, --timeout= connection times out (default: 10s)
-V, --verbose verbose
-P, --proxyproto use ProxyProto
--proxyproto-src= Source address for ProxyProto
Help Options:
-h, --help Show this help message$ mikoi \
-P \
-H smtp.example.com \
-p 25 \
-- /usr/lib/nagios/plugins/check_smtp -H 127.0.0.1 -p {} -w 0.5 -c 1.0{} will be replaced with an ephemeral port that mikoi is listening to.
If you omit command line arguments for plugin, mikoi runs in proxy server mode:
$ mikoi -V -H smtp.example.com -p 25 -P
cmd args: []
mikoi is now running as proxy server mode
mikoi is now listening to 63568
mikoi is launching server
// You can connect to 63568 by any clients
$ telnet 127.0.0.1 63568
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent