Skip to main content

Monitor RabbitMQ using Levitate

Send RabbitMQ metrics to Levitate

Introduction​

This document lists step-by-step instructions for setting up monitoring for RabbitMQ using Levitate.

Prerequisites​

Create a Levitate cluster by following Getting Started.

Keep the following information handy after creating the cluster:

  • $levitate_read_url - Levitate's Read endpoint
  • $levitate_username - Cluster ID
  • $levitate_password - Read token created for the cluster

Ensure RabbitMQ is installed and running on each VM. You should have root or administrative access.

Ensure that rabbitmq_prometheus plugin is configured as per its documentation.

Configure Prometheus Agent to Scrape Metrics​

Architecture​

prometheus-rabbitmq

Setting up Prometheus Agent​

Install Prometheus Agent on a central server that can access all VMs running RabbitMQ. This script can be run on the server:

#!/bin/bash

# Function to determine OS architecture
get_architecture() {
    architecture=$(uname -m)
    case $architecture in
        x86_64)
            arch="amd64"
            ;;
        aarch64)
            arch="arm64"
            ;;
        arm*)
            arch="armv7"
            ;;
        *)
            echo "Architecture $architecture is not supported by this script."
            exit 1
            ;;
    esac
    echo $arch
}

# Define version and architecture
VERSION="2.37.0"
ARCH=$(get_architecture)

# Download and install Prometheus Agent
URL="https://github.com/prometheus/prometheus/releases/download/v$VERSION/prometheus-$VERSION.linux-$ARCH.tar.gz"
wget $URL -O prometheus.tar.gz
tar -xzf prometheus.tar.gz
cd prometheus-$VERSION.linux-$ARCH

# Move executables to your PATH
sudo mv prometheus promtool /usr/local/bin/
sudo mkdir /etc/prometheus
sudo mkdir -p /var/lib/prometheus
sudo mv consoles/ console_libraries/ prometheus.yml /etc/prometheus/

# Create a service file for Prometheus
echo "[Unit]
Description=Prometheus
Wants=network-online.target
After=network-online.target

[Service]
User=$USER
Restart=on-failure
ExecStart=/usr/local/bin/prometheus \\
    --config.file=/etc/prometheus/prometheus.yml \\
    --enable-feature=agent

[Install]
WantedBy=multi-user.target" | sudo tee /etc/systemd/system/prometheus.service

# Reload systemd to pick up the new service and start Prometheus Agent
sudo systemctl daemon-reload
sudo systemctl start prometheus
sudo systemctl enable prometheus

Configure Scrape Targets​

Use either ec2_sd_config or file_sd_config to configure scrape targets. The example uses file_sd_config for simplicity.

Create a file targets.json and add the following:

Ensure that the targets are the Private IPs of the RabbitMQ cluster or instances.

[
  {
    "targets": ["rbmq-vm-1:15692", "rbmq-vm-1:15692"],
    "labels": {
      "job": "rabbitmq"
    }
  }
]

Configure Levitate Remote Write Credentials into Prometheus Agent​

Add the following remote_write configuration to the prometheus.yml file:

echo "remote_write:
  - url: "$remote_write_url"
    basic_auth:
      username: "$remote_write_username"
      password: "$remote_write_password"
    write_relabel_configs:
      - source_labels: [__name__]
        regex: 'rabbitmq_(.*)'" | sudo tee -a /etc/prometheus/prometheus.y

Replace remote_write_* template variables with your Levitate Credentials that can be obtained by following this documentation

Restart Prometheus Agent​

Restart Prometheus Agent to apply changes:

sudo systemctl restart prometheus

Verification​

  • Check Prometheus Agent' /targets and /graph web interfaces to ensure it's scraping the RabbitMQ metrics
  • Verify that metrics are being received in the remote storage

This script-driven setup automates the deployment and configuration of RabbitMQ monitoring using Prometheus Agent.

Dashboard​

Download the latest dashboard from here to visualize the metrics.

rabbitmq-levitate-1 rabbitmq-levitate-2 rabbitmq-levitate-3

Troubleshooting​

Please get in touch with us on Discord or Email if you have any questions.