Sha256: 2f616288fab7f87f17396485d551fa649724628dccd69939c6db93c7825676e3

Contents?: true

Size: 1.32 KB

Versions: 10

Compression:

Stored size: 1.32 KB

Contents

Request Tracer
==============
[![Build Status](https://travis-ci.org/crealytics/request-tracer.svg)](https://travis-ci.org/crealytics/request-tracer)

Request Tracer is a Ruby gem that helps tracing requests through a chain of services.
It is based on [ZipkinTracer](https://github.com/openzipkin/zipkin-tracer) but doesn't force you to use Zipkin.

One possible use case is to use your logger to log traces and spans and reuse your
existing log aggregation tool of choice (e.g. ELK) to get all logs across all services
that were involved in a client's service call.

How it works
------------
Request Tracer integrates with various other gems in order to transparently
read incoming trace headers and add trace headers to outgoing service calls.
A good introduction into Zipkin terminology [can be found here](http://www.slideshare.net/johanoskarsson/zipkin-strangeloop/25).

Reading trace headers
---------------------
In your `config.ru` add the RackHandler middleware like this:
```ruby
require 'request_tracer'
require 'request_tracer/integration/rack_handler'

use RequestTracer::Integration::RackHandler
run MyApp.new
```

Writing trace headers
---------------------
Somewhere in your code (e.g. in an initializer under `config/initializers/request-tracing.rb`)
add the following call:
```ruby
RequestTracer.integrate_with(:rest_client)
```

Version data entries

10 entries across 10 versions & 1 rubygems

Version Path
request-tracer-0.6.4 README.md
request-tracer-0.6.3 README.md
request-tracer-0.6.2 README.md
request-tracer-0.6.1 README.md
request-tracer-0.5.8 README.md
request-tracer-0.5.6 README.md
request-tracer-0.5.5 README.md
request-tracer-0.5.4 README.md
request-tracer-0.5.3 README.md
request-tracer-0.5.2 README.md