トークン使用量ダッシュボード
v0.157.0 以降。 トークン使用量ダッシュボードでは、このサーバーが記録したトークンを チャートと表で確認できます。読み出す台帳は 使用量統計 API と同じです。
開き方
サイドバー下部の Ontology アイコンの右にある チャートアイコン をクリックします。 Cron スケジューラと同じ構成の大きなウィンドウで開きます。
- 左側: 期間、レーンの絞り込み、ビューの一覧
- 右側: 集計値と、選んだビューのチャート・表
- ヘッダー: タイムゾーン、Export CSV、「What these numbers cover」（数値の対象範囲）
ダッシュボードは読み取り専用です。チャットや使用量の記録は変更しません。
タイムゾーン
日と月の区切りは、ヘッダーに表示されたタイムゾーンに従います。既定はブラウザの タイムゾーンで、(browser) と表示されます。クリックすると別のタイムゾーンを選べます。 Browser を選ぶとブラウ ザのタイムゾーンに戻ります。選択はこのブラウザにだけ保存されます。
タイムゾーンを変えると、1日の始まりが変わります。たとえば同じレコードでも、東京では 9月1日、ホノルルでは8月31日になることがあります。どのタイムゾーンで表示しているかは 常にフッターに表示されます。
期間とレーン
- 期間: 7日、30日、90日、今月、先月、12か月、Custom（最大366日）から選びます。 「今日」は選択中のタイムゾーンでの今日です。
- レーン: すべての数値を、次のいずれかの呼び出し元に絞り込みます。
- チャット（
spa-prompt、spa-harness） - 宣言的ワークフローの実行（
workflow）とパイプラインジョブ（workflow-job） - Teams（
teams） - OpenAI 互換 API（
openai-api） - Live 会話から始まったエージェントの作業（
live、v0.169.0 以降） - AI 討議（
discussion、v0.198.0 以降） - バックグラウンド処理（
helper）
- チャット（
集計値
| カード | 内容 |
|---|---|
| Input | 非キ ャッシュ入力 + キャッシュ読み出し + キャッシュ書き込み。それぞれの内訳も表示 |
| Output | 出力トークン。そのうちの 推論 トークンを「うち数」として表示 |
| Model calls | 課金対象のモデル呼び出し回数、1回あたりの平均トークン数、レコード数 |
| Cache hit rate | 入力全体に占めるキャッシュ読み出しの割合。キャッシュ値を報告するモデルだけで計算 |
| Error / interrupted | エラーで終わった、または停止されたターンのレコードの割合 |
プロバイダーごとに数え方が違うため、「総トークン数」の1つの数値は表示しません。 入力と出力は常に分けて表示します。
ビュー
| ビュー | 内容 |
|---|---|
| Overview | 種類別の日次トークンと、上位5モデル・上位5 Run-target |
| Daily | 1日1本の棒グラフ。トークン種類・モデル・レーン別に積み上げ。日別の表 |
| Monthly | 1か月1本の棒グラフ（積み上げ方は同じ）。前月比つきの表 |
| By type | レーン、Run-target（Harness エージェント・ワークフロー）、ワークフローのエージェント・ノード、レコード種別ごとのランキング |
| By model | モデルごとのトークン種類の内訳と、プロバイダー・キャッシュヒット率・1回あたりのトークン数・エラー率 |
| Sessions | 消費が多いチャットの一覧（タイトル付き） |
| Live voice | Live 会話の時間を日別・チャット別に表示（セッション数と委譲したタスク数つき、v0.169.0）。トークンではなく秒数で、料金計算は行いません |
表は列見出しをクリックすると並べ替えられます。
チャートの見方
- 色は固定です:
- 青: 非キャッシュ入力
- 青緑: キャッシュ読み出し
- 黄: キャッシュ書き込み
- 紫: 出力
- 推論トークンは出力の内数 なので、出力の上には積み上げません。
--は「報告されていない」という意味です。 すべての数値を報告しないプロバイダーも あります。報告されていない数値は--と表示し、チャートには描きません。0 としては 表示しません。- 利用がなかった日は 0 です。 何も実行されていないので、消費もありません。
- モデル別・レーン別に積み上げたときは、上位5件を表示し、残りは Other にまとめます。
Sessions からチャットを開く
Sessions ビューは、消費したトークンの多い順にチャットを1ページ50件で表示します。 次の行は開けません。
| 行 | 理由 |
|---|---|
| Deleted or re-imported chat | その ID のチャットがもう存在しません。使用量は集計に残ります |
| Temporary chats | 一時チャットは ID なしで記録されるため、1行にまとめて表示します |
| No chat (jobs, API, Teams) | このアプリのチャット以外からの使用量です |
チャットを開く手順:
- その行の Open をクリックします。ダッシュボードはまず、そのチャットがまだ存在するかを確認します。
- 確認ダイアログで確定します。ダッシュボードが閉じ、チャットが開きます。
確認の間にチャットが削除されていた場合は、遷移せずにその行が Deleted に変わります。
Export CSV
Export CSV は、選択中の期間・タイムゾーン・レーンに含まれる使用量レコードをすべて
ダウンロードします。表示中の表ではなく生レコードを出力するので、Excel や Power BI
などで利用できます。ファイル名は token-usage_2026-09-01_2026-09-30_Asia-Tokyo.csv
のようになります。列の構成は
BI 向けのエクスポート
を参照してください。
表示しないもの
- 金額。 表示するのはトークン数だけです。単価は契約内容や時期によって変わるため、 ご自身の単価を掛けて計算してください。
- デモモードの使用量。 デモモードでは何も記録されないため、ダッシュボードは空になります。
- ユーザー別の数値。 使用量の記録にはユーザーを識別する情報がありません。