Analitik
Peneroka, papan, dan GET /api/analytics/query membaca log
permintaan yang sama. Baris bayang dikecualikan daripada jumlah. Jumlah dolar
hanya menjumlahkan baris yang status kosnya ialah priced, cache_hit, atau legacy.
unknown_price dan no_usage dikira sebagai unpriced_requests dan tidak menambah apa-apa
kepada cost_usd. Badan JSON merangkumi unpriced_requests dan
unpriced_share supaya jurang dalam jadual harga kelihatan.
Peneroka
Laluan papan pemuka ialah #analytics. Hash ialah pertanyaan: organisasi,
from, to, metrik, ikut-kumpulan, granulariti, teratas, carta, penapis, dan
banding. Membuka paparan tersimpan menulis semula hash itu.
GET dan POST /api/analytics/views?org_id= memerlukan analytics.read.
Paparan menyimpan pertanyaan yang dinormalkan. label:Issue disimpan sebagai
label:issue. Setiap pemilik boleh menyimpan 100 paparan dalam organisasi; penciptaan
seterusnya ialah 409 view_limit. Paparan peribadi milik orang lain ialah 404. Paparan
berkongsi boleh diubah oleh pemiliknya atau oleh pemanggil dengan org.update.
Mencipta atau memadam paparan berkongsi diaudit. Mutasi menggunakan kuki
CSRF pentadbir.
API Pertanyaan
GET /api/analytics/query memerlukan analytics.read.
| Parameter | Maksud |
|---|---|
org_id | Organisasi. Wajib |
from, to | RFC3339, from sebelum to |
metrics | Satu hingga enam nama, dipisahkan koma |
group_by | Paling banyak dua dimensi. label:<key> dijadikan huruf kecil |
granularity | none (lalai), hour, day, week, month. hour membenarkan paling banyak 14 hari |
top | Lalai 20 |
tz | Zon IANA. Jika ditinggalkan, zon organisasi, kemudian UTC |
filter | YQL, contohnya label.ci.pipeline = "9001" |
compare | previous menambah tetingkap sebelumnya |
format | csv memulangkan hamparan. Selain itu ialah JSON |
Nama metrik: 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.
Dimensi: model, model_requested, endpoint, team, agent,
task, status_class, cache, dan 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 ialah URL yang sama dengan &format=csv.
Penapis, metrik yang tidak boleh ditambah, atau julat yang tidak dapat dijawab oleh rollup membaca
request_logs secara terus. Laluan itu meliputi paling banyak 93 hari. Pertanyaan dengan
penapis kosong, metrik yang boleh ditambah, dan granulariti hour, day, week, atau
month boleh menggunakan rollup lalu meliputi sehingga 400 hari. Medan JSON
source ialah rollup dalam kes itu.
Rollup dan liputan harga
loggerd menulis semula analytics_rollup_hourly dan label_rollup_hourly
setiap 5 minit bagi [now−3h, now+1h), dan pada 03:17 UTC mengira semula 7 hari
dalam bahagian harian. Pertanyaan berkumpulan yang mengenai rollup boleh ketinggalan
sebanyak satu penyegaran. YABANIN_ROLLUPS=0 menghentikan gelung itu. Rollup label hanya menyimpan kunci
yang disenaraikan dalam rollup_keys dasar organisasi.
cost_usd mengabaikan baris tanpa harga. unpriced_requests mengiranya. Selepas
yb pricing sync --apply, harga pangkalan data sampai ke gerbang dalam
5 minit. Sehingga itu, permintaan tersebut kekal dalam kiraan tanpa harga.
Papan
Papan CI mengumpulkan kos mengikut talian paip, nama kerja, dan pencetus, serta memplot
kos harian bagi permintaan yang mempunyai ci.system. Talian paip tanpa
label ci.pipeline tidak muncul pada panel talian paip. Papan lain
meliputi model, alat, dan kebersihan. Panel yang dimensi wajibnya
tidak pernah kelihatan disembunyikan, bukan diisi dengan sifar.