Emque Stats

A library that provides any Emque::Producing application instrumentation capabilities for collecting application statistics and events. Stats and events are sent as just another Emque message through the Message Broker (RabbitMQ).

A separate Emque::Consuming service must be created and deployed to process the data. In doing so, you can use your preferred graphing or analytics solution, be it Graphite, StatsD, New Relic, Keen.io, etc.

Add this line to your application's Gemfile:

gem 'emque-stats'

And then execute:

$ bundle

Or install it yourself as:

$ gem install emque-stats

For any app already using Emque::Producing, there is nothing further to do. Emque::Stats will re-use the same configuration.

For an app that is not already using Emque::Producing.

  Emque::Stats.configure do |config|
    emque_configuration = Emque::Producing::Configuration.new
    emque_configuration.app_name = "your_app"
    emque_configuration.rabbitmq_options = { :url => "your rabbitmq url" }
    config.emque_producing_configuration = emque_configuration
  end

Send some stats

  # track activity
  Emque::Stats.track("login", {:user_id => 1, :another_property => "something"} )

  # counter
  Emque::Stats.increment("garets")
  Emque::Stats.count("garets", 20)

  # timing
  Emque::Stats.timer("glork", 320)

  # gauge
  Emque::Stats.gauge("bork", 100)

To run tests...

bundle exec rspec

FIRST: Read our style guides at https://github.com/teamsnap/guides/tree/master/ruby

1. Fork it ( http://github.com/emque/emque-stats/fork )
2. Create your feature branch (git checkout -b my-new-feature)
3. Commit your changes (git commit -am 'Add some feature')
4. Push to the branch (git push origin my-new-feature)
5. Create new Pull Request