collectd-activemq-python

Python-based plugin to put simple [ActiveMQ] (http://activemq.apache.org/) stats to collectd

Data captured includes:

• Queue name
• Number of messages in queue
• Number of consumers
• Counter of enqueued messages
• Counter of dequeued messages

[powdahoud's redis-collectd-plugin] (https://github.com/powdahound/redis-collectd-plugin/) was used as template, [kipsnak's Perl ActiveMQ Munin plugin] (https://github.com/kipsnak/munin-activemq-plugin) - as inspiration. :)

Install

1. Place activemq_info.py in /usr/lib/collectd/plugins/python
2. Configure the plugin (see below).
3. Restart collectd.

Configuration

Add the following to your collectd config

<LoadPlugin python>
  Globals true
</LoadPlugin>

<Plugin python>
  ModulePath "/usr/lib/collectd/plugins/python"
  Import "activemq_info"

  <Module activemq_info>
    Host "localhost"
    Port 8161
  </Module>
</Plugin>

Optional attributes can be set to configure http auth or webadmin root path:

  <Module activemq_info>
    Host "localhost"
    Port 8161
    User "jdoe"
    Pass "123qwerty"
    Webadmin "amq-admin"
  </Module>

It will access http://localhost:8161/amq-admin/xml/queues.jsp and authenticate with jdoe/123qwerty

Dependencies

Python-requests module is required. Please install it with pip install requests or use your package manager to install python-requests package or similar.

License

MIT

Support

Please do not send me PMs in Twitter with issues. Just open an issue on projects' Github instead and I'll respond ASAP!

Contact

Denis Zhdanov (@deniszh)