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

Grafana で AI 利用料を可視化 〜Claude Code のテレメトリを OpenT...

Grafana で AI 利用料を可視化 〜Claude Code のテレメトリを OpenTelemetry で集める〜 / Visualizing AI Usage Costs with Grafana: Claude Code Telemetry via OpenTelemetry

Grafana Meetup Japan Fukuoka #1
https://grafana-meetup-japan-fukuoka.connpass.com/event/399256/

Claude Code が標準で出せる OpenTelemetry のデータを集め、全社の利用量と費用の目安を Grafana で見える化した話です。金額とホスト名は伏せています。

How we collect Claude Code's built-in OpenTelemetry telemetry and visualize company-wide usage and estimated cost in Grafana. Amounts and hostnames are masked.

shiro seike PRO

September 25, 2026

Transcript

31 slides
  1. OSEKKAI × TECHNOLOGY Grafana で AI 利用料を可視化 Grafana Meetup Japan

    Fukuoka #1 2026.09.25 Fusic Co.,Ltd. 清家 史郎 (@seike460)
  2. 自己紹介 OSEKKAI × TECHNOLOG Y 清家 史郎 (@seike460) SHIRO SEIKE

    技術コミュニティ統括室長 / シニアエバンジェリスト ・AWS Ambassador ・2025-2026 Japan AWS Top Engineers — コミュニティ ・JAWS-UG 福岡 Co-Organizer / JAWS DAYS 2026 実行委員長 ・Grafana Meetup Japan Fukuoka Organizer NEW MEMBER!! iwa さん @mananyuki 2 ©Fusic Co., Ltd.
  3. Claude Code は OTLP に対応している すべて で送る は現時点では保存せず捨てている # metrics

    / logs / traces OTLP # traces CLAUDE_CODE_ENABLE_TELEMETRY=1 OTEL_METRICS_EXPORTER=otlp OTEL_LOGS_EXPORTER=otlp OTEL_TRACES_EXPORTER=otlp OTEL_EXPORTER_OTLP_ENDPOINT=https://xxx.xxx.xxx OTEL_EXPORTER_OTLP_HEADERS=Authorization=Bearer <token> OTEL_METRIC_EXPORT_INTERVAL=60000 OTEL_LOG_USER_PROMPTS=0 # prompt OTEL_LOG_TOOL_DETAILS=1 # tool ただし 本文は送らない 名は集計に使う 6 ©Fusic Co., Ltd.
  4. Claude Code を使うなら、やることはありません 管理者が1回書く 全員の PC に自動で届く Claude Code が勝手に送る

    managed settings に env 9行 組織アカウントの利用者に配布 起動時に env を読んで OTLP 送信 社員がやること Claude Code 以外も送れます 組織アカウントでログインして、普通に使うだけです。 OTLP は OpenTelemetry の共通プロトコルなので、 80名全員、設定作業なしで送信中 対応しているツールなら同じ endpoint に送れます。 別の AI ツールが増えても、受け口はそのまま使えます 7 ©Fusic Co., Ltd.
  5. なぜ CloudWatch にしたのか 払ったもの 得たもの メトリクス専用 DB は不要。 運用対象も増えない。 CloudWatch

    datasource で読める VS メトリクスは 500 種類まで。 見えるまで最大 5 分かかる。 凝った集計はできない。 切り口は最初に決めておく 技術要素 判断要素 Collector が決まった形のログを書くと、 用途は社内だけ・管理は1人。 CloudWatch が自動でメトリクスに変換します。 datasource の認証は task role で済むため、 切り口は宣言した組み合わせだけを出す設計です 「運用を増やさないこと」を最優先にしました CloudWatch datasource を育ててくれた mtanda さんに感謝! 15 ©Fusic Co., Ltd.
  6. これを構築するのが厳しい場合は Grafana Cloud を検討ください! Grafana Cloud は OTLP endpoint を持っています。

    env の向き先を変えるだけで、 同じ可視化が始められます 16 ©Fusic Co., Ltd.
  7. 送る前に、Collector で本文を消す attributes/scrub: actions: - { key: prompt, action: delete

    } - { key: response, action: delete } - { key: body, action: delete } - { key: arguments, action: delete } - { key: output, action: delete } - key: user.email pattern: '^(?P<user_name>[^@]+)@' action: extract - key: user.email action: hash prompt・response などの本文系は全部 delete。 email は @ の前だけ取り出して (extract) からハッシュ化 (hash)。 「だれが使ったか」は集計できても、会話の中身はどこにも残りません。 17 ©Fusic Co., Ltd.
  8. どの切り口で見るか、最初に決めておく コストとトークンのメトリクスに、 通りだけを出す ユーザー別・モデル別・その掛け算 宣言しないと属性の全組み合わせが出て、 上限の 種類で黙って切り捨てられる # 3 #

    ( ) # # 500 metric_declarations: - dimensions: - ["OTelLib", "user_name"] - ["OTelLib", "model"] - ["OTelLib", "user_name", "model"] metric_name_selectors: - "^claude_code\\.cost\\.usage$" - "^claude_code\\.token\\.usage$" 18 ©Fusic Co., Ltd.
  9. Skill ランキングは、このクエリで出している fields attributes.tool_parameters as p | filter tool_name =

    "Skill" and event_name = "tool_result" | parse p /"skill_name":"(?<skill_name>[^"]+)"/ | stats count(*) as invocations by skill_name | sort invocations desc | limit 20 このクエリがやっていること 実行の工夫 tool_parameters (Skill の引数 JSON) から Logs Insights をパネルから直接実行。 skill_name を取り出し、呼び出しが成功した row を開いた時だけクエリが走るので、 記録だけを数えて多い順に並べています スキャン課金を抑えられます 21 ©Fusic Co., Ltd.
  10. 平日は休日の約 5 倍 Cost / day (休日平均=1) 5.7 6 5.5

    5.2 5 4 4 3.9 3 2 1.1 1 9/12 9/13 1 0.9 0 9/14 9/15 9/16 9/17 9/18 9/19 9/12-13・9/19 は土日 働き方がそのまま出ている 23 ©Fusic Co., Ltd.
  11. トークンの 97% はキャッシュ読み Tokens by type (B) 150 143.6 棒の意味

    input は新たに送った分、output は生成分。 cache は同じコンテキストの再利用で、 120 長いセッションを続けるほど cacheRead が増えます 90 60 なぜ費用で大事か cacheRead は入力の約 10 分の 1 の単価です。 30 97% がキャッシュ読みなので、キャッシュを 3.1 0.49 0.24 cacheCreation output input 0 cacheRead 効かせる使い方で実質コストは何倍も変わります 24 ©Fusic Co., Ltd.
  12. Top 5 名で全体の 31% Cost by User Top 8 (全体の割合・%)

    8 7 6.9 6.4 6 6 5.9 5.8 5.2 5 4.7 4 4 3 2 1 0 1位 2位 3位 4位 5位 6位 7位 8位 使い方は均等ではない 活用を促す議論につながる 25 ©Fusic Co., Ltd.
  13. いま見えるのは、直近 14日分だけ logs Skill ランキングの元データはログです。 CloudWatch の retention は 14日で、それより前は遡れません。

    送り先に Loki を足せば安く長期検索できます。 月次集計なら S3 + Athena でも足ります (Loki は Grafana ファミリーのログ基盤) 26 ©Fusic Co., Ltd.
  14. あ な た の G r a f a n

    a に も 載 り ま す Point.01 env を9行貼れば、Claude Code が勝手に送り始めます Point.02 本文を消すのは Collector、配るのは managed settings。人には頼りません Point.03 自前が難しければ Grafana Cloud。endpoint を向けるだけです 30 ©Fusic Co., Ltd.

More Decks by shiro seike

Other Decks in Technology