リクエストログ
Request Logs はすべての API 呼び出しを記録しており、費用の照合、失敗したリクエストの調査、ある呼び出しで実際にどのモデルとプロバイダーが使われたかの確認に使用します。
メンバーは自分の利用ログのみを閲覧でき、管理者は現在の組織に属する全員のログを閲覧できます。 どちらの入口に表示されるのもモデルの呼び出し記録で、違いは閲覧できるデータの範囲だけです。管理者権限があっても、ほかの組織のログが現在の組織の一覧に表示されることはありません。
| 入口 | 閲覧範囲 | 主な用途 |
|---|---|---|
| メンバー側の Request Logs | 現在ログインしているメンバー自身の呼び出し記録 | 個人の費用、キーの使用量、呼び出し失敗の原因を確認します |
| 管理者側の Analytics → Request Logs | 現在の組織に属する全メンバーの呼び出し記録 | メンバーからの問い合わせの調査、組織の費用の照合、実際のプロバイダーとリクエストの特定 |
呼び出しの終了後、記録が一覧に表示されるまで約 2 分かかります。発行したばかりのリクエストがすぐに表示されない場合は、しばらく待ってから再読み込みしてください。
ログを探す
ページ上部の条件バーには現在適用されているフィルター条件が表示され、既定では直近 7 日間のみが対象です。メンバーのビューでは、自動的に本人の記録に限定されます。
一覧の下部では、1 ページあたりの表示行数を変更したり、ページを切り替えたりできます。一覧には直近 30 日間の記録のみが保持されます。それより前の呼び出しを確認したい場合は、下部の History data をクリックしてください。
管理者のリクエストログ
管理者のリクエストログはメンバーのリクエストログと同じ機能で、一覧の項目と明細はまったく同じです（下記参照）。違いは閲覧できる範囲が広いことだけです。管理者はロールを切り替えた後、Analytics → Request Logs から現在の組織に属する全メンバーの呼び出しを確認できます。
- メンバーでフィルターする：条件バーでメンバーを選択し、さらに期間、API Key、モデル、プロバイダーと組み合わせて範囲を絞り込みます。
- メンバーからの問い合わせに対応する：まず発生日時とメンバーを確認し、対応する API Key または Request ID を見つけてから、記録を展開して実際に使われたモデル、プロバイダー、所要時間、Token 使用量、課金プロセスを確認します。
- 費用を照合する：費用に関する問い合わせの場合は、そのメンバーのクォータと残高と、API Keys の管理にあるキーのクォータを合わせて確認します。組織全体のトレンドとランキングはダッシュボードと分析を参照してください。
リクエストログにはモデルの呼び出しとその使用量のみが記録されます。プロバイダー、料金、権限などの設定を誰が変更したかは、対応する管理ページの 操作監査 で確認してください。
ログ一覧の見方
| 列 | 意味 |
|---|---|
| Created time | この呼び出しが発生した日時 |
| Provider | この呼び出しを実際に処理したアップストリームのプロバイダー |
| User | 呼び出しを行ったアカウント |
| API key | この呼び出しで使用した API Key の名前 |
| Group Pricing | この呼び出しに適用されたグループ料金 |
| Model | このリクエストで使用したモデル |
| Timing | この呼び出しの総所要時間と最初のトークンが返るまでの時間。ストリーミングリクエストには「streaming」タグが付きます |
| Input / output | 入力と出力の Token 数 |
| Cost | クォータ管理を使用している場合は「Subscription」と表示され、周期ごとのクォータから差し引かれたことを示します。引き換えコードでチャージしている場合は、この呼び出しの具体的な金額が表示されます |
| Details | この呼び出しに適用された料金倍率と各種料金 |
同じ時刻の複数の記録は、通常、同じアプリケーションからの連続したリクエストです。API Key とモデルを組み合わせて発生元を区別できます。
個々の呼び出しの明細を確認する
行頭の矢印をクリックして記録を展開すると、この呼び出しの完全な情報を確認できます。
| フィールド | 意味 |
|---|---|
| Provider info | この呼び出しを処理したプロバイダーの番号と名前 |
| Request ID | このリクエストの一意な識別子。問題を報告する際に提供すると、すばやく特定できます |
| Log details | この呼び出しに適用された各種料金と料金倍率の概要 |
| Cache tokens | アップストリームのモデルのプロンプトキャッシュにヒットした Token 数 |
| Cache creation tokens | アップストリームのモデルのプロンプトキャッシュに書き込まれた Token 数 |
| Billing process | 料金と計算過程を項目ごとに表示します |
| Request path | このリクエストがアクセスした API パス |
| Stream status | ストリーミングレスポンスの終了ステータス |
| Request conversion | リクエストがゲートウェイ内で経たプロトコル変換 |
| Billing mode | 費用がアップストリームから返されたものか、ゲートウェイが料金表に基づいて計算したものか |
一部のフィールドは、アップストリームで実際に使用されたモデルなど、対応する情報がある場合にのみ表示されます。
インテリジェントルーティングを有効にすると、ログのモデルはルーティング後に実際に呼び出されたモデルになり、og-auto などの仮想モデルへの呼び出しは書き換え後のモデルとして記録され、仮想モデル名は表示されません。元々指定したモデルを確認したい場合は、og-route-requested-model レスポンスヘッダーを確認するか、Request ID を管理者に伝えてルーティングモニターで調べてもらってください。 個々の呼び出しではなく、費用と使用量の全体的なトレンドを確認したい場合、メンバーは個人ダッシュボード、管理者はダッシュボードと分析を参照してください。