schlep

Schlep needs a Redis server, a Schlep server, and some events. It's tested on most versions of Ruby.

gem install schlep

or, add it to your Gemfile:

gem 'schlep'

and then run bundle install.

By default, Schlep will connect to Redis locally, use a blank string as the app name, and get the hostname by running hostname.

To change this, you can configure things one at a time:

Schlep.app       = "My App"
Schlep.host      = "localhost"
Schlep.redis_url = "redis://redis:password@localhost:6379"

or in a block:

Schlep.configure do |config|
  config.app       = "My App"
  config.host      = "localhost"
  config.redis_url = "redis://redis:password@localhost:6379"
end

If you're using Rails, you should probably put the block above in config/initializers/schlep.rb.

For other Ruby apps, anywhere before your first Schlep event is fine.

Schlep.event "event_type", something

something can be almost any Ruby object, and Schlep will do it's best to serialize it to JSON.

For performance, Schlep can send multiple events of the same type to Redis in a more efficient manner. To use this, simply call Schlep.events instead of Schlep.event, and pass an array of objects to serialize:

events = []

1_000_000.times { |n| events << n }

Schlep.events "load_test", events

If you run into any problems, please submit an issue.