Files
HiveGrid-Wireframes/03 Quellen und Referenzen/hivegrid-cloud/apps/web/app/lib/metrics/registry.ts
T

59 lines
2.0 KiB
TypeScript

/**
* 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");
}