Riemann is an event processing system that makes it easy to monitor distributed systems. In this tutorial, we will learn how to install Riemann on Debian.
Before we begin, you will need the following:
Ensure that your Debian system is up to date by running the command below:
sudo apt update && sudo apt upgrade -y
Riemann is written in the Clojure programming language, which in turn runs on the Java Virtual Machine (JVM). Therefore, we need to install an appropriate version of the JVM on our system. In this tutorial, we will install OpenJDK version 8, which is the recommended version for Riemann:
sudo apt install openjdk-8-jdk -y
Next, we will download the latest version of the Riemann from their official website:
wget https://github.com/riemann/riemann/releases/download/0.3.7/riemann-0.3.7.tar.bz2
Once the download is completed, we need to extract the archive:
tar xjf riemann-0.3.7.tar.bz2
After extracting the archive, we need to modify the riemann.config file to match our requirements. You can edit the file using a text editor of your choice, consider using nano or vi.
nano riemann-0.3.7/etc/riemann.config
By default, Riemann logs messages to the console. If you want to save the messages in a file, you can uncomment and modify the line:
;logfile "/var/log/riemann.log"
With the configuration complete, we can start the Riemann service using the following command:
./riemann-0.3.7/bin/riemann
By default, Riemann listens on port 5555 for incoming connections.
Congratulations! We have successfully installed and started Riemann on a Debian system. You can now use Riemann to monitor distributed systems, and you can automate the start-up process of Riemann by creating a systemd service.
If you want to self-host in an easy, hands free way, need an external IP address, or simply want your data in your own hands, give IPv6.rs a try!
