Skip to main content

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.

ParameterMaksud
org_idOrganisasi. Wajib
from, toRFC3339, from sebelum to
metricsSatu hingga enam nama, dipisahkan koma
group_byPaling banyak dua dimensi. label:<key> dijadikan huruf kecil
granularitynone (lalai), hour, day, week, month. hour membenarkan paling banyak 14 hari
topLalai 20
tzZon IANA. Jika ditinggalkan, zon organisasi, kemudian UTC
filterYQL, contohnya label.ci.pipeline = "9001"
compareprevious menambah tetingkap sebelumnya
formatcsv 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.