rTail Server Docker Container (view log events in real time from a web browser)
rTail is a realtime debugging and monitoring tool, which can display multiple aggregate streams via a modern web interface.
rTail is a command line utility that send every line in stdin and broadcasts it over UDP.
UDP is stateless and is used instead of TCP because has better performance.
There is no persistent layer, nor does the tool store any data.
This Docker Container exposes a Web Server in the 8181 port and listen on 9191 port for UDP traffic.
For further information, check out the project webpage.
Both 8181 and 9191 ports are open without authentication. The recomendation is to apply some filter rule in the Firewall.
- HTTP Port (view logs): 8181
- UDP Port (receive logs): 9191
- URL: http://localhost:8181
1. Getting started
$ git clone https://github.com/chilcano/docker-rtail-server.git $ cd docker-rtail-server // Build image $ docker build --rm -t chilcano/rtail-server . // Run container $ docker run -d -t --name=rtail-srv -p 8181:8181 -p 9191:9191/udp chilcano/rtail-server
Check the rTail Server
Just open the rTail Server Web Console from a browser with this URL
But if you want check if rTail Server Container is reacheable remotely (from other VM), just execute this:
// Use NetCat instead of Telnet because Telnet doesn't use UDP $ nc -v -u -z -w 3 <IP_ADDRESS_RTAIL_CONTAINER> 9191 Connection to 192.168.99.100 9191 port [udp/*] succeeded!
To stop, start or restart rTail Server just stop, start or restart the Docker container
Get Shell access to rTail Server Container
$ docker exec -i -t rtail-srv bash
2. Send log events to rTail Server Docker Container
You can send any type of log events, from a syslog event, an echo message or a log by tailing. Before, you have to install rTail application again in the You can send any type of log events, from a syslog event, an echo message or a log by tailing. Before, you have to install rTail application again in the box/VM from where you want send log events.
I have created a Puppet module for rTail and I have included It to the Vagrant box to have the rTail (client) ready to be used.
To get a Vagrant box with rTail (client) pre-installed, you could use these Vagrant scripts (https://github.com/chilcano/vagrant-wso2-dev-srv).
If you have the vagrant-wso2-dev-srv running, then follow the below examples to send log events to rTail Server Docker Container:
For example, to send the
ping traces, execute the next:
// Send Ping events to IP addres $ ping 192.168.99.100 | rtail --id pinging --host 192.168.99.100 --port 9191 --mute
// Tailing a log file $ tail -f /opt/wiremock/wiremock.log | rtail --id wiremock --host 192.168.99.100 --port 9191 --mute