Upgrade to Pro — share decks privately, control downloads, hide ads and more …

ActiveSupport::Notifications supporting instrum...

Y.Matsuda
November 08, 2024

ActiveSupport::Notifications supporting instrumentation of Rails apps with OpenTelemetry

Y.Matsuda

November 08, 2024
Tweet

More Decks by Y.Matsuda

Other Decks in Programming

Transcript

  1. どちらも計装のためのライブラリ • Ruby SDK(opentelemetry-ruby) ◦ トレース設定(出力先やサービス名の設定など) ◦ 手動でスパンを出力したい場合に利用 • 計装ライブラリ

    (opentelemetry-ruby-contrib/instrumentation) ◦ Gemに合わせたスパンを自動で出力してくれる ◦ たくさんあります(faraday, grape, mongo, pg, …) 14
  2. どちらも計装のためのライブラリ • Ruby SDK(opentelemetry-ruby) ◦ トレース設定(出力先やサービス名の設定など) ◦ 手動でスパンを出力したい場合に利用 • 計装ライブラリ

    (opentelemetry-ruby-contrib/instrumentation) ◦ Gemに合わせたスパンを自動で出力してくれる ◦ たくさんあります(faraday, grape, mongo, pg, …) 15 今日のテーマ
  3. セットアップはこれだけ OpenTelemetry::SDK.configure do |c| # サービス名や出力先などの初期設定は省略 c.use 'OpenTelemetry::Instrumentation::ActionMailer' end 20

    • これだけで勝手にスパンが出始める ◦ OpenTelemetry::SDK.configure ◦ ブロック内でConfigurator#use 何が起こっている?
  4. • Railsのイベントを ActiveSupport::Notificationsでsubscribe • 独自のSubscription Handlerを利用 ◦ イベントのstart, finishでスパンの生成とattributeセット •

    Configuratorでuseしたinstrumentation libraryのinstall実行 ◦ hook時の処理(transform_payloadなど)を設定し有効化 Railsの計装ライブラリの実装ざっくりまとめ 27 Railsの仕組みに上手く乗っかっているこ とがわかりました!
  5. まとめ 33 • OpenTelemetryの計装で利用するライブラリ ◦ Ruby SDK:トレース設定、手動計装 ◦ 計装ライブラリ:Gem毎の自動計装 •

    Railsの計装ライブラリ ◦ 多くはActiveSupport::Notificationsを利用 ◦ モンキーパッチも一部あるけど、危ないので ActiveSupport::Notificationsを利用する流れへ
  6. 参考 35 • Ruby on Rails API • OpenTelemetry 公式ドキュメント

    • Github - rails v7.2.2 • Github - opentelemetry-ruby • Github - opentelemetry-ruby-contrib ※スライド内に直接出典を記載したものを除く