scribe

A Ruby client for the Scribe distributed log server.

License

Copyright 2009 Twitter, Inc. See included LICENSE file.

The public certificate for this gem is here.

Features

  • clean encapsulation of the Thrift API

  • Ruby 1.9 compatibility

The Github source repository is here. Patches and contributions are very welcome.

Installation

You need Ruby 1.8 or 1.9. If you have those, just run:

sudo gem install scribe

Usage

Now, start IRb and require the library:

require 'scribe'

Connect to a server:

client = Scribe.new('127.0.0.1')

Log a line:

client.log("started up")

Log a line with a category:

client.log("my app started up", "MyApp")

Batch a number of log lines and send them all at once:

client.batch do
  client.log("booting")
  client.log("loading data")
  client.log("success!")
end

That is all.

Reporting problems

The Github issue tracker is here. If you have problems with Scribe itself, please use the scribe-users mailing list.