--- title: "使用量" description: "プロジェクト内の全推論リクエストのリクエスト数・トークン内訳・レイテンシ。" --- `arkor.ai///usage` は、プロジェクトを通る chat completion を集計します。エンドポイントのトラフィックも、Playground のメッセージも、CLI からの呼び出しも同様です。1 リクエストが 1 行で、リクエスト完了時に記録されます。行が記録されるのは、入口でのバリデーション・認証・クォータチェックを通過したリクエストだけです。ディスパッチ前に拒否された試行（不正な API キー、不正なボディ、Arkor 側クォータの `429`）は行を生まないため、エンドポイントが受けたすべての呼び出しの記録ではありません。一方、ディスパッチ**後**に失敗したリクエストはカウントされます。外部プロバイダがベンダ側の `429`/`529` で拒否したリクエストや、生成途中で失敗したリクエストは failed 行として現れます。 ![サマリータイル・日次チャート・モデル内訳が表示された使用量ダッシュボード](/images/cloud/usage-light.png "www.arkor.ai/oddphin-org/support-bot/usage") ![サマリータイル・日次チャート・モデル内訳が表示された使用量ダッシュボード](/images/cloud/usage-dark.png "www.arkor.ai/oddphin-org/support-bot/usage") ## サマリータイル - **リクエスト数**は、選択した期間内の合計です。 - **トークン**は、入力・出力・推論（reasoning）の重複のない 3 分割です。出力は可視の補完トークンのみをカウントし、推論トークンは分離されます。 - **平均 TTFT** は、プロバイダディスパッチ起点の初トークンまでの時間です。Arkor がリクエストを最初に受け取った時点からのエンドツーエンド値も併記されます。 - **平均合計**は生成全体の時間です。同じく 2 つの測定値があります。 ## 日次チャート 期間内の日別バーチャート。リクエスト数と積み上げトークン内訳を切り替えられます。日付はリクエスト到着時刻の UTC バケットです。 ## 内訳テーブル グループ化の軸は次のとおりです。 | 軸 | 意味 | | --------- | ------- | | `model` | 配信されたベースモデル | | `deployment` | トラフィックを受けたエンドポイント | | `user` | リクエストした Cloud / CLI アカウント | | `endUser` | あなたの `X-Arkor-End-User-Id` ヘッダの値 | | `session` | あなたの `X-Arkor-Session-Id` ヘッダの値 | `endUser` と `session` はカーディナリティが高いため 31 日間のウィンドウに制限されます。90 日プリセットでは Cloud はモデル内訳へフォールバックし、その旨を表示します。 ## フィルタ - **期間プリセット**は 24h・7d・30d・90d（UTC）です。 - **エンドポイントフィルタ**は、すべてのタイル・チャート・内訳を 1 つのエンドポイントに絞り込みます。 ## トラフィックを自アプリのユーザーに紐付ける `endUser` / `session` 軸を活用するには、API 呼び出しにアトリビューションヘッダを付けてください。自由形式のラベルで 256 文字まで、認可には一切影響しません。[アトリビューションヘッダ](/ja/docs/cloud/chat-completions#アトリビューションヘッダ)を参照してください。