/scribe-1

A Ruby client library for Scribe

Primary LanguageRubyApache License 2.0Apache-2.0

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[http://blog.evanweaver.com/files/evan_weaver-original-public_cert.pem].

== Features

* clean encapsulation of the Thrift API
* Ruby 1.9 compatibility

The Github source repository is {here}[http://github.com/fauna/scribe/]. 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}[http://github.com/fauna/scribe/issues]. If you have problems with Scribe itself, please use the {scribe-users mailing list}[http://sourceforge.net/mailarchive/forum.php?forum_name=scribeserver-users].