How to Install Riemann on macOS

Riemann is a monitoring system that collects and processes metrics, events, and messages in real time. In this tutorial, we will guide you through the installation process of Riemann on macOS.

Prerequisites

Before we begin, there are a few things you need to have:

• A macOS operating system.
• Homebrew package manager installed on your system.

Follow the steps below to install Homebrew:

1. Open the Terminal app on your macOS.
2. Enter the following command to install Homebrew:

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

3. Wait for the installation process to complete.

Installing Riemann

Now that you have Homebrew installed on your system, you can proceed with installing Riemann by following the steps below:

1. Open the Terminal app on your macOS.
2. Run the following command to update Homebrew:

brew update

3. Run the following command to install Riemann:

brew install riemann

4. Wait for the installation process to complete.

Testing the Installation

After installing Riemann, you can test if it is running correctly by following the steps below:

1. Open the Terminal app on your macOS.
2. Run the following command to start Riemann:

riemann

3. Wait for Riemann to start.
4. In a new Terminal tab or window, run the following command to send a test event to Riemann:

echo '{:service "test"}' | nc localhost 5555

5. In the previous Terminal tab or window, you should see the following output showing that Riemann has received the test event:

INFO [2022-01-01 00:00:00,000] riemann.network: #riemann.codec.Event{:host "localhost", :service "test", :state "ok", :description nil, :tags nil, :metric nil, :time 1640995200000}

Congratulations! You have successfully installed Riemann on your macOS and verified it is working. You can now start configuring Riemann to monitor your system.

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!