利用分析
エクスプローラー、ボード、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, to | RFC3339。from は to より前 |
metrics | 1 から 6 個の名前。カンマ区切り |
group_by | 最大 2 つのディメンション。label:<key> は小文字化されます |
granularity | none(デフォルト)、hour、day、week、month。hour は最大 14 日です |
top | デフォルト 20 |
tz | IANA ゾーン。省略時は組織のゾーン、次いで UTC です |
filter | YQL。例: label.ci.pipeline = "9001" |
compare | previous は直前のウィンドウを追加します |
format | csv はスプレッドシートを返します。それ以外は 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 ラベルのないパイプラインは、パイプラインパネルに表示されません。他のボードは、モデル、ツール、衛生を扱います。必須ディメンションが一度も観測されていないパネルは、ゼロで埋めるのではなく、非表示になります。