Data configurationGrafana integrationsIntegrations referenceRabbitMQ integration

RabbitMQ integration for Grafana Cloud

RabbitMQ is the most widely deployed open source message broker. It supports multiple messaging protocols, and can be deployed in distributed and federated configurations to meet high-scale, high-availability requirements.

The RabbitMQ integration for Grafana Cloud monitors a RabbitMQ Cluster using the built-in Prometheus metrics collector that is shipped natively with RabbitMQ as of version 3.8.0. This integration provides two prebuilt dashboards and five useful alerts.

Install RabbitMQ integration for Grafana Cloud

  1. In your Grafana Cloud instance, click Integrations and Connections (lightning bolt icon), then search or navigate to the RabbitMQ tile.
  2. Click the RabbitMQ tile and click Install Integration.
  3. Once the integration is installed, follow the steps on the Configuration Details page to setup Grafana Agent to automatically scrape and send RabbitMQ metrics to your Grafana Cloud instance.

Post-install configuration for the RabbitMQ integration

In order to enable the Prometheus metrics collector in your Cluster, run the following command:

rabbitmq-plugins enable rabbitmq_prometheus

In the agent configuration file, the agent must be pointed to each node that composes the RabbitMQ Cluster, such as rabbitmqnode1host:15692 in the example below, that exposes a /metrics endpoint.

metrics:
  wal_directory: /tmp/wal
  configs:
    - name: integrations
      scrape_configs:
        - job_name: integrations/rabbitmq
          static_configs:
            - targets: ['rabbitmqnode1host:15692', 'rabbitmqnode2host:15692', 'rabbitmqnode3host:15692']
      remote_write:
        - url: http://cortex:9009/api/prom/push

Dashboards

The RabbitMQ integration for Grafana Cloud provides two pre-built dashboards that are derived from community versions to help you monitor your RabbitMQ clusters. The following dashboards are provided with this integration:

RabbitMQ overview dashboard

This dashboards gives you an overview of your cluster statistics and health, including number of publishers and consumers, connections, channels, queues, incoming and outcoming messages rate, nodes composing the cluster, and general infra related metrics, such as available memory, disk, File descriptors and TCP sockets.

RabbitMQ dashboard1

Erlang-Memory-Allocators dashboard

This dashboard provides a detailed view of the memory allocation of your cluster nodes, with the ability to aggregate by cluster, nodes and allocator type.

RabbitMQ dashboard2

Configure alerts

This integrations ships 5 alerts, between warning and critical levels:

AlertDescription
RabbitmqMemoryHighWarning: A node is using more than 90% of allocated RAM
RabbitmqFileDescriptorsUsageWarning: A node is using more than 90% of file descriptors
RabbitmqUnroutableMessagesWarning: A queue has unroutable messages
RabbitmqNodeNotDistributedCritical: Distribution link state is not ‘up’
RabbitmqNodeDownCritical: Less than 3 nodes running in RabbitMQ cluster

Services and metrics captured by RabbitMQ integration

To see the list of metrics scraped by this integration, refer to this RabbitMQ metrics file

Cost

By connecting your RabbitMQ integration to Grafana Cloud you might incur charges. For more information, use the following links:

For an increase in the number of active series that your Grafana Cloud account uses for metrics included in each Cloud tier, see Active series and dpm usage and Cloud tier pricing.