WHERE DO I START?
You are here:Integrations > RabbitMQ

RabbitMQ

Summary

Rabbit MQ is a message broker that manages queues between message producers and consumers. Netuitive can be used to monitor your RabbitMQ server's queuing performance. Additional configuration options are available below the instructions.

Configuration

Important   If you haven't installed the Linux agent already, see the instructions on this page for how to install it. If you need to disable the Linux integration or view the unique API key assigned to your account, navigate to the Integrations page under the user account drop-down menu and click the integration designated as Infrastructure under the Integration column.

Collector Configuration

Important   Before editing the configuration file, you should verify the RabbitMQ management module is enabled. If the module is not enabled, do the following:
  • If the package is installed globally, type this into your command prompt:
    rabbitmq-plugins enable rabbitmq_management
  • If the package is installed in a directory, type this into your command prompt instead:
    /usr/lib/rabbitmq/bin/rabbitmq-plugins enable rabbitmq_management
  1. Navigate to the collectors folder.
    Note   The default location is /opt/netuitive-agent/conf/collectors.
  2. Open the RabbitMQCollector.conf file.
    Note   This configuration file will only be available in agent versions 0.3.1 or later. Otherwise, you will have to create a configuration file with the same name.
  3. Change the enabled setting to True.
  4. Replace the default host address and/or port number if necessary.
  5. Replace the user and password settings with the appropriate values.
  6. Optionally, change the cluster value to false if you aren't using a cluster or do not wish to collec several additional cluster metrics.
  7. Save the file, and restart the Linux Agent.
  8. Note   This integration's package (computed metrics, dashboards, and policies that will give you important events and alerts) will be automatically enabled and provisioned to your account as soon as Netuitive receives data from the integration. The PACKAGES button on the integration setup page will become active once data is received, so you'll be able to disable and re-enable the package at will.

Additional Configuration Options

Collector Options

Option Default Description
enabled False Enable collecting RabbitMQ metrics.
host 127.0.0.1:15672 Hostname and port to collect from.
user guest User name authentication for RabbitMQ.
password guest Password authentication for RabbitMQ.
replace_dot '_' A value to replace the "." in queue names and vhosts names. This option helps Netuitive's metadata usage if you use dots in your queue naming convention.
cluster True If this node is part of a cluster, the collector will collect metrics on the cluster health.
metrics_blacklist "(.*-test__[abc]-.*)|(rabbitmq\.queues\..*)" Regex list to match metrics to block. Mutually exclusive with metrics_whitelist option.
byte_unit   Default numeric output(s).
measure_collector_time   Measure the collector's run time in milliseconds.
metrics_whitelist   Regex list to match metrics to transmit. Mutually exclusive with metrics_blacklist option.
queues   List of queues to publish. Leave empty to publish all.
queues_ignored   A list of queues or regexes for queue names not to report on.
vhosts   A list of vhosts and queues to collect.
Important   If a vhosts section exists but is empty, then no queues will be polled.

Dependencies

OS

Redhat 6 and 7
CentOS 6 and 7
Amazon Linux (latest)
Ubuntu 12, 14, 15, and 16
Debian 7, 8, and 9

Miscellaneous

Linux Agent
RabbitMQ

Metrics