mcpField
O
omni-usage-logs

omni-usage-logs

github.com/cheaper-inferenceデータ・データベース82.3k1.1k 回インストール今日更新
リポジトリ

omni-usage-logs について

omni-usage-logs は、呼び出しログ、使用状況分析、関連指標を扱う認証付き OmniRoute API を提供します。運用担当者がリクエストを調べ、記録を絞り込み、使用量やレイテンシ、キャッシュの状態を分析できます。

主な機能

  1. 01呼び出しログの閲覧と絞り込み
  2. 02使用状況分析と履歴の確認
  3. 03予算とトークン上限の追跡
  4. 04レイテンシとキャッシュ指標の確認
  5. 05プロバイダーとモデル別の使用量確認

活用シーン

  1. 01プロバイダー、モデル、状態別に呼び出しを調査
  2. 02使用量と予算消費を追跡
  3. 03プロバイダーやモデル間のレイテンシを比較
  4. 04プロンプトキャッシュの状態を確認

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/cheaper-inference/omniroute --skill omni-usage-logs

インストール後、Claude Code で/omni-usage-logsを入力して読み込まれたか確認します。

詳細

概要

詳細な呼び出しログと使用状況分析にアクセスします。プロバイダー、モデル、期間、ステータス、コストで絞り込めます。ログをエクスポートし、すべての接続にわたるトークン使用量を集計できます。

認証

すべてのリクエストには、有効な Bearer トークンまたはセッション Cookie が必要です。POST /api/auth/login を使用してトークンを取得するか、ローカル開発では REQUIRE_API_KEY=false を設定してください。

エンドポイント

GET /api/usage/analytics

使用状況分析を取得します

curl http://localhost:20128/api/usage/analytics \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"
GET /api/usage/call-logs

呼び出しログを取得します

curl http://localhost:20128/api/usage/call-logs \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"
GET /api/usage/call-logs/filters

呼び出しログのフィルターオプションを取得します

呼び出しログに記録されたプロバイダー、モデル、アカウント、API キーの種類と、設定済みのすべての API キー（ID と名前のみ）を取得します。「ログ」タブのフィルタードロップダウンに使用されます。

curl http://localhost:20128/api/usage/call-logs/filters \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"
GET /api/usage/call-logs/{id}

特定の呼び出しログを取得します

curl http://localhost:20128/api/usage/call-logs/{id} \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"
GET /api/usage/{connectionId}

特定の接続の使用状況を取得します

curl http://localhost:20128/api/usage/{connectionId} \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"
GET /api/usage/history

使用状況の履歴を取得します

curl http://localhost:20128/api/usage/history \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"
GET /api/usage/logs

使用状況ログを取得します

curl http://localhost:20128/api/usage/logs \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"
GET /api/usage/proxy-logs

プロキシログを取得します

curl http://localhost:20128/api/usage/proxy-logs \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"
GET /api/usage/request-logs

リクエストログを取得します

curl http://localhost:20128/api/usage/request-logs \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"
GET /api/usage/budget

使用状況の予算ステータスを取得します

現在の予算上限と消費量を返します。

curl http://localhost:20128/api/usage/budget \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"
POST /api/usage/budget

使用状況の予算を設定します

使用状況の追跡に使用する予算上限を設定または更新します。

curl -X POST http://localhost:20128/api/usage/budget \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'
GET /api/usage/cache-health

プロンプトキャッシュの健全性サマリーを取得します

期間内の call_logs から write/read キャッシュ比率を集計します。 分布（キャッシュ書き込みトークン数の p50/p90/p99/最大値）、ウォーム／コールド／書き換え／未キャッシュの 呼び出し数、「大量書き込み」外れ値の割合（期間の中央値の 10 倍。下限は 1024 トークンで、これは Anthropic のキャッシュ作成時の最小値です）、およびモデル別の内訳を含みます。 成功した呼び出し（status = 200）のうち、キャッシュ列が null ではないものだけをカウントします。

curl http://localhost:20128/api/usage/cache-health \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"
GET /api/usage/model-latency-stats

モデル／プロバイダー別のレイテンシ統計を取得します

ローリング期間内の usage_history 行を集計し、プロバイダーとモデルの組み合わせごとのレイテンシ統計（平均／p50/p95/p99、標準偏差、TTFT、トークン数／秒）を算出します。成功サンプル数が minSamples を下回る場合は、成功したサンプルのみを対象とする集計から全サンプル行を対象とする集計に切り替えます。

curl http://localhost:20128/api/usage/model-latency-stats \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"
GET /api/usage/budget/bulk

GET 使用状況 › 予算 › 一括

curl http://localhost:20128/api/usage/budget/bulk \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"
GET /api/usage/codex-reset-credit

GET 使用状況 › Codex リセットクレジット

curl http://localhost:20128/api/usage/codex-reset-credit \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"
POST /api/usage/codex-reset-credit

POST 使用状況 › Codex リセットクレジット

curl -X POST http://localhost:20128/api/usage/codex-reset-credit \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'
GET /api/usage/combo-forecast

GET 使用状況 › コンボ予測

curl http://localhost:20128/api/usage/combo-forecast \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"
GET /api/usage/combo-health

GET 使用状況 › コンボ健全性

curl http://localhost:20128/api/usage/combo-health \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"
GET /api/usage/combo-health-autopilot

GET 使用状況 › コンボ健全性オートパイロット

curl http://localhost:20128/api/usage/combo-health-autopilot \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"
GET /api/usage/combo-health-dashboard

GET 使用状況 › コンボ健全性ダッシュボード

curl http://localhost:20128/api/usage/combo-health-dashboard \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"
GET /api/usage/combo-scoring-inspector

GET 使用状況 › コンボスコアリングインスペクター

curl http://localhost:20128/api/usage/combo-scoring-inspector \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"
GET /api/usage/combo-trace/{id}

GET 使用状況 › コンボトレース › 

curl http://localhost:20128/api/usage/combo-trace/{id} \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"
GET /api/usage/om-usage

GET 使用状況 › om 使用状況

curl http://localhost:20128/api/usage/om-usage \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"
GET /api/usage/provider-limits

GET 使用状況 › プロバイダー上限

curl http://localhost:20128/api/usage/provider-limits \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"
POST /api/usage/provider-limits

POST 使用状況 › プロバイダー上限

curl -X POST http://localhost:20128/api/usage/provider-limits \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'
GET /api/usage/provider-window-costs

GET 使用状況 › プロバイダー期間コスト

curl http://localhost:20128/api/usage/provider-window-costs \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"
GET /api/usage/quota

GET 使用状況 › クォータ

curl http://localhost:20128/api/usage/quota \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"
GET /api/usage/requests-by-provider-date

GET 使用状況 › プロバイダー／日付別リクエスト

curl http://localhost:20128/api/usage/requests-by-provider-date \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"
GET /api/usage/route-explain/{id}

GET 使用状況 › ルートの説明 › 

curl http://localhost:20128/api/usage/route-explain/{id} \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"
GET /api/usage/token-limits

GET 使用状況 › トークン上限

curl http://localhost:20128/api/usage/token-limits \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"
POST /api/usage/token-limits

POST 使用状況 › トークン上限

キーごとのトークン上限を保存します。キーにはスコープとリセット間隔ごとに 1 つの上限が設定されるため、同じスコープに対する日次、週次、月次の上限を併存させることができます。id を指定しない場合は、新しい上限が追加されます（または、同じスコープと間隔に対するキーの上限が更新されます）。id を指定した場合は、その上限が更新されます。

curl -X POST http://localhost:20128/api/usage/token-limits \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'
DELETE /api/usage/token-limits

DELETE 使用状況 › トークン上限

curl -X DELETE http://localhost:20128/api/usage/token-limits \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"
GET /api/usage/utilization

GET 使用状況 › 使用率

curl http://localhost:20128/api/usage/utilization \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"

ペイロード

リクエスト／レスポンスのスキーマの詳細については、GET /api/openapi/spec または docs/openapi.yaml にある OpenAPI 仕様の全文をご覧ください。

コメント

Markdown 対応