Configure RabbitMQ integration

To integrate RabbitMQ with SolarWinds Observability SaaS:

1. In SolarWinds Observability SaaS, click Add Data at the top.

2. In the Add Data dialog Intro, click the Integrations tab, and then click RabbitMQ.

3. In the Add RabbitMQ dialog, select a host with the SolarWinds Observability Agent you want to use for RabbitMQ and click Next.

   To only display Agents running in a Kubernetes cluster, click the List only Agents... toggle.

   If you want to install a dedicated Agent on a dedicated host, add the host and then add the RabbitMQ integration. See Add a self-managed host.

   If you prefer using Docker, see Run the SolarWinds Observability Agent as a Docker image or Kubernetes deployment.

4. Select where the RabbitMQ service is located:

   • On Host: The RabbitMQ service runs on the same physical or virtual machine as the Agent.

   • Off Host: The RabbitMQ service runs on a different physical or virtual machine than the Agent.

5. Make sure that RabbitMQ is ready to be integrated.

   1. Ensure that the RabbitMQ version on your server is 3.8 or 3.9.

   2. Run the following command to enable the RabbitMQ management plugin

      rabbitmq-plugins enable rabbitmq_management

   3. Open a browser and verify that RabbitMQ is running on localhost, port 15672.

      If you are using the default password, consider changing it to improve security.

      http://localhost:15672

   4. Run the following command to enable the RabbitMQ Prometheus Plugin. For details, refer to RabbitMQ documentation.

      rabbitmq-plugins enable rabbitmq_prometheus

   5. Run the following command to test that Prometheus metrics are exposed. The call should return a list of metrics.

      curl http://localhost:15692/metrics

6. Specify credentials to be used for authenticating the RabbitMQ integration in SolarWinds Observability SaaS.

   • Add New Credential

     Select this option to create new credentials. Provide a name for the credentials set and the requested details, such as password, API key, and/or client secret.

   • Use Existing Credential

     Select this option to use existing credentials. Select credentials from the list.

7. Review the configuration and click Deploy to deploy the changes to the agent.

   • Provide a Display Name to differentiate the RabbitMQ integration from other plugins on the Agent. The default value is the plugin instance name, such as rabbitmq-XXXXXXXX.

   • Review the RabbitMQ Endpoint. Check the URL of the RabbitMQ management plugin endpoint and the port.

     http://localhost:15672

   • Review the Prometheus Endpoint. Check the URL of the RabbitMQ Prometheus plugin endpoint and the port. Default value:

     localhost:15692

   • Review the Collection Interval.

   • For On Host integrations, you can collect logs. Click Enable log monitoring and configure logs.

8. Optional for On Host integrations: Configure logs.

   If you enabled logs:

   1. Grant the Agent access to the RabbitMQ log folder. Use the following command:

      sudo usermod -a -G adm swagent

   2. Restart the Agent. Run the following command.

      sudo service uamsclient restart

   3. Review the default path for storing logs. Adjust it if appropriate.

9. When the installation is complete, you can continue to observe RabbitMQ data. Use the buttons on the Summary screen.

To view data collected for the newly configured integration, click Dashboards and search for RabbitMQ. Click the system dashboard for RabbitMQ. See Dashboards.

To view metrics collected for RabbitMQ, click Analyze > Metrics and search for RabbitMQ. See Metrics Explorer for details.