• This project is unsupported * - use it as you want, but know that we have no guarantee of support in case of any error. As all we do, we really want to do our best, and will try to help on any problem, but we give you no guarantee of time, and solutions.

This is a Newrelic plugin used to monitor ActiveMQ. The main idea is to parse ActiveMQ stats (/admin/xml/queues.jsp) and send them to Newrelic.

Currently, we send the following metrics:

• Total number of consumers
• Total queue size
• Jobs enqueued in the last minute
• Jobs dequeued in the last minute

Simply download the latest release and uncompress it in the desired folder. Ex:

$ wget https://github.com/easytaxibr/newrelic_activemq/archive/0.0.2.tar.gz
$ tar -zxvf 0.0.2.tar.gz -C /opt
$ ln -sf /opt/newrelic_activemq-0.0.2/ /opt/newrelic_activemq
$ cd /opt/newrelic_activemq && bundle install

To configure the project, just copy the config/newrelic_plugin.yml.sample to config/newrelic_plugin.yml:

$ cp config/newrelic_plugin.yml.sample config/newrelic_plugin.yml

After that configure the queues you want to monitor. For a single queue:

  activemq:
    queue_name: lets_monitor
    activemq_url: https://activemq-server.yourdomain.com:8161
    activemq_user: username
    activemq_password: password

For multiple queues, you can simple use an array:

  activemq:
    -
      queue_name: lets_monitor
      activemq_url: https://activemq-server.yourdomain.com:8161
      activemq_user: username
      activemq_password: password
    -
      queue_name: lets_monitor_other_queue
      activemq_url: https://activemq-server.yourdomain.com:8161
      activemq_user: username
      activemq_password: password

In the plugin installation folder run:

$ ./newrelic_activemq.rb

We strongly encourage you to create a startup script. We provide an example under extra/newrelic_activemq-upstart for Debian. We appreciate a PR with a sample script of your own distro.

Yes, sure.