利用状況分析

ローカルで集計された利用履歴をグラフ化し、以下の実用的な質問に答えるのに役立ちます：どの口座が最も利用しているか、どのモデルが最もコストがかかるか、リクエストはいつ集中しているか、最近遅くなっていないか。

まず、何に依存するかを理解する

利用状況分析 はリアルタイムで生のログを取得するのではなく、ローカルに保存された 利用履歴集計データ に基づいて表示します。

そのため、初めて使用する前に、以下の場所で：

設定 → 基本設定 → 口座利用状況

利用履歴の同期を有効にし、まずデータを1回同期する必要があります。

機能概要

• 多次元フィルタリング：サイト、口座、トークン、日付範囲でフィルタリングします。
• 概要指標：リクエスト数、入力/出力トークン、総トークン、コストを表示します。
• モデル分析：モデル分布、モデルコスト分布、モデルヒートマップを表示します。
• 時間帯分析：利用時間帯のホットスポットを表示し、リクエストがどの曜日/時間帯に集中しているかを判断します。
• 遅延分析：遅延分布、遅延トレンド、遅延の多いモデルランキング、遅延の多いトークンランキングを表示します。
• エクスポート：現在のフィルタリング結果をエクスポートし、照合やさらなる処理に役立てます。

ステップ1：利用履歴の同期を有効にする

設定 → 基本設定 → 口座利用状況 に移動すると、2つのセクションが表示されます：

• 利用履歴同期設定
• 同期ステータス

設定可能な項目

自動同期方法の選択

• 手動のみ：リクエストが最も少なく、たまに分析する人に適しています。
• 口座更新後：日常的な利用に適しており、口座を更新する際にデータを蓄積します。
• Cronライク（Alarms APIが必要）：バックグラウンドで定期的に同期したい人に適しています。

ブラウザが Alarms API をサポートしていない場合、プラグインは自動的にダウングレードされ、利用できないスケジューリング方法を強制することはありません。

同期ステータス管理

「設定 → 基本設定 → アカウント使用量 → 同期ステータス」では、「ダウンロードタスク」を管理するように使用量の同期を管理できます。

• ステータス概要：どのアカウントが同期に成功し、どれが権限やネットワークの理由で失敗したかを一目で確認できます。
• 差別化された同期：特定の期間のみの同期や、特定のアカウントに対する強制同期のトリガーをサポートしています。
• ワンクリッククリーンアップ：ローカルデータが多すぎる場合や異常が発生した場合は、ワンクリックで特定のアカウントのローカル使用量キャッシュをクリアできます。
• エラー修正：同期が失敗した場合は、ステータスアイコンをクリックして、特定の API エラーの詳細（例：401 Unauthorized は管理トークンが無効であることを示します）を表示できます。

ステップ 2：利用状況分析ページに移動する

データを同期したら、設定 → 利用状況分析 を開きます。

ページに「利用履歴データがありません」と表示される場合、通常は以下のいずれかが原因です：

• まだ同期が有効になっていない
• 初回の同期がまだ行われていない
• 現在選択されている範囲内にデータがない

ページの見方

フィルタリングエリア

以下のディメンションを組み合わせてフィルタリングできます：

• サイト
• 口座
• APIトークン
• 開始日 / 終了日

いずれかの階層を選択しない場合、デフォルトで上位階層内の全データが統計されます。

概要カード

まず、現在のフィルタリング結果の主要な概要が表示されます：

• 入力トークン
• 出力トークン
• 総トークン
• リクエスト数
• コスト

「この期間にどれだけ利用したか」を素早く判断するのに適しています。

日次概要

複数の指標の日次トレンドを表示します。通常、以下が含まれます：

• リクエスト数
• 入力トークン
• 出力トークン
• 総トークン
• クォータ消費

グラフはズームや凡例の切り替えが可能で、表示範囲を狭めて観察するのに適しています。

モデル関連グラフ

モデル分布

総トークンで上位モデルを統計します。「どのモデルが最もよく使われているか」を見るのに適しています。

モデルコスト分布

クォータ消費をUSDに換算して上位モデルを統計します。「どのモデルに主にお金がかかっているか」を見るのに適しています。

モデル × 日付ヒートマップ

時間軸でモデルの利用強度を表示します。以下を見るのに適しています：

• 特定のモデルが短期間のバーストか長期的な継続利用か
• どの日に急に利用量が増えたか

モデルをクリックすると、他のグラフは可能な限りそのモデルに焦点を合わせます。

時間帯と遅延分析

利用時間帯ホットスポット

曜日 × 時間 でトークンのホットスポットをまとめます。以下を観察するのに適しています：

• リクエストが主に平日か週末に集中しているか
• ピークタイムは日中、夜間、それとも深夜か

遅延分布

単一リクエストの遅延（use_time）の分布を表示し、全体的な応答が遅くなっていないかを判断するのに役立ちます。

遅延トレンド

日次で以下を表示します：

• 平均遅延
• 最大遅延
• 遅延リクエスト数

「最近なぜか遅い」「特定の日に明らかに悪化したか」といった問題を調査するのに役立ちます。

遅延の多いモデルランキング / 遅延の多いトークンランキング

以下を素早く特定するのに役立ちます：

• どのモデルが遅延リクエストを発生させやすいか
• どのトークンが最も遅い経路に対応しているか

これは、複数のアップストリーム、複数のグループ、複数の口座がある環境で特に役立ちます。

エクスポートの用途

エクスポート をクリックすると、現在のフィルタリング範囲内の集計結果がエクスポートされます。以下に適しています：

• 請求書の照合
• アーカイブ
• チームの他のメンバーに渡してさらに分析する

現在のフィルタリング範囲にデータがない場合、空のファイルを作成する代わりに、エクスポートは直接通知を表示します。

利用のヒント

• まず範囲を絞ってから分析する：まずサイトや口座を選択し、次にモデルと遅延を見ることで、問題を見つけやすくなります。
• 高コストと高遅延を分けて見る：最も高価なものが最も遅いとは限らず、最も遅いものが最も高価なとも限りません。
• 口座利用状況設定と合わせて見る：特定の口座で長期間データがない場合は、「口座利用状況」で同期ステータスを確認してください。
• 残高の変動を見たい場合は残高履歴を見る：両者は焦点が異なるため、混同しないでください。

重要事項

• ページに表示されるのは ローカル集計履歴 であり、バックエンドの生のログ明細ではありません。
• 同期が成功し、サポートされている口座のみが有効な統計に含まれます。
• 無効化された口座は、関連する更新および同期タスクによって自動的にスキップされます。
• ブラウザが Alarms API をサポートしていない場合、定期同期機能は制限されますが、手動同期および「更新後の同期」は引き続き使用できます。

関連ドキュメント

• 残高履歴
• 自動更新とリアルタイムデータ
• データインポートエクスポート