/rabbitmq_stats

Utility to gather RabbitMQ Stats (JSON Format) and write to STDOUT and/or to file.

Primary LanguagePythonMIT LicenseMIT

Rabbit MQ Stats Logging

Currently the RabbitMQ Admin Plugin only keeps up to the last days worth of stats. This is to allow the gathering of RabbitMQ stats so that it can be retained for longer periods of time. The stats are written to a file in json format and can later be parsed and/or input into systems like (Logstash, Elasticsearch...) for further analysis and graphing.

Getting started

Installation (Preferred)

$ pip installl rabbitmqStats

Installation (Alternative)

Download .tar.gz file from /dist directory and pip install

$ wget https://raw.githubusercontent.com/CodeBleu/rabbitmqStats/develop/rabbitmqStats-VERSION.tar.gz

$ pip install rabbitmqStats-VERSION.tar.gz

After install run the following to see default opitions:

$ rbqstats --help

RabbitMQ setup

From a high level, you need to enable the rabbitmq_management plugin and make sure the port it's listening on is reachable from the outside.

Speaking with a little more granularity, using RHEL as an example, these are the steps you need to take:

  • rabbitmq-plugins enable rabbitmq_management
  • iptables -A INPUT -p tcp --destination-port 15627 -j ACCEPT
  • iptables-save > /etc/sysconfig/iptables

Development

Want to contribute? Great! No specifics at this point. Just basic GitHub Fork and Pull request on the 'development' branch.

For further info, see github guide on contributing to opensource project.

After cloning your Forked branch locally, You can run the program by running the following:

$ ./main.py  --help

Todos

  • Better documentation
  • Add config file for CLI
  • more testing

License

MIT LICENSE.txt