ゆるふわ分散トレースはじめました / start casual distributed trace

Slide 1

Slide 1 text

Slide 2

Slide 2 text

© 2012-2019 BASE, Inc. © 2012-2020 BASE, Inc. 自己紹介 2 ● 清水陽一郎 @budougumi0617 ● BASE BANK, Inc. Dev Division ○ Go/PHP/Python/AWS etc... ● コミュニティ: golang.tokyo / Go Conference etc... ● 趣味: ボルダリング/毎週ブログを書くこと ○ https://budougumi0617.github.io/ Go Conferenece

Slide 3

Slide 3 text

Slide 4

Slide 4 text

Slide 5

Slide 5 text

Slide 6

Slide 6 text

Slide 7

Slide 7 text

Slide 8

Slide 8 text

Slide 9

Slide 9 text

Slide 10

Slide 10 text

Slide 11

Slide 11 text

Slide 12

Slide 12 text

© 2012-2019 BASE, Inc. © 2012-2020 BASE, Inc. ● MicroservicesのObservabilityに関するパターンのひとつ ● 個々の外部リクエストに一意なIDを与え、そのリクエストがサービス間をどのようにやり取りされたのか可視化、解析する 12 分散トレース（Distributed tracing pattern） Image from https://www.jaegertracing.io/docs/1.17/architecture/

Slide 13

Slide 13 text

© 2012-2019 BASE, Inc. © 2012-2020 BASE, Inc. ● Pattern: Distributed tracing ○ https://microservices.io/patterns/observability/distribute d-tracing.html ● W3C Trace context ○ https://www.w3.org/TR/trace-context/ 13 分散トレース（Distributed tracing pattern）

Slide 14

Slide 14 text

© 2012-2019 BASE, Inc. © 2012-2020 BASE, Inc. ● SaaSを使う ○ New Relic, Datadog etc ● OSSを組み合わせる ○ OpenTelemetry/OpenCensus, Jeager, Istio etc ● クラウドベンダーの仕組みに乗っかる ○ AWS X-Ray, GCP Cloud trace etc ● それなりに仰々しい追加・変更が必要になる 14 分散トレースの実現方法

Slide 15

Slide 15 text

Slide 16

Slide 16 text

© 2012-2019 BASE, Inc. © 2012-2020 BASE, Inc. ● （現時点では）そこまで困っていなかった ○ 1ヶ月に1回あると楽だなと思うくらい ○ パフォーマンス面でとくに問題ない ● 他のOKRタスクの片手間でやれるくらいでやりたかった ○ 追加コストを払ってまではやりたくない ○ インフラ構成の追加・変更してまでやりたくない ○ 正式に導入するときに容易に廃棄可能であってほしい 16 そんなにガッツリやりたくなかった

Slide 17

Slide 17 text

Slide 18

Slide 18 text

Slide 19

Slide 19 text

Slide 20

Slide 20 text

Slide 21

Slide 21 text

© 2012-2019 BASE, Inc. © 2012-2020 BASE, Inc. 21 ログやエラーにリクエストIDを伝播させる ● 操作の起点でリクエストIDを生成する ○ PHPからGoに送信するリクエストにリクエストIDを付与 ● GoはPHPからもらったリクエストIDをPythonに送信する ● Go/Pythonサービス内でリクエストIDを伝播するようにする ● ログやエラーレポートにリクエストIDをいれる

Slide 22

Slide 22 text

Slide 23

Slide 23 text

© 2012-2019 BASE, Inc. © 2012-2020 BASE, Inc. ● BANKのサービスはレイヤードアーキテクチャ構成になっている ○ GoでのAPI開発現場のアーキテクチャ実装事例（Pythonもほぼ同じ） ■ https://speakerdeck.com/hgsgtk/go-api-architecture-practical-example 23 レイヤードアーキテクチャ内でリクエストIDを使う

Slide 24

Slide 24 text

Slide 25

Slide 25 text

Slide 26

Slide 26 text

© 2012-2019 BASE, Inc. © 2012-2020 BASE, Inc. 26 Context pattern ● 特定の条件下に閉じた情報を透過的にやりとりするパターン ○ Go(1.7~)やPython(3.7~)で標準で提供されている ■ https://golang.org/pkg/context/ ■ https://docs.python.org/ja/3/library/contextvars.html ○ J2EE、AndroidやWPF（C#）でもあるパターン ■ https://docs.oracle.com/javase/jp/8/docs/api/org/omg/CORBA/Context.html ■ https://developer.android.com/reference/android/content/Context.html ■ https://docs.microsoft.com/ja-jp/dotnet/api/system.windows.frameworkelement.datacontext ○ Stateパターンと似ているが、「状態」だけではない

Slide 27

Slide 27 text

Slide 28

Slide 28 text

© 2012-2019 BASE, Inc. © 2012-2020 BASE, Inc. ● 透過的に値をやり取りするときにつかう ○ キャンセルやタイムアウトを伝播させるときにも使われる ● 関数やメソッドの第一引数にcontext.Contextを含める ○ [Go] context.TODO()を使って漸進的にcontext対応を始める ■ https://budougumi0617.github.io/2020/02/21/use-context/ 28 GoでContextを使う

Slide 29

Slide 29 text

Slide 30

Slide 30 text

Slide 31

Slide 31 text

Slide 32

Slide 32 text

Slide 33

Slide 33 text

© 2012-2019 BASE, Inc. © 2012-2020 BASE, Inc. ● Middleware（ハンドラーに対する共通の前処理）でcontextにリクエストIDを注入しておく ○ [Python] aiohttpでリクエストスコープのコンテキスト情報を扱う ■ https://budougumi0617.github.io/2020/04/08/python-use-context-var-in-aiohttp/ 33 Python（aiohttp）でContextを使う

Slide 34

Slide 34 text

Slide 35

Slide 35 text

Slide 36

Slide 36 text

© 2012-2019 BASE, Inc. © 2012-2020 BASE, Inc. ● アクセスログにもリクエストIDを付与する ○ [Python] aiohttpで独自形式のアクセスログを出力する ■ https://budougumi0617.github.io/2020/04/11/python-access-log-in-aiohttp/ 36 Python（aiohttp）でContextを使う