SPB Git

Repository Public

analytics.js 9.9 KB 164 lines javascript

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
Files main
Menu

Theme