Repository Public
1// Analytics : séries temporelles d'usage, répartitions et requêtes récentes (métadonnées uniquement).23import { get } from "../api.js";4import { h, mount } from "../dom.js";5import { DASH, compact, dateTimeSec, day, dayTime, has, ms, num, pct, time } from "../format.js";6import { timeChart } from "../charts.js";7import { empty, segmented } from "../ui.js";8import { card, load, meter, pill, table } from "./common.js";910const RANGES = [11 { value: "1h", label: "1 h", title: "Dernière heure, par minute" },12 { value: "24h", label: "24 h", title: "Dernières 24 heures, par quart d'heure" },13 { value: "7d", label: "7 j", title: "7 derniers jours, par heure" },14 { value: "30d", label: "30 j", title: "30 derniers jours, par jour" },15];16const STEP_LABEL = { 60: "par minute", 900: "par quart d'heure", 3600: "par heure", 86400: "par jour" };17const ENDPOINTS = { "chat.completions": "POST /v1/chat/completions", completions: "POST /v1/completions", models: "GET /v1/models" };18let range = "24h";19let keyId = "";2021/** Comble les intervalles sans trafic : compteurs à 0, moyennes à null (aucune mesure). */22export function fillSeries(series, since, step, until = Math.floor(Date.now() / 1000)) {23 const byT = new Map(series.map((p) => [p.t, p]));24 const first = Math.floor(since / step) * step;25 const out = [];26 for (let t = first < since && !byT.has(first) ? first + step : first; t <= until; t += step) {27 out.push(byT.get(t) || { t, requests: 0, errors: 0, prompt_tokens: 0, completion_tokens: 0, cached_tokens: 0,28 avg_ttft_ms: null, avg_latency_ms: null, avg_queue_ms: null, tokens_per_second: null });29 }30 return out;31}3233export function axisFormats(step) {34 if (step >= 86400) return { fmtX: day, fmtTip: day };35 if (step >= 3600) return { fmtX: day, fmtTip: dayTime };36 return { fmtX: time, fmtTip: (ts) => `${day(ts)}, ${time(ts)}` };37}3839export function statusPill(r) {40 if (r.status < 400) return pill(String(r.status), "ok", "plain");41 return h("span", null, pill(String(r.status), r.status >= 500 ? "danger" : "warn", "plain"), r.error_code ? h("span", { class: "sub mono" }, r.error_code) : null);42}4344export function requestsTable(requests, keyNames) {45 return table([46 { label: "Date", lead: true, cls: "nw", render: (r) => dateTimeSec(r.ts) },47 { label: "Clé", cls: "nw", render: (r) => keyNames.get(r.key_id) || h("span", { class: "mono" }, r.key_id || DASH) },48 { label: "Modèle", cls: "nw", render: (r) => r.model || DASH },49 { label: "Endpoint", cls: "nw", render: (r) => h("span", { class: "mono" }, r.endpoint || DASH, r.stream ? h("span", { class: "sub" }, "flux SSE") : null) },50 { label: "Statut", cls: "nw", render: statusPill },51 { label: "Jetons entrée → sortie", cls: "n", render: (r) => h("span", null, `${num(r.prompt_tokens)} → ${num(r.completion_tokens)}`, r.cached_tokens ? h("span", { class: "sub" }, `${num(r.cached_tokens)} en cache`) : null) },52 { label: "File", cls: "n", render: (r) => ms(r.queue_ms) },53 { label: "1er jeton", cls: "n", render: (r) => ms(r.ttft_ms) },54 { label: "Latence", cls: "n", render: (r) => ms(r.latency_ms) },55 { label: "Jetons/s", cls: "n", render: (r) => num(r.tps, 1) },56 ], requests, { stack: false });57}5859function breakdown(title, sub, rows, labelOf) {60 if (!rows.length) return card({ title, sub, body: empty("Aucun trafic", "Aucune requête sur cette période.", "chart") });61 const max = Math.max(...rows.map((r) => r.requests || 0), 1);62 return card({ title, sub, flush: true, body: table([63 { label: title.replace(/^Par /, "").replace(/^./, (c) => c.toUpperCase()), lead: true, render: labelOf },64 { label: "Requêtes", render: (r) => h("div", { class: "bar-cell" }, h("span", { class: "num" }, num(r.requests)), meter((r.requests || 0) / max)) },65 { label: "Erreurs", cls: "n", render: (r) => (r.errors ? h("span", null, num(r.errors), h("span", { class: "sub" }, pct((r.errors / Math.max(1, r.requests)) * 100, 1))) : "0") },66 { label: "Jetons entrée → sortie", cls: "n", render: (r) => `${compact(r.prompt_tokens)} → ${compact(r.completion_tokens)}` },67 ], rows) });68}6970/** Les 25 plus récentes d'abord ; le reste à la demande. */71function recent(list, keyNames) {72 const host = h("div");73 const draw = (all) => mount(host, requestsTable(all ? list : list.slice(0, 25), keyNames),74 !all && list.length > 25 ? h("div", { class: "center", style: { "border-top": "1px solid var(--border)" } },75 h("button", { class: "btn", type: "button", onclick: () => draw(true) }, `Afficher les ${num(list.length)} dernières requêtes`)) : null);76 draw(false);77 return host;78}7980export default {81 title: "Analytics",82 sub: "Usage de l'API par période, application, modèle et endpoint",83 mount(ctx) {84 const charts = [];85 ctx.onCleanup(() => charts.splice(0).forEach((c) => c.destroy()));86 const keySelect = h("select", { class: "input", "aria-label": "Filtrer les graphiques par clé API", onchange: (e) => { keyId = e.target.value; refresh(); } },87 h("option", { value: "" }, "Toutes les clés"));88 mount(ctx.actions,89 h("div", { class: "toolbar" }, keySelect,90 segmented("Période", RANGES, range, (v) => { range = v; refresh(); })));91 const body = h("div", { class: "stack" });92 mount(ctx.root, body);9394 let keysLoaded = false;95 const keyNames = new Map([["admin-session", "Administrateur (Playground)"]]);9697 async function refresh() {98 charts.splice(0).forEach((c) => c.destroy());99 mount(body);100 await load(body, async () => {101 const q = `range=${range}${keyId ? `&key_id=${encodeURIComponent(keyId)}` : ""}`;102 const [a, r, k] = await Promise.all([103 get(`/admin/api/analytics?${q}`),104 get(`/admin/api/requests?limit=100${keyId ? `&key_id=${encodeURIComponent(keyId)}` : ""}`),105 keysLoaded ? null : get("/admin/api/keys"),106 ]);107 return { a, r, k };108 }, ({ a, r, k }) => {109 if (k) {110 keysLoaded = true;111 for (const key of k.keys) {112 keyNames.set(key.id, key.name);113 keySelect.append(h("option", { value: key.id }, `${key.name}${key.status === "revoked" ? " (révoquée)" : ""}`));114 }115 keySelect.append(h("option", { value: "admin-session" }, "Administrateur (Playground)"));116 keySelect.value = keyId;117 }118 const pts = fillSeries(a.series || [], a.since, a.step_s);119 const xs = pts.map((p) => p.t);120 const col = (name) => pts.map((p) => p[name]);121 const { fmtX, fmtTip } = axisFormats(a.step_s);122 const total = (name) => pts.reduce((acc, p) => acc + (p[name] || 0), 0);123 const reqs = total("requests");124 const errs = total("errors");125 const stepText = STEP_LABEL[a.step_s] || "";126127 const defs = [128 { title: "Requêtes", sub: `${num(reqs)} au total · ${stepText}`, type: "bar", integer: true, series: [["Requêtes", "var(--c1)", col("requests")]], fmt: (v) => compact(v) },129 { title: "Jetons", sub: `${compact(total("prompt_tokens"))} en entrée · ${compact(total("completion_tokens"))} en sortie`, type: "bar", integer: true, stacked: true,130 series: [["Entrée", "var(--c2)", col("prompt_tokens")], ["Sortie", "var(--c1)", col("completion_tokens")]], fmt: (v) => compact(v) },131 { title: "Temps de réponse moyen", sub: "Latence totale par requête", type: "line", series: [["Latence", "var(--c3)", col("avg_latency_ms")]], fmt: ms },132 { title: "Délai du premier jeton", sub: "Moyenne (TTFT), requêtes en flux", type: "line", series: [["TTFT", "var(--c2)", col("avg_ttft_ms")]], fmt: ms },133 { title: "Débit de génération", sub: "Jetons par seconde", type: "line", series: [["Débit", "var(--c1)", col("tokens_per_second")]], fmt: (v) => num(v, 1), fmtValue: (v) => `${num(v, 1)} jetons/s` },134 { title: "Erreurs", sub: `${num(errs)} au total${reqs ? ` · ${pct((errs / reqs) * 100, 1)} des requêtes` : ""}`, type: "bar", integer: true, series: [["Erreurs", "var(--danger)", col("errors")]], fmt: (v) => compact(v),135 emptyText: "Aucune erreur sur cette période." },136 ];137 const grid = h("div", { class: "cols-2" }, defs.map((def) => {138 const el = h("div");139 const series = def.series.map(([name, color, values]) => ({ name, color, values }));140 const allZero = def.type === "bar" && series.every((sr) => sr.values.every((v) => !v));141 queueMicrotask(() => charts.push(timeChart(el, {142 xs: allZero ? [] : xs, series, type: def.type, stacked: def.stacked, integer: def.integer, fmtY: def.fmt, fmtValue: def.fmtValue || def.fmt, fmtX, fmtTip,143 label: `${def.title} — ${def.sub}`, height: 210, emptyText: def.emptyText || "Aucune requête sur cette période.",144 })));145 return card({ title: def.title, sub: def.sub, body: el });146 }));147148 const reqList = r.requests || [];149 mount(body, grid,150 h("div", { class: "section-title" }, h("div", null, h("h2", null, "Répartition"), h("p", null, "Sur la période sélectionnée, toutes clés confondues"))),151 h("div", { class: "cols-3" },152 breakdown("Par application / clé", "Trafic par clé API", a.by_key || [], (row) => h("span", null, row.name || row.k, row.app ? h("span", { class: "sub" }, row.app) : null)),153 breakdown("Par modèle", "Trafic par modèle", a.by_model || [], (row) => h("span", { class: "mono" }, row.k || DASH)),154 breakdown("Par endpoint", "Trafic par route", a.by_endpoint || [], (row) => h("span", { class: "mono" }, ENDPOINTS[row.k] || row.k || DASH))),155 card({ title: "Requêtes récentes", sub: "Métadonnées uniquement : ni prompt ni réponse ne sont conservés", flush: true,156 body: reqList.length ? recent(reqList, keyNames) : empty("Aucune requête enregistrée", "Les requêtes apparaîtront ici dès le premier appel à l'API.", "list") }));157 });158 }159160 refresh();161 ctx.poll(() => (range === "1h" ? refresh() : null), 60_000);162 },163};164