https://github.com/mszenher/zipkin-tracer

zipkin-tracer middleware and stuff
https://github.com/mszenher/zipkin-tracer

Last synced: 3 months ago
JSON representation

zipkin-tracer middleware and stuff

• Host: GitHub
• URL: https://github.com/mszenher/zipkin-tracer
• Owner: mszenher
• Created: 2013-12-13T22:44:08.000Z (almost 11 years ago)
• Default Branch: master
• Last Pushed: 2014-03-29T16:46:43.000Z (over 10 years ago)
• Last Synced: 2024-07-20T03:48:19.230Z (4 months ago)
• Language: Ruby
• Size: 473 KB
• Stars: 9
• Watchers: 2
• Forks: 4
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# Zipkin-Tracer Gem

This document primarily describes the Zipkin tracer ruby gem.  For general information about Zipkin, including installation 

and usage, see the [Zipkin repository](https://github.com/twitter/zipkin).

This gem does two things:

* It provides Rack middleware which plucks Zipkin activity information out of incoming requests and sends it to 

Zipkin.  The middleware also puts Zipkin activity information in `Thread.current` so that it is available to the consuming

application.

* It provides Faraday middleware which puts Zipkin tracing information into outgoing requests, so long as those requests are made by a Faraday instance.

## Usage

First off, you shouldn't use Zipkin in your test environment unless you really, really want to.

Assuming you are using Bundler, update your Gemfile as follows:

```

gem 'zipkin-tracer', :git => '[email protected]:mszenher/zipkin-tracer.git', :require => 'zipkin-tracer', :tag => 'v0.4.0'

gem 'thin'

```

Of course, you can change the `:tag` option from `'v0.4.0` to any tagged version you choose.  Also, the dependence on the `thin`

gem will hopefully go away soon.

Initialize the middleware as follows (this assumes you are doing the initialization in a Rails `config/initializers` file, e.g. 

`config/initializers/zipkin.rb`):

```

config = Rails.application.config

zipkin_tracer_config = {service_name: 'your service name here', service_port: 9410, sample_rate: 1, scribe_server: '127.0.0.1:9410'}

config.middleware.use ZipkinTracer::RackHandler, zipkin_tracer_config

```

In production, you'll probably want to set your `sample_rate` to something less than 1 (which equal 100% sampling); the 

literature mentions acceptable sampling rates as low as 0.01% for high-traffic servers.  The url and port of your scribe server may vary as well.

To use the Faraday middleware, simply instruct Faraday to use the middleware.  No configuration is required.  You'll probably do something like this:

```

connection = Faraday.new 'http://example.com/api' do |conn|

...

  conn.use ZipkinTracer::FaradayHandler

...

  conn.adapter Faraday.default_adapter

end

```

## Testing

```

rspec spec/

```

## Contributing

Please make a PR into the develop branch.  @ a gem owner in PR.  Please assert (with proof) in the PR that all tests pass.  Any new code you write must be accompanied by an automated test.