Skip to content
Ruby client for statsd.
Ruby
Find file
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.
lib
test
.gitignore
Gemfile
README.md
Rakefile
statsd-client.gemspec

README.md

statsd-client

This is a simple client for statsd. It's roughly equivalent to the php and python examples included in the statsd repo. I put it in a gem to make it easy to install, reuse, etc.

Example

require 'rubygems'
require 'statsd'

Statsd.host = 'localhost'
Statsd.port = 8125

Statsd.increment('some_counter') # basic incrementing
Statsd.increment('system.nested_counter', 0.1) # incrementing with sampling (10%)

Statsd.decrement(:some_other_counter) # basic decrememting using a symbol
Statsd.decrement('system.nested_counter', 0.1) # decrementing with sampling (10%)

Statsd.timing('some_job_time', 20) # reporting job that took 20ms
Statsd.timing('some_job_time', 20, 0.05) # reporting job that took 20ms with sampling (5% sampling)

Statsd.gauge('some_gauge', 1337)               # sending gauge values
Statsd.gauge('system.nested_gauge', 1337, 0.1) # sending gauge with sampling

# passing a block to `timing` will capture the time it takes to execute
Statsd.timing('some_job_time') do
  # do some job
end
Something went wrong with that request. Please try again.