メインコンテンツまでスキップ

利用分析

エクスプローラー、ボード、GET /api/analytics/query は、同じリクエストログを読みます。シャドウ行は合計から除外されます。ドルの合計は、コストステータスが priced、cache_hit、legacy の行だけを合計します。unknown_price と no_usage は unpriced_requests として数えられ、cost_usd には何も加えません。JSON ボディには unpriced_requests と unpriced_share が含まれるため、価格テーブルの欠落が見えます。

エクスプローラー​

ダッシュボードのルートは #analytics です。ハッシュがクエリです。含まれるのは、組織、from、to、metrics、group-by、granularity、top、chart、filter、compare です。保存済みビューを開くと、そのハッシュが書き戻されます。

GET と POST /api/analytics/views?org_id= には、analytics.read が必要です。ビューは、正規化されたクエリを保存します。label:Issue は label:issue として保存されます。各所有者は、1 つの組織で 100 件のビューを保持できます。次の作成は 409 view_limit です。他者が所有する非公開ビューは 404 です。共有ビューは、その所有者、または org.update を持つ呼び出し元が変更できます。共有ビューの作成または削除は監査されます。変更操作は、管理者の CSRF Cookie を使います。

クエリ API​

GET /api/analytics/query には、analytics.read が必要です。

パラメータ意味
org_id組織。必須
from, toRFC3339。from は to より前
metrics1 から 6 個の名前。カンマ区切り
group_by最大 2 つのディメンション。label:<key> は小文字化されます
granularitynone(デフォルト)、hour、day、week、month。hour は最大 14 日です
topデフォルト 20
tzIANA ゾーン。省略時は組織のゾーン、次いで UTC です
filterYQL。例: label.ci.pipeline = "9001"
compareprevious は直前のウィンドウを追加します
formatcsv はスプレッドシートを返します。それ以外は JSON です

メトリクス名: requests、tokens_in、tokens_out、cache_read_tokens、cost_usd、unpriced_requests、errors、retried_requests、fallback_requests、error_rate、cache_hit_rate、prompt_cache_ratio、cost_per_request、latency_p50、latency_p95、ttft_p50、ttft_p95、sessions。

ディメンション: model、model_requested、endpoint、team、agent、task、status_class、cache、および label:<key>。

curl -fsS -b "$ADMIN_COOKIE" \
"$ADMIN/api/analytics/query?org_id=$ORG&from=2026-09-01T00:00:00Z&to=2026-09-08T00:00:00Z&metrics=cost_usd,requests,unpriced_requests&group_by=label:ci.pipeline&granularity=day&top=20&filter=label.ci.pipeline%20%3D%20%229001%22"

CSV は、&format=csv を付けた同じ URL です。

フィルター、非加法メトリクス、またはロールアップが答えられない範囲は、request_logs を直接読みます。その経路は、最大 93 日を対象とします。フィルターが空で、加法メトリクスを使い、粒度が hour、day、week、month のいずれかであるクエリはロールアップを使え、その場合は最大 400 日を対象とします。そのとき、JSON フィールド source は rollup です。

ロールアップと価格カバレッジ​

loggerd は、5 分ごとに [now−3h, now+1h) の範囲で analytics_rollup_hourly と label_rollup_hourly を書き換え、03:17 UTC に 7 日分を日次チャンクで再計算します。ロールアップに当たるグループ化クエリは、更新 1 回分遅れることがあります。YABANIN_ROLLUPS=0 は、そのループを停止します。ラベルロールアップは、組織方針の rollup_keys に列挙されたキーだけを保持します。

cost_usd は、価格未設定の行を無視します。unpriced_requests は、それらを数えます。yb pricing sync --apply のあと、データベースの価格は 5 分以内にゲートウェイへ届きます。それまで、それらのリクエストは未価格の件数に残ります。

ボード​

CI ボードは、パイプライン、ジョブ名、トリガーごとにコストをグループ化し、ci.system を持つリクエストの日次コストを描画します。ci.pipeline ラベルのないパイプラインは、パイプラインパネルに表示されません。他のボードは、モデル、ツール、衛生を扱います。必須ディメンションが一度も観測されていないパネルは、ゼロで埋めるのではなく、非表示になります。