Claude Codeがいま何してた？を OTelで観測する！

ClaudeCode を OTel を使って改善していったネタを共有した際のLTスライドです！

Transcript

1. Claude Codeがいま何してた？を OTelで観測する！（したい！） atWare Collaboration Canvas Vol.5 AIゆるLT大会 2026/05/28 川瀬 雄也
2. 自己紹介 川瀨 雄也（かわせ ゆうや） 普段はSIerで、基盤系エンジニアとして過ごしています 社会人歴：7年目
3. こんなこと、ないですか！？ ClaudeCodeは早くてすごい
4. こんなこと、ないですか！？ ClaudeCodeは早くてすごい けど、実際どう動いて何をしていたのかわかりにくい・・ ・・・ わたし or or ？
5. どのくらい凄くてどのくらい早い？ ということで今回は、 どこで時間をかけたのか、いつツールを読んだのか、 などなどを出力してもらいます！ わたし ！
6. AI Agentを見るなら「OTel」で！ OTelとは、アプリが出すテレメトリデータを 標準形式で集めるOSSの規格で、 最近はAI Agentの文脈でよく言及され（る気がし） ます！ わたし ！
7. ClaudeCodeもOTel出力します 環境変数をセットするだけの簡単セットアップ！ 公式docs Qiitaブログ
8. ClaudeCodeのOTelで分かること 種類 分かること 向いている用途 Metrics 数値の集計 tokenやコスト、セッション数や所要時 間の集計 Logs / Events 起きた出来事 APIリクエスト、tool実行、hookなどの 呼び出し履歴・エラー有無確認 Traces / Spans ※ 現状はβ版 1つの依頼の処理の流れ どの順で処理が動いたかの確認 (Sub)Agentの動きなど どの順でどう動いて、何秒(いくら)かかったかが良く分かる
9. でもそれ、DEBUGで良くない？ 嬉しさは被りますが、「継続監視・改善ならOTel」派です！ 「MCPが効かない・hookが効か ない」などの その場・その回で狙い通り動かす トラシューに効く DEBUGが嬉しい 「複数Agentに任せたけど、結局どこで時間 が溶けたの？」など 時系列で構造化して観測することで 継続的な監視・改善に効く OTel が嬉しい
10. でもそれ、DEBUGで良くない？ 嬉しさは被りますが、「継続監視・改善ならOTel」派です！ 「MCPが効かない・hookが効か ない」などの その場・その回で狙い通り動かす トラシューに効く DEBUGが嬉しい 「複数Agentに任せたけど、結局どこで時間 が溶けたの？」など 時系列で構造化して観測することで 継続的な監視・改善に効く OTel が嬉しい Agent連携などの処理の全体像を見たいなら OTel、 壊れた(動かない)理由を深掘りするなら DEBUG かな～と考えています(私見)
11. OTelで分かるうれしさ 例① 遅いと思ったら、 私が止めていただけでした・・・・（あるある） みたいなケースが可視化されます！
12. OTelで分かるうれしさ 例① 遅いと思ったら、 私が止めていただけでした・・・・（あるある） みたいなケースが可視化されます！ ⇒ 権限承認待ちで時間を使っていたなら、 通知を取り入れて改善しましょう！
13. OTelで分かるうれしさ 例② キャッシュ効率まるわかり！ 無駄にMCP(Skillも..)を入れると、 無駄にキャッシュも使う。。
14. OTelで分かるうれしさ 例② キャッシュ効率まるわかり！ 無駄にMCP(Skillも..)を入れると、 無駄にキャッシュも使う。。 「ドカドカ積めばいい」 ってもんじゃない・・
15. だが・・分析を自分でしたくない！ OTelを自分で分析したくない方へ！（わたし） わたし
16. OTel をファイルに出力させて、 Skillを定義して ClaudeCodeに自己分析させましょう！ わたし ！ だが・・分析を自分でしたくない！
17. ご参考 ローカルにファイルでOTel出力させて、 分析する（してもらう）記事もQiitaにあります！
18. まとめ 観測できれば、次に活かせる！ OTel を活かして、 “オレだけの最強のClaude定義” を作りましょう！(作りたい！)