@marinoscar/platform-api 0.0.0-stage → 0.1.0-next.3

package/dist/telemetry/metrics/metric-sql.js

@@ -0,0 +1,259 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UPTIME_ERROR_CHARS = exports.COUNTER_DELTA = exports.METRIC_PROBE_MAX_KEYS = exports.METRIC_HISTOGRAM_MAX_ROWS = exports.METRIC_TABLE_MAX_ROWS = exports.METRIC_MAX_GROUPS = exports.METRIC_MIN_BUCKET_SECONDS = void 0;
+exports.tableMaxRows = tableMaxRows;
+exports.filterPredicates = filterPredicates;
+exports.gaugeSeriesSql = gaugeSeriesSql;
+exports.counterSeriesSql = counterSeriesSql;
+exports.histogramIncreaseSql = histogramIncreaseSql;
+exports.presentParts = presentParts;
+exports.latestByKeySql = latestByKeySql;
+exports.uptimeStatusSql = uptimeStatusSql;
+exports.uptimeErrorsSql = uptimeErrorsSql;
+exports.distinctHostsSql = distinctHostsSql;
+const sql_literals_1 = require("../dashboard/sql-literals");
+const metric_catalog_1 = require("./metric-catalog");
+// =============================================================================
+// SQL for the metric catalog (issue #601, epic #576)
+// =============================================================================
+//
+// PURE TEMPLATE FUNCTIONS, with the same discipline as
+// `../dashboard/telemetry-dashboard.sql.ts` (docs/specs/telemetry.md §11.5):
+//
+//   - identifiers are catalog constants or column names the STORE reported
+//     (`information_schema.columns`), quoted by `ident`;
+//   - literal values are catalog constants (`state = 'idle'`) or
+//     `service`/`instance`/`host` values the service already matched against
+//     the distinct values seen in the range, quoted by `literal`;
+//   - instants are validated `Date`s (`timestampLiteral`), bucket sizes come
+//     from the closed list (`bucketInterval`);
+//   - every statement ends in a literal top-level LIMIT; no bind parameters.
+//
+// Every builder takes the discovered `MetricTableInfo` of its table and
+// returns NULL instead of a statement when the table or a column it needs is
+// absent, so a store that has not received a source yet degrades to a
+// skipped family, never to an error.
+//
+// Verified on GreptimeDB v1.2.1 against tables written by collector 0.145.0
+// and the API's OTLP exporter (2026-09-30): `lag(v) OVER (PARTITION BY …
+// ORDER BY greptime_timestamp)` in a subquery, `last_value(v ORDER BY ts)`,
+// `date_bin` over a subquery, a constant `'' AS k` group, `UNION ALL` with a
+// top-level `ORDER BY … LIMIT`, `count(DISTINCT …)`.
+// =============================================================================
+/** Metric tables are written every 30–60 s: a finer bucket would be half empty. */
+exports.METRIC_MIN_BUCKET_SECONDS = 60;
+/** Series (group values) one family returns at most; the rest are cut, alphabetically. */
+exports.METRIC_MAX_GROUPS = 20;
+/** Rows a per-key table returns at most, unless its spec sets `maxRows`. */
+exports.METRIC_TABLE_MAX_ROWS = 50;
+/** Rows `spec` returns at most: its own `maxRows`, else `METRIC_TABLE_MAX_ROWS`. */
+function tableMaxRows(spec) {
+    return spec.maxRows ?? exports.METRIC_TABLE_MAX_ROWS;
+}
+/** Rows a histogram statement returns at most (periods × groups × `le`). */
+exports.METRIC_HISTOGRAM_MAX_ROWS = 4000;
+/** Keys a verdict probe part reads at most. */
+exports.METRIC_PROBE_MAX_KEYS = 200;
+const TS = (0, sql_literals_1.ident)(metric_catalog_1.METRIC_TIME_COLUMN);
+const VALUE = (0, sql_literals_1.ident)(metric_catalog_1.METRIC_VALUE_COLUMN);
+// ---- predicates ----------------------------------------------------------------
+function predicate(p) {
+    return `${(0, sql_literals_1.ident)(p.column)} ${p.op} ${(0, sql_literals_1.literal)(p.value)}`;
+}
+/**
+ * The request filters a family honours, as predicates. A filter set on a
+ * table lacking its column matches nothing (`1 = 0`), the same rule as the
+ * traces' instance filter.
+ */
+function filterPredicates(info, allowed, filters) {
+    const parts = [];
+    for (const key of allowed) {
+        const value = filters[key];
+        if (!value)
+            continue;
+        const column = metric_catalog_1.METRIC_FILTER_COLUMNS[key];
+        parts.push(info.columns.has(column) ? `${(0, sql_literals_1.ident)(column)} = ${(0, sql_literals_1.literal)(value)}` : '1 = 0');
+    }
+    return parts;
+}
+function whereOf(info, from, to, where, allowed, filters, extra = []) {
+    return [
+        (0, sql_literals_1.between)(metric_catalog_1.METRIC_TIME_COLUMN, from, to),
+        ...(where ?? []).map(predicate),
+        ...filterPredicates(info, allowed, filters),
+        ...extra,
+    ].join(' AND ');
+}
+/** Every column the statement touches exists. */
+function hasColumns(info, columns) {
+    return !!info && columns.every((c) => c === undefined || info.columns.has(c));
+}
+function keyExpr(column) {
+    return column ? (0, sql_literals_1.ident)(column) : "''";
+}
+function aggregate(fn, expr) {
+    return `${fn}(${expr})`;
+}
+/** `lag` over one series: every tag column, ordered by time. */
+function lagOver(info) {
+    const partition = info.tags.length ? `PARTITION BY ${info.tags.map(sql_literals_1.ident).join(', ')} ` : '';
+    return `lag(${VALUE}) OVER (${partition}ORDER BY ${TS})`;
+}
+/** Reset-aware increase of one point over its predecessor `p` (0 without one). */
+exports.COUNTER_DELTA = 'CASE WHEN p IS NULL THEN 0 WHEN v >= p THEN v - p ELSE v END';
+function groupRowLimit(window, maxGroups) {
+    return (0, sql_literals_1.bucketRowLimit)(window.from, window.to, window.bucketSeconds) * (0, sql_literals_1.positive)(maxGroups) + 1;
+}
+// ---- families --------------------------------------------------------------------
+/**
+ * A gauge per bucket and group: combined across series per timestamp
+ * (`seriesAggregate`), then per bucket (`bucketAggregate`). Columns: t, g
+ * (group value, '' without `groupBy`), v. Ordered by group then time, so a row
+ * cap cuts whole trailing groups (at most `maxGroups` + a partial one).
+ */
+function gaugeSeriesSql(family, info, window, filters, maxGroups = exports.METRIC_MAX_GROUPS) {
+    if (!hasColumns(info, [
+        ...family.requiredColumns,
+        family.groupBy,
+        ...(family.where ?? []).map((p) => p.column),
+    ])) {
+        return null;
+    }
+    const value = family.valueSql ?? VALUE;
+    return (`SELECT date_bin(${(0, sql_literals_1.bucketInterval)(window.bucketSeconds)}, ts) AS t, k AS g, ${aggregate(family.bucketAggregate, 'v')} AS v FROM (` +
+        `SELECT ${TS} AS ts, ${keyExpr(family.groupBy)} AS k, ${aggregate(family.seriesAggregate, value)} AS v ` +
+        `FROM ${(0, sql_literals_1.ident)(family.table)} WHERE ${whereOf(info, window.from, window.to, family.where, family.filters, filters)} ` +
+        'GROUP BY ts, k' +
+        `) GROUP BY t, g ORDER BY g, t LIMIT ${groupRowLimit(window, maxGroups)}`);
+}
+/**
+ * A cumulative counter's increase per bucket and group: the reset-aware delta
+ * of each point over its predecessor IN THE SAME SERIES (`lag` partitioned by
+ * every tag column), summed. Columns: t, g, v (the increase in that bucket).
+ */
+function counterSeriesSql(family, info, window, filters, maxGroups = exports.METRIC_MAX_GROUPS) {
+    if (!hasColumns(info, [
+        ...family.requiredColumns,
+        family.groupBy,
+        ...(family.where ?? []).map((p) => p.column),
+    ])) {
+        return null;
+    }
+    return (`SELECT date_bin(${(0, sql_literals_1.bucketInterval)(window.bucketSeconds)}, ts) AS t, k AS g, sum(${exports.COUNTER_DELTA}) AS v FROM (` +
+        `SELECT ${TS} AS ts, ${keyExpr(family.groupBy)} AS k, ${VALUE} AS v, ${lagOver(info)} AS p ` +
+        `FROM ${(0, sql_literals_1.ident)(family.table)} WHERE ${whereOf(info, window.from, window.to, family.where, family.filters, filters)}` +
+        `) GROUP BY t, g ORDER BY g, t LIMIT ${groupRowLimit(window, maxGroups)}`);
+}
+/**
+ * A histogram's bucket increases per period, group and `le`, over
+ * `[window.from, window.to)` where `currentFrom` splits 'previous' from
+ * 'current'. Columns: period, g, le, v. The quantile is interpolated by the
+ * caller (`histogramQuantile`).
+ */
+function histogramIncreaseSql(family, info, window, currentFrom, filters, limit = exports.METRIC_HISTOGRAM_MAX_ROWS + 1) {
+    if (!hasColumns(info, [
+        'le',
+        ...family.requiredColumns,
+        family.groupBy,
+        ...(family.where ?? []).map((p) => p.column),
+    ])) {
+        return null;
+    }
+    return (`SELECT CASE WHEN ts >= ${(0, sql_literals_1.timestampLiteral)(currentFrom)} THEN 'current' ELSE 'previous' END AS period, ` +
+        `k AS g, le, sum(${exports.COUNTER_DELTA}) AS v FROM (` +
+        `SELECT ${TS} AS ts, ${keyExpr(family.groupBy)} AS k, ${(0, sql_literals_1.ident)('le')} AS le, ${VALUE} AS v, ${lagOver(info)} AS p ` +
+        `FROM ${(0, sql_literals_1.ident)(family.table)} WHERE ${whereOf(info, window.from, window.to, family.where, family.filters, filters)}` +
+        `) GROUP BY period, g, le ORDER BY period, g, le LIMIT ${(0, sql_literals_1.positive)(limit)}`);
+}
+function latestPartSql(part, from, to, filters) {
+    const key = keyExpr(part.keyColumn);
+    const notNull = part.keyColumn ? [`${(0, sql_literals_1.ident)(part.keyColumn)} IS NOT NULL`] : [];
+    const where = whereOf(part.info, from, to, part.where, part.filters, filters, notNull);
+    const table = (0, sql_literals_1.ident)(part.table);
+    if (part.over === 'increase') {
+        return (`SELECT ${(0, sql_literals_1.literal)(part.name)} AS m, k, sum(${exports.COUNTER_DELTA}) AS v, max(ts) AS at FROM (` +
+            `SELECT ${TS} AS ts, ${key} AS k, ${VALUE} AS v, ${lagOver(part.info)} AS p FROM ${table} WHERE ${where}` +
+            ') GROUP BY k');
+    }
+    const over = part.over === 'last'
+        ? 'last_value(v ORDER BY ts)'
+        : part.over === 'count'
+            ? 'count(v)'
+            : `${part.over}(v)`;
+    return (`SELECT ${(0, sql_literals_1.literal)(part.name)} AS m, k, ${over} AS v, max(ts) AS at FROM (` +
+        `SELECT ${TS} AS ts, ${key} AS k, ${aggregate(part.seriesAggregate, part.valueSql ?? VALUE)} AS v ` +
+        `FROM ${table} WHERE ${where} GROUP BY ts, k` +
+        ') GROUP BY k');
+}
+/** The parts whose table and columns exist. */
+function presentParts(parts) {
+    return parts.filter((p) => hasColumns(p.info, [
+        p.keyColumn ?? undefined,
+        ...(p.requiredColumns ?? []),
+        ...(p.where ?? []).map((w) => w.column),
+    ]));
+}
+/**
+ * One value per (part, key) over `[from, to)`, as `UNION ALL` of the parts
+ * that exist. Columns: m (part name), k (key, '' when keyless), v, at (the
+ * key's latest timestamp). Ordered KEY-MAJOR (`k, m`) so a row cap cuts
+ * whole trailing keys, never a part: `maxKeys` keys × parts rows + 1 (the
+ * extra row shows truncation). With `orderByValue` (one part only) the rows
+ * are ordered by value, descending: the top `maxKeys`. Null when no part exists.
+ */
+function latestByKeySql(parts, from, to, filters, opts = {}) {
+    const present = presentParts(parts);
+    if (present.length === 0)
+        return null;
+    const maxKeys = (0, sql_literals_1.positive)(opts.maxKeys ?? exports.METRIC_TABLE_MAX_ROWS);
+    const body = present.map((p) => latestPartSql(p, from, to, filters)).join(' UNION ALL ');
+    if (opts.orderByValue) {
+        if (present.length !== 1)
+            throw new RangeError('latestByKeySql: orderByValue needs exactly one part');
+        return `${body} ORDER BY v DESC, k LIMIT ${maxKeys + 1}`;
+    }
+    const order = opts.order === 'part' ? 'm, k' : 'k, m';
+    return `${body} ORDER BY ${order} LIMIT ${maxKeys * present.length + 1}`;
+}
+// ---- uptime ------------------------------------------------------------------------
+/**
+ * Per URL over `[from, to)`: the latest check, the latest passing (2xx) check,
+ * how many checks ran and passed, whether the latest passed, and its status
+ * code. A check is one timestamp: five rows (one per class), value 1 on the
+ * class that matched, all 0 when the request errored. Columns: k, last_at,
+ * last_ok_at, checks, ok_checks, ok_now, code.
+ */
+function uptimeStatusSql(info, from, to, filters, allowed, maxKeys = exports.METRIC_TABLE_MAX_ROWS) {
+    if (!hasColumns(info, ['http_url', 'http_status_class']))
+        return null;
+    const code = info.columns.has('http_status_code')
+        ? `max(CASE WHEN ${VALUE} = 1 THEN ${(0, sql_literals_1.ident)('http_status_code')} END)`
+        : 'NULL';
+    const ok = `max(CASE WHEN ${(0, sql_literals_1.ident)('http_status_class')} = '2xx' AND ${VALUE} = 1 THEN 1 ELSE 0 END)`;
+    return ('SELECT k, max(ts) AS last_at, max(CASE WHEN ok = 1 THEN ts END) AS last_ok_at, count(*) AS checks, ' +
+        'sum(ok) AS ok_checks, last_value(ok ORDER BY ts) AS ok_now, last_value(code ORDER BY ts) AS code FROM (' +
+        `SELECT ${TS} AS ts, ${(0, sql_literals_1.ident)('http_url')} AS k, ${ok} AS ok, ${code} AS code FROM ${(0, sql_literals_1.ident)(metric_catalog_1.HTTPCHECK_STATUS_TABLE)} ` +
+        `WHERE ${whereOf(info, from, to, undefined, allowed, filters)} GROUP BY ts, k` +
+        `) GROUP BY k ORDER BY k LIMIT ${(0, sql_literals_1.positive)(maxKeys) + 1}`);
+}
+/** Characters of an `httpcheck_error` message kept. */
+exports.UPTIME_ERROR_CHARS = 200;
+/** Per URL over `[from, to)`: failed checks and the latest error text. Columns: k, errors, message, at. */
+function uptimeErrorsSql(info, from, to, filters, allowed, maxKeys = exports.METRIC_TABLE_MAX_ROWS) {
+    if (!hasColumns(info, ['http_url', 'error_message']))
+        return null;
+    return (`SELECT ${(0, sql_literals_1.ident)('http_url')} AS k, count(*) AS errors, ` +
+        `substr(last_value(${(0, sql_literals_1.ident)('error_message')} ORDER BY ${TS}), 1, ${exports.UPTIME_ERROR_CHARS}) AS message, max(${TS}) AS at ` +
+        `FROM ${(0, sql_literals_1.ident)(metric_catalog_1.HTTPCHECK_ERROR_TABLE)} WHERE ${whereOf(info, from, to, undefined, allowed, filters)} ` +
+        `GROUP BY k ORDER BY k LIMIT ${(0, sql_literals_1.positive)(maxKeys) + 1}`);
+}
+// ---- filter values ---------------------------------------------------------------
+/** Distinct host names in `[from, to)` from one small host table. Column: v. */
+function distinctHostsSql(info, table, from, to, limit) {
+    if (!hasColumns(info, ['host_name']))
+        return null;
+    const col = (0, sql_literals_1.ident)('host_name');
+    return (`SELECT ${col} AS v FROM ${(0, sql_literals_1.ident)(table)} WHERE ${(0, sql_literals_1.between)(metric_catalog_1.METRIC_TIME_COLUMN, from, to)} ` +
+        `AND ${col} IS NOT NULL AND ${col} <> '' GROUP BY v ORDER BY v LIMIT ${(0, sql_literals_1.positive)(limit)}`);
+}
+//# sourceMappingURL=metric-sql.js.map

package/dist/telemetry/metrics/metric-sql.js.map

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

package/dist/telemetry/metrics/metric-values.d.ts

@@ -0,0 +1,19 @@
+import type { TelemetryQueryResult } from '../greptime/greptime.client';
+/** A finite number, or null. */
+export declare function numOrNull(value: unknown): number | null;
+/** A store instant (text or Date) as epoch ms, or null. */
+export declare function instantMs(value: unknown): number | null;
+/** Row objects keyed by field name. */
+export declare function rowObjects(result: TelemetryQueryResult | null): Record<string, unknown>[];
+/** A string, or null when empty. */
+export declare function strOrNull(value: unknown): string | null;
+/** Rounded for display: whole numbers for large magnitudes, otherwise two decimals (four below 0.01). */
+export declare function roundForDisplay(value: number): number;
+/**
+ * Histogram quantile from cumulative bucket counts (`le` → count, `le` as the
+ * store writes it: `"0.05"`, `"1"`, `"inf"`), Prometheus `histogram_quantile`
+ * style: linear interpolation inside the bucket that crosses the rank; the
+ * `+Inf` bucket answers its lower bound. Null without observations.
+ */
+export declare function histogramQuantile(q: number, buckets: ReadonlyMap<string, number>): number | null;
+//# sourceMappingURL=metric-values.d.ts.map

package/dist/telemetry/metrics/metric-values.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metric-values.d.ts","sourceRoot":"","sources":["../../../src/telemetry/metrics/metric-values.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AAYxE,gCAAgC;AAChC,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAIvD;AAED,2DAA2D;AAC3D,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAMvD;AAED,uCAAuC;AACvC,wBAAgB,UAAU,CAAC,MAAM,EAAE,oBAAoB,GAAG,IAAI,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAKzF;AAED,oCAAoC;AACpC,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAEvD;AAED,yGAAyG;AACzG,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAKrD;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,GAAG,IAAI,CA2BhG"}

package/dist/telemetry/metrics/metric-values.js

@@ -0,0 +1,97 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.numOrNull = numOrNull;
+exports.instantMs = instantMs;
+exports.rowObjects = rowObjects;
+exports.strOrNull = strOrNull;
+exports.roundForDisplay = roundForDisplay;
+exports.histogramQuantile = histogramQuantile;
+// =============================================================================
+// Row helpers for the metric catalog (issue #601)
+// =============================================================================
+//
+// The reader pool returns int8/numeric and timestamps as the server's TEXT
+// (`greptime.client.ts`): a count is `'60'`, an instant is
+// `'2026-09-30 00:21:00.000000'` (UTC, no zone). These turn both into plain
+// numbers. Pure functions.
+// =============================================================================
+/** A finite number, or null. */
+function numOrNull(value) {
+    if (value === null || value === undefined || value === '')
+        return null;
+    const n = typeof value === 'number' ? value : Number(value);
+    return Number.isFinite(n) ? n : null;
+}
+/** A store instant (text or Date) as epoch ms, or null. */
+function instantMs(value) {
+    if (value === null || value === undefined || value === '')
+        return null;
+    if (value instanceof Date)
+        return Number.isFinite(value.getTime()) ? value.getTime() : null;
+    const text = String(value).replace(' ', 'T');
+    const ms = Date.parse(/[zZ]$|[+-]\d{2}:?\d{2}$/.test(text) ? text : `${text}Z`);
+    return Number.isFinite(ms) ? ms : null;
+}
+/** Row objects keyed by field name. */
+function rowObjects(result) {
+    if (!result)
+        return [];
+    return result.rows.map((row) => Object.fromEntries(result.fields.map((f, i) => [f.name, row[i]])));
+}
+/** A string, or null when empty. */
+function strOrNull(value) {
+    return value === null || value === undefined || value === '' ? null : String(value);
+}
+/** Rounded for display: whole numbers for large magnitudes, otherwise two decimals (four below 0.01). */
+function roundForDisplay(value) {
+    const abs = Math.abs(value);
+    if (abs >= 1000)
+        return Math.round(value);
+    if (abs > 0 && abs < 0.01)
+        return Math.round(value * 10_000) / 10_000;
+    return Math.round(value * 100) / 100;
+}
+/**
+ * Histogram quantile from cumulative bucket counts (`le` → count, `le` as the
+ * store writes it: `"0.05"`, `"1"`, `"inf"`), Prometheus `histogram_quantile`
+ * style: linear interpolation inside the bucket that crosses the rank; the
+ * `+Inf` bucket answers its lower bound. Null without observations.
+ */
+function histogramQuantile(q, buckets) {
+    const bounds = [...buckets.entries()]
+        .map(([le, count]) => ({ le: parseLe(le), count }))
+        .filter((b) => b.le !== null)
+        .sort((a, b) => a.le - b.le);
+    if (bounds.length === 0)
+        return null;
+    // Cumulative counts must be monotonic; a reset or a partial scrape can break
+    // that, so enforce it rather than interpolate backwards.
+    for (let i = 1; i < bounds.length; i++)
+        bounds[i].count = Math.max(bounds[i].count, bounds[i - 1].count);
+    const total = bounds[bounds.length - 1].count;
+    if (!(total > 0))
+        return null;
+    const rank = q * total;
+    for (let i = 0; i < bounds.length; i++) {
+        const { le, count } = bounds[i];
+        if (count < rank)
+            continue;
+        if (le === Number.POSITIVE_INFINITY)
+            return i > 0 ? bounds[i - 1].le : null;
+        const lower = i > 0 ? bounds[i - 1].le : 0;
+        const below = i > 0 ? bounds[i - 1].count : 0;
+        const inBucket = count - below;
+        if (inBucket <= 0)
+            return le;
+        return lower + (le - lower) * ((rank - below) / inBucket);
+    }
+    return bounds[bounds.length - 1].le;
+}
+function parseLe(le) {
+    const text = le.trim().toLowerCase();
+    if (text === 'inf' || text === '+inf')
+        return Number.POSITIVE_INFINITY;
+    const n = Number(text);
+    return Number.isFinite(n) ? n : null;
+}
+//# sourceMappingURL=metric-values.js.map

package/dist/telemetry/metrics/metric-values.js.map

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

package/dist/telemetry/metrics/metric-verdict.d.ts

@@ -0,0 +1,20 @@
+import type { VerdictInput } from '../dashboard/telemetry-dashboard.verdict';
+import type { TelemetryQueryResult } from '../greptime/greptime.client';
+import { type MetricTables } from './metric-catalog';
+/** How far before `to` the gauge probes look. */
+export declare const VERDICT_PROBE_LOOKBACK_MS: number;
+/** A key older than its part's newest reading by more than this is not current. */
+export declare const VERDICT_FRESH_MS = 150000;
+export declare const VERDICT_PROBES: readonly ["host", "database", "queue", "nodes", "uptime", "tls", "pipeline"];
+export type VerdictProbe = (typeof VERDICT_PROBES)[number];
+/** The probe statements for a window; null where no table of the probe exists. */
+export declare function verdictProbeSql(tables: MetricTables, window: {
+    from: Date;
+    to: Date;
+}): Record<VerdictProbe, string | null>;
+/**
+ * The verdict's infrastructure inputs from the probe results. A probe that
+ * did not run, or returned no fresh rows, leaves its input undefined.
+ */
+export declare function verdictInputsFrom(results: Partial<Record<VerdictProbe, TelemetryQueryResult | null>>, now: Date): Partial<VerdictInput>;
+//# sourceMappingURL=metric-verdict.d.ts.map

package/dist/telemetry/metrics/metric-verdict.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metric-verdict.d.ts","sourceRoot":"","sources":["../../../src/telemetry/metrics/metric-verdict.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0CAA0C,CAAC;AAC7E,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACxE,OAAO,EAIL,KAAK,YAAY,EAClB,MAAM,kBAAkB,CAAC;AAkC1B,iDAAiD;AACjD,eAAO,MAAM,yBAAyB,QAAc,CAAC;AACrD,mFAAmF;AACnF,eAAO,MAAM,gBAAgB,SAAU,CAAC;AAExC,eAAO,MAAM,cAAc,8EAQjB,CAAC;AACX,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,CAAC,CAAC;AAc3D,kFAAkF;AAClF,wBAAgB,eAAe,CAC7B,MAAM,EAAE,YAAY,EACpB,MAAM,EAAE;IAAE,IAAI,EAAE,IAAI,CAAC;IAAC,EAAE,EAAE,IAAI,CAAA;CAAE,GAC/B,MAAM,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC,CAwErC;AAkCD;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,YAAY,EAAE,oBAAoB,GAAG,IAAI,CAAC,CAAC,EACnE,GAAG,EAAE,IAAI,GACR,OAAO,CAAC,YAAY,CAAC,CA8EvB"}

package/dist/telemetry/metrics/metric-verdict.js

@@ -0,0 +1,218 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VERDICT_PROBES = exports.VERDICT_FRESH_MS = exports.VERDICT_PROBE_LOOKBACK_MS = void 0;
+exports.verdictProbeSql = verdictProbeSql;
+exports.verdictInputsFrom = verdictInputsFrom;
+const metric_catalog_1 = require("./metric-catalog");
+const metric_sql_1 = require("./metric-sql");
+const metric_values_1 = require("./metric-values");
+// =============================================================================
+// Verdict probes: the infrastructure inputs of the summary verdict (issue #601)
+// =============================================================================
+//
+// The summary's verdict (`computeVerdict`) gains infrastructure rules. Their
+// inputs are gathered here with ONE SMALL STATEMENT PER RULE FAMILY, run
+// inside the summary's existing `Promise.all` and result cache:
+//
+//   host      worst filesystem utilization (per mountpoint), worst memory
+//   database  latest backends and max_connections per server
+//   queue     oldest pending age per job type, last backup instant
+//   nodes     node count per health, "no eligible node" per job type
+//   uptime    per URL: latest check passed? every check failed?
+//   tls       certificate seconds left per URL
+//   pipeline  exporter points failed and sent over the window
+//
+// A statement whose tables are all absent is null (not run); a rule whose
+// input is absent is skipped by the verdict. Gauges are read over the last
+// `VERDICT_PROBE_LOOKBACK_MS` before `to` and only their FRESH keys count (a
+// key whose newest reading is more than `VERDICT_FRESH_MS` older than the
+// newest reading of its part has stopped reporting, e.g. a drained job type
+// under delta temporality). The pipeline counters use the dashboard window.
+// Request filters (service/instance) do not apply: infrastructure is shared.
+// =============================================================================
+/** How far before `to` the gauge probes look. */
+exports.VERDICT_PROBE_LOOKBACK_MS = 10 * 60_000;
+/** A key older than its part's newest reading by more than this is not current. */
+exports.VERDICT_FRESH_MS = 150_000;
+exports.VERDICT_PROBES = [
+    'host',
+    'database',
+    'queue',
+    'nodes',
+    'uptime',
+    'tls',
+    'pipeline',
+];
+const NO_FILTERS = [];
+function part(tables, name, table, keyColumn, rest) {
+    return { name, table, info: tables.get(table) ?? null, keyColumn, filters: NO_FILTERS, ...rest };
+}
+/** The probe statements for a window; null where no table of the probe exists. */
+function verdictProbeSql(tables, window) {
+    const recentFrom = new Date(Math.max(window.to.getTime() - exports.VERDICT_PROBE_LOOKBACK_MS, 0));
+    const latest = (parts, from = recentFrom) => (0, metric_sql_1.latestByKeySql)(parts, from, window.to, {}, { maxKeys: metric_sql_1.METRIC_PROBE_MAX_KEYS, order: 'part' });
+    return {
+        host: latest([
+            part(tables, 'disk', metric_catalog_1.HOST_TABLES.filesystemUtilization, 'mountpoint', {
+                seriesAggregate: 'max',
+                over: 'last',
+            }),
+            part(tables, 'memory', metric_catalog_1.HOST_TABLES.memoryUtilization, 'host_name', {
+                where: [{ column: 'state', op: '=', value: 'used' }],
+                seriesAggregate: 'max',
+                over: 'last',
+            }),
+        ]),
+        database: latest([
+            part(tables, 'backends', 'postgresql_backends', 'instance', {
+                seriesAggregate: 'sum',
+                over: 'last',
+            }),
+            part(tables, 'max', 'postgresql_connection_max', 'instance', {
+                seriesAggregate: 'max',
+                over: 'last',
+            }),
+        ]),
+        queue: latest([
+            part(tables, 'oldest', 'app_jobs_oldest_pending_age_seconds', 'job_type', {
+                seriesAggregate: 'max',
+                over: 'last',
+            }),
+            part(tables, 'backup', 'app_backup_last_success_timestamp_seconds', null, {
+                seriesAggregate: 'max',
+                over: 'max',
+            }),
+        ]),
+        nodes: latest([
+            part(tables, 'health', 'app_nodes_count', 'health', { seriesAggregate: 'sum', over: 'last' }),
+            part(tables, 'noEligible', 'app_nodes_types_no_eligible_node', 'job_type', {
+                seriesAggregate: 'max',
+                over: 'last',
+            }),
+        ]),
+        uptime: (0, metric_sql_1.uptimeStatusSql)(tables.get(metric_catalog_1.HTTPCHECK_STATUS_TABLE) ?? null, recentFrom, window.to, {}, NO_FILTERS, metric_sql_1.METRIC_PROBE_MAX_KEYS),
+        tls: latest([
+            part(tables, 'tls', 'httpcheck_tls_cert_remaining_seconds', 'http_url', {
+                seriesAggregate: 'min',
+                over: 'last',
+            }),
+        ]),
+        pipeline: latest([
+            part(tables, 'failed', 'otelcol_exporter_send_failed_metric_points_total', 'exporter', {
+                seriesAggregate: 'sum',
+                over: 'increase',
+            }),
+            part(tables, 'sent', 'otelcol_exporter_sent_metric_points_total', 'exporter', {
+                seriesAggregate: 'sum',
+                over: 'increase',
+            }),
+        ], window.from),
+    };
+}
+/** Rows of a latest-per-key probe by part, keeping only fresh keys of `last`-style parts. */
+function readings(result, fresh) {
+    const byPart = new Map();
+    for (const r of (0, metric_values_1.rowObjects)(result)) {
+        const v = (0, metric_values_1.numOrNull)(r.v);
+        if (v === null)
+            continue;
+        const m = String(r.m);
+        if (!byPart.has(m))
+            byPart.set(m, []);
+        byPart.get(m).push({ k: (0, metric_values_1.strOrNull)(r.k) ?? '', v, at: (0, metric_values_1.instantMs)(r.at) });
+    }
+    if (!fresh)
+        return byPart;
+    for (const [m, list] of byPart) {
+        const newest = Math.max(-Infinity, ...list.map((x) => x.at ?? -Infinity));
+        byPart.set(m, list.filter((x) => x.at === null || x.at >= newest - exports.VERDICT_FRESH_MS));
+    }
+    return byPart;
+}
+function worst(list, pick = 'max') {
+    if (!list || list.length === 0)
+        return null;
+    return list.reduce((a, b) => (pick === 'max' ? (b.v > a.v ? b : a) : b.v < a.v ? b : a));
+}
+/**
+ * The verdict's infrastructure inputs from the probe results. A probe that
+ * did not run, or returned no fresh rows, leaves its input undefined.
+ */
+function verdictInputsFrom(results, now) {
+    const input = {};
+    if (results.host) {
+        const host = readings(results.host, true);
+        const disk = worst(host.get('disk'));
+        if (disk)
+            input.disk = { utilizationPct: disk.v * 100, mountpoint: disk.k || null };
+        const memory = worst(host.get('memory'));
+        if (memory)
+            input.memory = { utilizationPct: memory.v * 100, host: memory.k || null };
+    }
+    if (results.database) {
+        const db = readings(results.database, true);
+        const max = new Map((db.get('max') ?? []).map((r) => [r.k, r.v]));
+        const ratios = (db.get('backends') ?? [])
+            .filter((r) => (max.get(r.k) ?? 0) > 0)
+            .map((r) => ({ ...r, v: (r.v / max.get(r.k)) * 100 }));
+        const top = worst(ratios);
+        if (top)
+            input.dbConnections = { utilizationPct: top.v, instance: top.k || null };
+    }
+    if (results.queue) {
+        const queue = readings(results.queue, true);
+        const oldest = worst(queue.get('oldest'));
+        if (oldest)
+            input.oldestPendingJob = { ageSeconds: oldest.v, jobType: oldest.k || null };
+        const backup = worst(queue.get('backup'));
+        if (backup && backup.v > 0)
+            input.backupAgeHours = Math.max(0, (now.getTime() / 1000 - backup.v) / 3600);
+    }
+    if (results.nodes) {
+        const nodes = readings(results.nodes, true);
+        const health = nodes.get('health');
+        const noEligible = nodes.get('noEligible');
+        if (health || noEligible) {
+            input.nodes = {
+                stale: (health ?? []).filter((r) => r.k === 'stale').reduce((a, r) => a + r.v, 0),
+                noEligibleNodeTypes: (noEligible ?? []).filter((r) => r.v >= 1).map((r) => r.k),
+            };
+        }
+    }
+    if (results.uptime) {
+        const rows = (0, metric_values_1.rowObjects)(results.uptime);
+        const newest = Math.max(-Infinity, ...rows.map((r) => (0, metric_values_1.instantMs)(r.last_at) ?? -Infinity));
+        const failures = rows
+            .filter((r) => {
+            const lastAt = (0, metric_values_1.instantMs)(r.last_at);
+            return lastAt !== null && lastAt >= newest - exports.VERDICT_FRESH_MS && (0, metric_values_1.numOrNull)(r.ok_now) !== 1;
+        })
+            .map((r) => ({
+            url: (0, metric_values_1.strOrNull)(r.k) ?? '',
+            checks: (0, metric_values_1.numOrNull)(r.checks) ?? 0,
+            allFailed: ((0, metric_values_1.numOrNull)(r.ok_checks) ?? 0) === 0,
+        }));
+        if (rows.length > 0)
+            input.uptimeFailures = failures;
+    }
+    if (results.tls) {
+        const soonest = worst(readings(results.tls, true).get('tls'), 'min');
+        if (soonest)
+            input.tls = { daysLeft: soonest.v / 86_400, url: soonest.k || null };
+    }
+    if (results.pipeline) {
+        const pipeline = readings(results.pipeline, false);
+        const failed = pipeline.get('failed') ?? [];
+        const sent = pipeline.get('sent') ?? [];
+        if (failed.length || sent.length) {
+            const top = worst(failed);
+            input.collector = {
+                failed: failed.reduce((a, r) => a + r.v, 0),
+                sent: sent.reduce((a, r) => a + r.v, 0),
+                exporter: top && top.v > 0 ? top.k || null : null,
+            };
+        }
+    }
+    return input;
+}
+//# sourceMappingURL=metric-verdict.js.map