#rabbit-hutch

RabbitMq Trace Logger - Listen to multiple RabbitMq instances and log them to a 
single location or MongoDb database. 

# Overview
	
A ruby service for monotoring the trace output on RabbitMq Nodes and writing the 
output to console, Log files or MongoDb.

Once tracing is started on the target rabbitMQ nodes, the service creates a queue 
"rabbithutch" that binds to the exchange "amq.rabbitmq.trace". All messages that arrive
on the queue are then picked up by any registered consumers and written to standard 
output, a log file or a MongoDb Database.
	
# Environment
	
	* Linux
	* Windows
	
# Installation
	
	##Activate tracing on rabbitmq server
	
	run the following command on each server you want to trace
	rabbitmqctl trace_on
	
	##Install the rabbit-hutch service
	
	gem install rabbithutch

# Usage

	Run as a command line process with a config file
	rabbithutch run -- ~/config.yaml
	
	Run as a service
	rabbithutch start -- ~/config.yaml
	
	For help on the service
	rabbithutch
	
# Configuration

	To add RabbitMq nodes to monitor and consumers to enable you will need to change the configuration.
	
	The config below shows two RabbitMq nodes with each with console, mongoDb and log file consumers
	
	./config.yaml
	
	application:
    exchangename: amq.rabbitmq.trace
    queuename: rabbithutch
    
	rabbitmq:
		hosts:
		  - displayname: local1
			enabled: true
			hostname: 127.0.0.1
			username: guest
			password: guest
		  - displayname: local2
			enabled: false
			hostname: 127.2.2.2
			username: guest
			password: guest

	consumers_config:
		consumers:
		  - name: console_consumer
			enabled: true
		  - name: mongo_consumer
			enabled: true
			hostname: 127.0.0.1
			username: guest
			password: guest
			database_prefix: rhutch_
			port: 27017
		  - name: log4r_consumer
			enabled: true
			log_location: /tmp
			log_prefix: rhutch_
	
#Contributing
	
	Fork it
	Create your feature branch (git checkout -b my-new-feature)
	Commit your changes (git commit -am 'Add some feature')
	Push to the branch (git push origin my-new-feature)
	Create new Pull Request

## Create the gem
	
	Build and Test Locally
	-gem build rabbithutch.gemspec
	-gem install rabbithutch-X.X.X # where X.X.X is the version of the compiled gemspec
	
	Build and deploy to rubygems.org
	-gem update --system
	-gem build rabbithutch.gemspec
	-gem push rabbithutch-0.0.1.gem # where X.X.X is the version of the compiled gemspec


References