@uptimizr/collector-server 2.0.1 → 2.2.0

package/dist/subscriptions/evaluate.js

@@ -0,0 +1,326 @@
+import { ANOMALY_MIN_TRAILING, ANOMALY_TRAILING_BUCKETS, BUCKET_SECONDS, bucketMeasureFor, computeBaseline, computeMover, detectAnomalies, floorToBucket, inWindow, isBucketableMetric, rollupWindow, summarizeRows, } from "@uptimizr/db";
+import { parseDurationMs } from "@uptimizr/schema";
+/** Windows up to this long default to hourly buckets; longer ones to daily. */
+const HOURLY_WINDOW_CEILING_MS = 7 * 86_400_000;
+/** Resolve the series grain: the declared one, else hourly for short windows. */
+export function bucketFor(sub) {
+    if (sub.evaluate.bucket != null)
+        return sub.evaluate.bucket;
+    const windowMs = parseDurationMs(sub.evaluate.window) ?? HOURLY_WINDOW_CEILING_MS;
+    return windowMs <= HOURLY_WINDOW_CEILING_MS ? "hour" : "day";
+}
+/**
+ * The window one evaluation measures: `[floor(now − window), now)`.
+ *
+ * `since` is floored so the series is bucket-aligned; `until` is not, so the
+ * partial bucket containing *this minute* is included. See the module note.
+ */
+export function resolveWindow(windowMs, bucket, now) {
+    const width = BUCKET_SECONDS[bucket] * 1000;
+    const since = floorToBucket(now - Math.max(windowMs, width), bucket);
+    return { since, until: now };
+}
+/** Compare two numbers with a subscription's operator. */
+export function compare(left, op, right) {
+    switch (op) {
+        case "<":
+            return left < right;
+        case "<=":
+            return left <= right;
+        case ">":
+            return left > right;
+        case ">=":
+            return left >= right;
+        case "==":
+            return left === right;
+        case "!=":
+            return left !== right;
+    }
+}
+/** Sum the denominators of a window's rows. */
+function sampleOf(rows) {
+    let total = 0;
+    for (const row of rows)
+        total += Number(row.sample_size) || 0;
+    return total;
+}
+/** The non-null values of a window's rows, in bucket order. */
+function valuesOf(rows) {
+    return rows.filter((row) => row.value != null).map((row) => Number(row.value));
+}
+/** Round to the precision the firing payload reports numbers at. */
+function round(value) {
+    return value == null || !Number.isFinite(value) ? null : Math.round(value * 1e6) / 1e6;
+}
+/**
+ * The column a `threshold` predicate on `metric` may name — its registry
+ * `comparable.primary`, or `null` when the metric declares none.
+ */
+export function thresholdColumnFor(metric) {
+    return metric.comparable?.primary ?? null;
+}
+/** Whether a metric can back a store-evaluated subscription at all. */
+export function isSubscribableMetric(metricId) {
+    return isBucketableMetric(metricId);
+}
+/** The effective `minSample` for a threshold: the predicate's, else the registry's. */
+function minSampleFor(sub, metric) {
+    if (sub.predicate.kind === "threshold" && sub.predicate.minSample != null) {
+        return sub.predicate.minSample;
+    }
+    return metric.comparable?.minSample ?? 1;
+}
+/** A not-fired result carrying the numbers the caller still wants to see. */
+function quiet(reason, window, bucket, series, extra = {}) {
+    return {
+        fired: false,
+        reason,
+        window,
+        value: null,
+        expected: null,
+        sampleSize: sampleOf(series),
+        dimensionValue: null,
+        series,
+        bucket,
+        ...extra,
+    };
+}
+/**
+ * Evaluate one subscription now.
+ *
+ * Every predicate kind but `presence` issues **one** bucket read; `movers` and
+ * `new_value` cover both their windows with a single spanning scan, the same
+ * trick `movers` itself uses, so both windows are guaranteed to have seen one
+ * snapshot of the data.
+ */
+export async function evaluateSubscription(deps, sub, metric) {
+    const now = (deps.now ?? Date.now)();
+    const bucket = bucketFor(sub);
+    const windowMs = parseDurationMs(sub.evaluate.window) ?? 3_600_000;
+    const window = resolveWindow(windowMs, bucket, now);
+    const scene = sub.filters.scene;
+    const read = (opts) => deps.readBuckets({
+        metric: metric.id,
+        bucket,
+        since: window.since,
+        until: window.until,
+        scene,
+        ...opts,
+    });
+    switch (sub.predicate.kind) {
+        case "presence": {
+            const active = deps.activeSessions?.() ?? 0;
+            const fired = compare(active, sub.predicate.op, sub.predicate.value);
+            return {
+                fired,
+                reason: `${active} live session(s); predicate is presence ${sub.predicate.op} ${sub.predicate.value}`,
+                window: { since: now, until: now },
+                value: active,
+                expected: sub.predicate.value,
+                sampleSize: active,
+                dimensionValue: null,
+                series: [],
+                bucket,
+            };
+        }
+        case "threshold": {
+            const rows = await read({});
+            const values = valuesOf(rows);
+            const sampleSize = sampleOf(rows);
+            const minSample = minSampleFor(sub, metric);
+            if (sampleSize < minSample) {
+                return quiet(`window held ${sampleSize} sample(s), below minSample ${minSample}`, window, bucket, rows);
+            }
+            const rollup = bucketMeasureFor(metric.id)?.rollup ?? "mean";
+            const value = rollupWindow(values, rollup);
+            if (value == null) {
+                return quiet(`no value for ${metric.id} in the window`, window, bucket, rows);
+            }
+            const fired = compare(value, sub.predicate.op, sub.predicate.value);
+            const column = sub.predicate.column;
+            return {
+                fired,
+                reason: fired
+                    ? `${metric.id}.${column} is ${round(value)} — ${sub.predicate.op} ${sub.predicate.value} over ${sub.evaluate.window}`
+                    : `${metric.id}.${column} is ${round(value)}, which is not ${sub.predicate.op} ${sub.predicate.value}`,
+                window,
+                value: round(value),
+                expected: sub.predicate.value,
+                sampleSize,
+                dimensionValue: null,
+                series: rows,
+                bucket,
+            };
+        }
+        case "movers": {
+            // One spanning scan covering the current window and the equal one before
+            // it, split in TypeScript — half the reads, and one snapshot of the data.
+            const reference = { since: window.since - windowMs, until: window.since };
+            const rows = await read({ since: reference.since });
+            const current = rows.filter((row) => inWindow(row.bucket, window));
+            const previous = rows.filter((row) => inWindow(row.bucket, reference));
+            const sampleSize = sampleOf(current);
+            const minSample = minSampleFor(sub, metric);
+            if (sampleSize < minSample) {
+                return quiet(`window held ${sampleSize} sample(s), below minSample ${minSample}`, window, bucket, current);
+            }
+            const mover = computeMover({
+                metric: metric.id,
+                direction: metric.comparable?.direction ?? "neutral",
+                minSample,
+                rollup: bucketMeasureFor(metric.id)?.rollup ?? "sum",
+                current,
+                reference: previous,
+            });
+            // `deltaPct` is a signed *fraction* of the reference level; the predicate
+            // is declared in percent, which is what an operator writes down.
+            const pct = mover.deltaPct == null ? null : mover.deltaPct * 100;
+            if (pct == null) {
+                return quiet(`no comparable previous window for ${metric.id}`, window, bucket, current, {
+                    value: mover.current,
+                });
+            }
+            const wanted = sub.predicate.direction ?? "any";
+            const directionOk = wanted === "any" ? true : wanted === "up" ? pct > 0 : pct < 0;
+            const fired = directionOk && Math.abs(pct) >= sub.predicate.pct;
+            return {
+                fired,
+                reason: fired
+                    ? `${metric.id} moved ${round(pct)}% versus the previous ${sub.evaluate.window} (threshold ±${sub.predicate.pct}%)`
+                    : `${metric.id} moved ${round(pct)}%, inside the ±${sub.predicate.pct}% threshold`,
+                window,
+                value: mover.current,
+                expected: mover.previous,
+                sampleSize,
+                dimensionValue: null,
+                series: current,
+                bucket,
+            };
+        }
+        case "anomaly": {
+            // Anomaly detection needs trailing history to know what "normal" was, so
+            // the read extends back over the primitive's own trailing window. Only
+            // buckets inside the *evaluation* window can fire — the history is context,
+            // not findings, or every restart would re-alert on last week.
+            const trailing = ANOMALY_TRAILING_BUCKETS[bucket];
+            const width = BUCKET_SECONDS[bucket] * 1000;
+            const historySince = floorToBucket(window.since - trailing * width, bucket);
+            const rows = await read({ since: historySince });
+            if (rows.length < ANOMALY_MIN_TRAILING + 1) {
+                return quiet(`only ${rows.length} bucket(s) of history; anomalies need more than ${ANOMALY_MIN_TRAILING}`, window, bucket, rows.filter((row) => inWindow(row.bucket, window)));
+            }
+            const anomalies = detectAnomalies(metric.id, scene, rows, {
+                bucket,
+                sensitivity: sub.predicate.sensitivity,
+            }).filter((row) => inWindow(row.bucketStart, window));
+            const inside = rows.filter((row) => inWindow(row.bucket, window));
+            if (anomalies.length === 0) {
+                return quiet(`no anomalous ${bucket} bucket for ${metric.id}`, window, bucket, inside);
+            }
+            // The most extreme finding inside the window is the one worth waking
+            // someone for; the rest are in the same episode.
+            const worst = anomalies.reduce((a, b) => (Math.abs(b.z ?? 0) > Math.abs(a.z ?? 0) ? b : a));
+            return {
+                fired: true,
+                reason: `${metric.id} was ${worst.kind} at ${new Date(worst.bucketStart).toISOString()}: ` +
+                    `${round(worst.value)} against an expected ${round(worst.expected)} (robust z ${round(worst.z)})`,
+                window,
+                value: worst.value,
+                expected: worst.expected,
+                sampleSize: sampleOf(inside),
+                dimensionValue: worst.contributor?.value ?? null,
+                series: inside,
+                bucket,
+            };
+        }
+        case "new_value": {
+            // Same spanning-scan trick as `movers`, grouped by the watched dimension:
+            // a value present in the current window and absent from the one before it
+            // is new. Bounded by construction — one grouped read, no retained state.
+            const reference = { since: window.since - windowMs, until: window.since };
+            const rows = await read({ since: reference.since, groupBy: sub.predicate.dimension });
+            const seen = new Set();
+            for (const row of rows) {
+                if (inWindow(row.bucket, reference) && row.dimension_value != null) {
+                    seen.add(row.dimension_value);
+                }
+            }
+            const fresh = [];
+            for (const row of rows) {
+                if (!inWindow(row.bucket, window))
+                    continue;
+                const value = row.dimension_value;
+                // `''` is the store's "unattributed", not a value anyone named — firing
+                // on it would report "a new scene appeared" for every unlabelled event.
+                if (value == null || value === "" || seen.has(value))
+                    continue;
+                if (!fresh.includes(value))
+                    fresh.push(value);
+            }
+            const inside = rows.filter((row) => inWindow(row.bucket, window));
+            if (fresh.length === 0) {
+                return quiet(`no unseen ${sub.predicate.dimension} value in the window`, window, bucket, inside);
+            }
+            const first = fresh[0];
+            return {
+                fired: true,
+                reason: `new ${sub.predicate.dimension} ${JSON.stringify(first)}` +
+                    (fresh.length > 1 ? ` (and ${fresh.length - 1} more)` : "") +
+                    ` on ${metric.id}`,
+                window,
+                value: fresh.length,
+                expected: seen.size,
+                sampleSize: sampleOf(inside),
+                dimensionValue: first,
+                series: inside,
+                bucket,
+            };
+        }
+    }
+}
+/** Shape an evaluation into the firing record stored and delivered. */
+export function toFiring(sub, result, at) {
+    return {
+        subscriptionId: sub.id,
+        name: sub.name,
+        metric: sub.metric,
+        predicate: sub.predicate.kind,
+        at,
+        window: { since: result.window.since, until: result.window.until },
+        value: result.value,
+        expected: result.expected,
+        sampleSize: result.sampleSize,
+        scene: sub.filters.scene ?? null,
+        reason: result.reason,
+        dimensionValue: result.dimensionValue,
+    };
+}
+/**
+ * The bounded `format=summary` block a webhook carries alongside the firing
+ * (sketch §F.3: "so the receiver can act without a second call").
+ *
+ * It is the registry's own summary of `insight_baseline` over exactly the window
+ * that fired — a real registry metric with real declared units and caveats,
+ * rather than a hand-rolled bag of numbers. That is deliberate: the receiver
+ * reads the same envelope it would get from `GET /api/v1/insights/baseline`, so
+ * anything that can already render one can render this.
+ *
+ * `null` when the predicate read no series (`presence`) or the summariser
+ * declines the rows.
+ */
+export function summaryFor(sub, result) {
+    if (result.series.length === 0)
+        return null;
+    const baseline = computeBaseline(sub.metric, sub.filters.scene, result.series);
+    const summary = summarizeRows("insight_baseline", [baseline], {
+        range: { since: result.window.since, until: result.window.until },
+        filters: {
+            metric: sub.metric,
+            scene: sub.filters.scene,
+            bucket: result.bucket,
+            window: sub.evaluate.window,
+        },
+    });
+    return summary == null ? null : summary;
+}
+//# sourceMappingURL=evaluate.js.map

package/dist/subscriptions/evaluate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"evaluate.js","sourceRoot":"","sources":["../../src/subscriptions/evaluate.ts"],"names":[],"mappings":"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"}

package/dist/subscriptions/scheduler.d.ts

@@ -0,0 +1,97 @@
+import type { SubscriptionRecord } from "@uptimizr/db";
+import type { CollectorConfig } from "../config.js";
+import type { LiveBus } from "../liveBus.js";
+import type { CollectorStore } from "../store.js";
+import { type EvaluationResult } from "./evaluate.js";
+import type { SubscriptionStream } from "./stream.js";
+/**
+ * **The subscription scheduler** (#311, ADR 0051 §6 / sketch §F.2).
+ *
+ * One in-process scheduler for the whole collector. Its job is small and its
+ * constraints are the interesting part:
+ *
+ * - **Every subscription owns one timer**, firing on its own `evaluate.every`.
+ *   Even the bus-backed predicates have one: `presence <= 0` ("nobody is in the
+ *   scene") can only become true when events *stop* arriving, so a scheduler
+ *   that only woke on bus traffic could never report it.
+ * - **The bus is an accelerator, not the clock.** `presence` and `new_value`
+ *   additionally watch `LiveBus.subscribe` so they react in seconds rather than
+ *   at the next tick. The state each one keeps is bounded
+ *   ({@link NEW_VALUE_MAX_TRIGGERS}) and the trigger is rate-limited
+ *   ({@link BUS_MIN_INTERVAL_MS}), so a firehose cannot turn into a query storm.
+ *   The *answer* still comes from the store evaluation, so the bus can only
+ *   change when a subscription is checked, never what it concludes.
+ * - **At most {@link CollectorConfig.subscriptionsMaxConcurrent} evaluations run
+ *   at once**, and at most one per subscription. A tick that arrives while the
+ *   previous one is still in flight is dropped, not queued — a subscription that
+ *   cannot keep up with its own interval must not grow a backlog.
+ * - **Cooldown is enforced before delivery, not before evaluation.** The
+ *   evaluation is cheap and its result is what `POST …/test` and the dashboard
+ *   read; the *firing* is what costs a webhook.
+ * - **Every timer is `unref`'d and cleared by {@link SubscriptionScheduler.stop}.**
+ *   A test that starts the scheduler and closes the app leaves nothing behind.
+ */
+/** Smallest gap between two bus-triggered evaluations of one subscription. */
+export declare const BUS_MIN_INTERVAL_MS = 5000;
+/**
+ * Distinct dimension values one `new_value` watcher remembers having triggered
+ * on. Past this the set is cleared and the watcher falls back to its timer — the
+ * predicate is for low-cardinality dimensions ("a new scene", "a new custom
+ * event"), and an unbounded set on a hot bus is exactly the kind of state
+ * ADR 0032 §6 exists to prevent.
+ */
+export declare const NEW_VALUE_MAX_TRIGGERS = 256;
+/** How often the scheduler re-reads the store to pick up external changes. */
+export declare const RELOAD_INTERVAL_MS = 60000;
+export interface SchedulerDeps {
+    store: CollectorStore;
+    config: CollectorConfig;
+    liveBus: LiveBus;
+    stream: SubscriptionStream;
+    /** Structured logger; a Fastify instance's `log` in production. */
+    log: {
+        warn: (obj: unknown, msg?: string) => void;
+        info: (obj: unknown, msg?: string) => void;
+    };
+    /** Injected for tests. Defaults to the global `fetch`. */
+    fetchImpl?: typeof fetch;
+    /** Injected for tests. Defaults to `Date.now`. */
+    now?: () => number;
+    /** Injected for tests, so webhook backoff does not sleep for real. */
+    sleep?: (ms: number) => Promise<void>;
+    /**
+     * Fraction in `[0, 1)` used to jitter a subscription's first evaluation.
+     * Defaults to `Math.random`; tests pass `() => 0` for a deterministic phase.
+     */
+    jitter?: () => number;
+}
+export interface RunOptions {
+    /** Deliver a firing (record it, fan it out, POST it). `false` for a dry run. */
+    deliver?: boolean;
+}
+export interface SubscriptionScheduler {
+    /** Reconcile timers and bus watchers against the store. Idempotent. */
+    reload(): Promise<void>;
+    /**
+     * Evaluate one subscription now, outside its schedule. Returns the evaluation
+     * so `POST …/test` can answer with it. Honours cooldown when delivering.
+     *
+     * `null` means "not now": the subscription already had an evaluation in
+     * flight, or the collector was at its concurrency cap. The route turns that
+     * into a `409` rather than quietly running a second one in parallel.
+     */
+    runOnce(sub: SubscriptionRecord, options?: RunOptions): Promise<EvaluationResult | null>;
+    /** Subscriptions currently scheduled. */
+    readonly scheduledCount: number;
+    /** Evaluations in flight (for tests asserting the concurrency cap). */
+    readonly inFlight: number;
+    /** Clear every timer and bus watcher. Idempotent. */
+    stop(): void;
+}
+/**
+ * Create the scheduler. It does nothing until {@link SubscriptionScheduler.reload}
+ * is called, which `app.ts` does once at startup and every CRUD write does after
+ * it changes something.
+ */
+export declare function createSubscriptionScheduler(deps: SchedulerDeps): SubscriptionScheduler;
+//# sourceMappingURL=scheduler.d.ts.map

package/dist/subscriptions/scheduler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scheduler.d.ts","sourceRoot":"","sources":["../../src/subscriptions/scheduler.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAEvD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,KAAK,EAAE,OAAO,EAAkB,MAAM,eAAe,CAAC;AAC7D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAA8C,KAAK,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAElG,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEtD;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,8EAA8E;AAC9E,eAAO,MAAM,mBAAmB,OAAQ,CAAC;AAEzC;;;;;;GAMG;AACH,eAAO,MAAM,sBAAsB,MAAM,CAAC;AAE1C,8EAA8E;AAC9E,eAAO,MAAM,kBAAkB,QAAS,CAAC;AAUzC,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,cAAc,CAAC;IACtB,MAAM,EAAE,eAAe,CAAC;IACxB,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,kBAAkB,CAAC;IAC3B,mEAAmE;IACnE,GAAG,EAAE;QAAE,IAAI,EAAE,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;QAAC,IAAI,EAAE,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,CAAC,EAAE,MAAM,KAAK,IAAI,CAAA;KAAE,CAAC;IAChG,0DAA0D;IAC1D,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;IACzB,kDAAkD;IAClD,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IACnB,sEAAsE;IACtE,KAAK,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACtC;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,UAAU;IACzB,gFAAgF;IAChF,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,qBAAqB;IACpC,uEAAuE;IACvE,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACxB;;;;;;;OAOG;IACH,OAAO,CAAC,GAAG,EAAE,kBAAkB,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAAC;IACzF,yCAAyC;IACzC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,uEAAuE;IACvE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,qDAAqD;IACrD,IAAI,IAAI,IAAI,CAAC;CACd;AA+BD;;;;GAIG;AACH,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,aAAa,GAAG,qBAAqB,CAgRtF"}