statsd-ruby

A Ruby client for StatsD

Installing

Bundler:

gem "statsd-ruby"

Basic Usage

# Set up a global Statsd client for a server on localhost:9125
$statsd = Statsd.new 'localhost', 9125

# Set up a global Statsd client for a server on IPv6 port 9125
$statsd = Statsd.new '::1', 9125

# Send some stats
$statsd.increment 'garets'
$statsd.timing 'glork', 320
$statsd.gauge 'bork', 100

# Use {#time} to time the execution of a block
$statsd.time('account.activate') { @account.activate! }

# Create a namespaced statsd client and increment 'account.activate'
statsd = Statsd.new('localhost').tap{|sd| sd.namespace = 'account'}
statsd.increment 'activate'

Testing

Run the specs with rake spec

Run the specs and include live integration specs with LIVE=true rake spec. Note: This will test over a real UDP socket.

Performance

Extensions / Libraries / Extra Docs

Contributing to statsd

Contributors

Copyright

Copyright © 2011, 2012, 2013 Rein Henrichs. See LICENSE.txt for further details.