當最終響應是來源於一系列微服務時，將請求的生命週期串聯起來就是一件比較困難的事情。
然而，分散式鏈路追蹤通過將微服務之間的鏈路串聯可以讓這件事變得簡單。本文我將展示如何通過OpenTracing(提供平臺無關的API)和Jaeger(開源分散式追蹤系統)將分散式鏈路追蹤應用到你的Sinatra專案中。

OpenTracing，一套平臺無關的追蹤API

OpenTracing，一個平臺無關的分散式鏈路追蹤開放標準。OpenTracing解決了不同的分散式系統API不相容的問題：如果通過OpenTracing API追蹤方法呼叫，就可以輕易的替換追蹤平臺。

現在有很多服務可以處理OpenTracing生成的交易追蹤記錄， 在本章中我們將從兩個Sinatra專案收集資訊， 並通過

準備工作

本文將用到以下元件：

• Jaeger All-in-one Docker映象：用於本地檢視分散式追蹤
• 兩個Sinatra示例應用
• Gem rack-tracer：追蹤發向Sinatra應用的請求，我使用的版本是0.3.0。
• Gem jaeger-client：Jaeger OpenTracing追蹤器，用來將追蹤資訊傳送到Jaeger收集器。我使用的版本是0.4.1。

安裝Jaeger All-in-one

Jaeger All-in-one Docker映象專門用於本地的快速測試驗證。它包含了Jaeger UI，收集器，query和agent，以及一個基於記憶體的儲存元件。安裝在Sinatra專案中的

你可以通過以下命令安裝並執行Jaeger All-in-one（前提是你的機器上已經安裝了Docker）

docker run -d -e COLLECTOR_ZIPKIN_HTTP_PORT=9411 -p5775:5775/udp -p6831:6831/udp -p6832:6832/udp \
  -p5778:5778 -p16686:16686 -p14268:14268 -p9411:9411 jaegertracing/all-in-one:latest
 

訪問Web UI http://localhost:16686來驗證安裝是否成功。現在Jaeger已經在運行了，讓我們來啟動第一個Sinatra應用吧。

Sinatra App No. 1: “Hello”

該示例應用在訪問http://localhost:4567時簡單的返回"Hello"，OpenTracing相關的部分已經加在了下面程式碼中：

# File name:  hello.rb
# To run: ruby hello.rb
require 'sinatra'

require 'opentracing'
require 'jaeger/client'
require 'rack/tracer'

OpenTracing.global_tracer = Jaeger::Client.build(service_name: 'hello')

use Rack::Tracer

get '/' do
  'Hello'
end

在同層級新增Gemfile

# Gemfile
source 'https://rubygems.org'

gem 'sinatra'
gem 'rack-tracer'
gem 'jaeger-client'

執行bundle安裝gem成功之後啟動應用：ruby hello.rb。

收集第一條鏈路資訊

Sinatra App No. 2: “Hello World”

該應用會向前一個"Hello"應用傳送請求。通過OpenTracing的魔力，我們可以看到請求從父應用（Hello World）到微服務應用（Hello）完整的生命週期。

以下是第二個應用的程式碼：

# File Name: hello_world.rb
# To run: ruby hello_world.rb -p 4570
require 'sinatra'

require 'opentracing'
require 'jaeger/client'
require 'rack/tracer'

OpenTracing.global_tracer = Jaeger::Client.build(service_name: 'hello-world')

use Rack::Tracer

get '/' do
  "#{hello} world"
end

def hello
  client = Net::HTTP.new("localhost",4567)
  req = Net::HTTP::Get.new("/")
  OpenTracing.inject(env['rack.span'].context, OpenTracing::FORMAT_RACK, req)
  client.request(req).body
end

以4570埠ruby hello_world.rb -p4570啟動應用。

分散式鏈路追蹤是如何工作的？

“Hello World”應用返回了"Hello"應用中的資訊。OpenTracing是怎麼抓取到這個請求的整個生命過程的呢？
OpenTracing為tracing across process boundaries定義了一項標準，該標準包含兩部分：

• Tracer#inject：將SpanContext注入到我們從"Hello World"發出請求的請求頭中。
• Tracer#extract：在"Hello" 中抽取出請求頭中的SpanContext。

在上面程式碼中可以看到，我們在請求傳送到"Hello"應用之前手動將SpanContext注入到了請求頭：

OpenTracing.inject(env['rack.span'].context, OpenTracing::FORMAT_RACK, req)

總結

短短几步， 我們藉助於OpenTracing將平臺無關的分散式追蹤應用到了我們的ruby專案中來。可以通過Jaeger檢視追蹤。如果除了Jaeger你有其他喜歡的追蹤系統，也可以通過在Sinatra應用的修改一行程式碼來快速的替換。