/** * Web (SSR) service-scoped Prometheus registry singleton. * * The web process serves both UI HTML and a couple of resource routes — * `/api/status` and `/api/metrics` — so it gets its own service-tagged * registry. Mirrors apps/api/src/metrics.ts. */ import { createDefaultMetrics, createMetricsRegistry, type DefaultMetrics, type MetricsRegistry } from "@hivegrid/metrics"; import { setEnqueueObserver } from "@hivegrid/queue"; type WebMetricsBundle = { registry: MetricsRegistry; metrics: DefaultMetrics; }; let cached: WebMetricsBundle | undefined; export function getWebMetrics(): WebMetricsBundle { if (!cached) { cached = buildWebMetrics(); } return cached; } export function resetWebMetricsForTests(): void { cached = undefined; } function buildWebMetrics(): WebMetricsBundle { const revision = process.env.APP_REVISION?.trim() ?? ""; const runtimeSurface = resolveMetricsRuntimeSurface(process.env); const registry = createMetricsRegistry({ serviceName: "web", collectDefaultProcessMetrics: true, defaultLabels: { runtime_surface: runtimeSurface, ...(revision ? { revision } : {}), }, }); const metrics = createDefaultMetrics(registry); // Wire BullMQ enqueue events into queue_jobs_enqueued_total. See // apps/api/src/metrics.ts for the same wiring. setEnqueueObserver((event) => { metrics.queueJobsEnqueuedTotal.labels({ queue: event.queueName, priority: event.priorityLabel }).inc(); }); return { registry, metrics }; } function resolveMetricsRuntimeSurface(env: Readonly<{ NODE_ENV?: string; VITEST?: string; WEB_RUNTIME_SURFACE?: string }>): "core" | "admin" | "portal" { const surface = env.WEB_RUNTIME_SURFACE; if (surface === "core" || surface === "admin" || surface === "portal") { return surface; } if (surface === undefined && (env.NODE_ENV === "test" || env.VITEST === "true")) { return "core"; } throw new Error("WEB_RUNTIME_SURFACE must be explicitly set to core, admin, or portal before web metrics initialization"); }