Matchmonitor version 1 release
I have released the first version of matchmonitor.
It's a simple web GUI which will highlight matches in incoming UDP packets. If the text is matched at a regular interval, it will be colored blue. If the match misses it's interval, it will be colored red. This allows you to monitor common processes and heartbeats like CRON jobs and machines sending PING messages.
You can run the server by downloading the release jar file and executing:
java -jar matchmonitor-1.0.0.jar
This will start a web server on port 8080 and an UDP server on port 8081. This means that after starting it, you can visit the interface using http://localhost:8080/.
To change the port number of either, use the options you see when adding the commandline parameter --help.
usage: matchmonitor [-h] [--httpPort HTTPPORT] [--udpPort UDPPORT]
[--historySize HISTORYSIZE] [--conf CONF]
Light up regularly matching elements on a web GUI
optional arguments:
-h, --help show this help message and exit
--httpPort HTTPPORT HTTP web server port (GUI) (default: 8080)
--udpPort UDPPORT UDP packet receiving port (default: 8081)
--historySize HISTORYSIZE
Number of match intervals to factor into the
period calculation (default: 30)
--conf CONF Yaml configuration file with regexes list
containing regular expressions to match. Default
matching is ip addresses.
The last mentioned Yaml configuration file contains a simple list of regular expressions, the first match group of which is displayed in the web GUI and monitored for it's regularity. An example configuration file is:
regexes:
- ([0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3})
- ([a-zA-Z]+ CRON)
It is in Yaml format, so do not forget the indentation and dashes to form the list of regular expressions. Also make sure it contains at least one match group using parenthesis.
If you happen to find issues, feel free to fork me on github and patch it. Another option is to just leave a comment.