OTel Native な自作 CLI ツールを作ってみないか？/Why Not Build Your Own OTel-Native CLI Tool?

gotanda.sre#1 の登壇資料です。

https://gotanda-sre.connpass.com/event/402441/

Transcript

1. OTel Native な自作 CLI ツールを作ってみないか？ 2026/09/18 gotanda.sre#1 Masaki Sugimoto
2. はじめに 自己紹介 名前 Masaki Sugimoto 所属 株式会社ヘンリー 現在のロール レセコン一体型電子カルテ「Henry」のレセコン側の SWE 過去の経歴 Yahoo!オークション・Yahoo!フリマの SWE → SRE オブザーバビリティまわりでいろいろやっています opentelemetry-kotlin approver（opentelemetry-kotlin の approve 権限保持者） OpenTelemetry docs-ja-approver（日本語ドキュメントのレビュー権限保持者） Mackerel アンバサダー 技術サークル「天体可観測」で同人誌執筆 Observability Conference Tokyo 2025（O11y Con Tokyo）実行委員 1
3. はじめに 発表概要 OTel Native とは？ 個人的な OTel Native な自作 CLI ツールに対する思い 技術書典 21 に向けて鋭意製作中な同人誌の紹介 2
4. OTel Native とは？ まずはじめに（1/3） 「OTel Native」という言葉を知っている人？ 3
5. OTel Native とは？ まずはじめに（2/3） 「OTel Native」という言葉を知っている人？ ピンとくる人！ 4
6. OTel Native とは？ まずはじめに（3/3） 「OTel Native」という言葉を知っている人？ ピンとくる人！ 5
7. OTel Native とは？ Natively Instrumented はあるけどね。。。（1/2） Natively Instrumented の意味 （ざっくり）後付けの計装を必要とせずに OpenTelemetry のテレメトリーデ ータを送信できる状態のことを指す（参考： Natively Instrumented） Use of "OTel native" or "native" referring to OpenTelemetryで名前につい て議論があったけど、ちゃんとした結論がでなかった 具体例 Natively Instrumented である Claude Code Deno Natively Instrumented ではない otel-chi、otel-echo、Spring Boot Instrumentation（ライブラリ計装） 6
8. OTel Native とは？ Natively Instrumented はあるけどね。。。（2/2） Natively Instrumented の意味 （ざっくり）後付けの計装を必要とせずに OpenTelemetry のテレメトリーデ ータを送信できる状態のことを指す（参考： Natively Instrumented） Use of "OTel native" or "native" referring to OpenTelemetryで名前につい て議論があったけど、ちゃんとした結論がでなかった 具体例 Natively Instrumented である Claude Code Deno Natively Instrumented ではない otel-chi、otel-echo、Spring Boot Instrumentation（ライブラリ計装） 7
9. 個人的な OTel Native な CLI ツールに対する思い 自作 CLI ツール✖︎OTel Native はいいぞ （多分...） 8
10. 個人的な OTel Native な CLI ツールに対する思い なんでわざわざ OTel Native な CLI ツールを作るの？（1/2） 背景 オブザーバビリティの考え方に共感した！でも、どこで実践する？ 業務のインフラや監視は、個人のアイディアで手を加えにくい Web アプリは作るのに時間がかかる、リクエストが来ない AI で自作ツールを作りやすくなった時代 誰でも自分だけの隙間家具・箱庭を作りやすくなった モチベーション 自作 CLI ツール（箱庭）を育てながらオブザーバビリティを学ぶ 手動計装で、Provider の作り方や Span の切り方を学ぶ。ボトルネックが見つかる 自作ツールを運用してみる 作りやすくなった（Dev）から運用（Ops）が大事 自分だけの箱庭なので、機能を追加・削除しても誰も困らず、自分の満足度を高められる 9
11. 個人的な OTel Native な CLI ツールに対する思い なんでわざわざ OTel Native な CLI ツールを作るの？（2/2） 背景 オブザーバビリティの考え方に共感した！でも、どこで実践する？ 業務のインフラや監視は、個人のアイディアで手を加えにくい Web アプリは作るのに時間がかかる、リクエストが来ない AI で自作ツールを作りやすくなった時代 誰でも自分だけの隙間家具・箱庭を作りやすくなった でもどうやって作るの モチベーション 自作 CLI ツール（箱庭）を育てながらオブザーバビリティを学ぶ 手動計装で、Provider の作り方や Span の切り方を学ぶ。ボトルネックが見つかる 自作ツールを運用してみる 作りやすくなった（Dev）から運用（Ops）が大事 自分だけの箱庭なので、機能を追加・削除しても誰も困らず、自分の満足度を高められる 10
12. 技術書典 21 に向けて鋭意製作中な同人誌の紹介 OTel Native な自作 CLI ツールを作る本を作っています 写経しながら CLI ツールを完成させる、60 ページぐらいの本（表紙は仮） 11
13. 技術書典 21 に向けて鋭意製作中な同人誌の紹介 内容（これから増えるかも） 技術スタック Go kong（コマンドパーサー） opentelemetry-go jaeger OSS としての非機能要件 mise.lock を利用したサプライチェーン攻撃への対策 goreleaser によるリリース Release の Assets をイミュータブルに 12
14. 技術書典 21 に向けて鋭意製作中な同人誌の紹介 こんな感じで、jaeger で可視化しよう 13
15. まとめ Natively Instrumented を OTel Native と呼んでいました 後付けの計装が不要で OpenTelemetry のテレメトリーデータを送信できる OTel Native × 自作 CLI ツールはいいぞ 箱庭を運用しつつ、オブザーバビリティを学んでみよう 技術書典 21 に向けて本を作っています OTel Native な自作 CLI ツールを写経で書ける本 14
16. 参考 個人的に影響をうけたブログ・資料 CLIを書いてるなら、まずOTLPでtracesと eventsを吐けるようにするのがオススメ コードを書く隙間を見つけて生きていく技 術/Findy 思考の現在地 15