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

package/dist/telemetry/metrics/groups/queue.metric-group.js

@@ -0,0 +1,163 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.QUEUE_METRIC_GROUP = void 0;
+const metric_catalog_helpers_1 = require("../metric-catalog.helpers");
+/**
+ * The `queue` metric group (app.jobs.* and app.backup.*: depth, age, settle rate, duration).
+ * The entries moved verbatim from `metric-catalog.ts` (#680); registered by `../metric-group.manifest.ts`.
+ */
+exports.QUEUE_METRIC_GROUP = {
+    id: 'queue',
+    label: 'Job queue',
+    title: 'Job queue',
+    order: 30,
+    description: 'depth, oldest pending job, settle rate, failure ratio, duration p95, last backup, per job type',
+    families: [
+        {
+            key: 'queueDepth',
+            group: 'queue',
+            label: 'Queue depth',
+            table: 'app_jobs_queue_depth',
+            kind: 'gauge',
+            unit: 'count',
+            groupBy: 'status',
+            requiredColumns: ['status', 'job_type'],
+            seriesAggregate: 'sum',
+            bucketAggregate: 'max',
+            filters: metric_catalog_helpers_1.APP_FILTERS,
+            tileGroups: ['pending', 'running'],
+        },
+        {
+            key: 'oldestPendingAge',
+            group: 'queue',
+            label: 'Oldest pending job',
+            table: 'app_jobs_oldest_pending_age_seconds',
+            kind: 'gauge',
+            unit: 'seconds',
+            groupBy: 'job_type',
+            requiredColumns: ['job_type'],
+            seriesAggregate: 'max',
+            bucketAggregate: 'max',
+            filters: metric_catalog_helpers_1.APP_FILTERS,
+            tileAggregate: 'max',
+            verdict: {
+                degraded: metric_catalog_helpers_1.T.oldestPendingJobMinutes.degraded * 60,
+                critical: metric_catalog_helpers_1.T.oldestPendingJobMinutes.critical * 60,
+                direction: 'above',
+            },
+        },
+        {
+            key: 'jobsSettled',
+            group: 'queue',
+            label: 'Jobs settled',
+            table: 'app_jobs_settled_total',
+            kind: 'counter',
+            unit: 'per_min',
+            rate: 'per_min',
+            groupBy: 'outcome',
+            requiredColumns: ['outcome', 'job_type'],
+            filters: metric_catalog_helpers_1.APP_FILTERS,
+        },
+        {
+            key: 'jobDurationP95',
+            group: 'queue',
+            label: 'Job duration p95',
+            table: 'app_jobs_duration_seconds_bucket',
+            kind: 'histogram',
+            unit: 'seconds',
+            quantile: 0.95,
+            groupBy: 'job_type',
+            requiredColumns: ['le', 'job_type'],
+            filters: metric_catalog_helpers_1.APP_FILTERS,
+            series: false,
+        },
+        {
+            key: 'backupAge',
+            group: 'queue',
+            label: 'Last successful backup',
+            table: 'app_backup_last_success_timestamp_seconds',
+            kind: 'gauge',
+            unit: 'hours',
+            requiredColumns: [],
+            seriesAggregate: 'max',
+            bucketAggregate: 'max',
+            transform: 'ageHours',
+            filters: metric_catalog_helpers_1.APP_FILTERS,
+            verdict: { ...metric_catalog_helpers_1.T.backupAgeHours, direction: 'above' },
+        },
+    ],
+    ratios: [
+        {
+            key: 'jobFailureRatio',
+            group: 'queue',
+            label: 'Job failure ratio',
+            unit: '%',
+            numerator: [{ family: 'jobsSettled', groups: ['failed'] }],
+            denominator: [{ family: 'jobsSettled', groups: ['succeeded'] }],
+            addNumerator: true,
+            scale: 100,
+        },
+    ],
+    tables: [
+        {
+            key: 'jobTypes',
+            group: 'queue',
+            label: 'Job types',
+            keyColumn: 'job_type',
+            keyLabel: 'Job type',
+            filters: metric_catalog_helpers_1.APP_FILTERS,
+            parts: [
+                {
+                    column: 'pending',
+                    label: 'Pending',
+                    unit: 'count',
+                    table: 'app_jobs_queue_depth',
+                    requiredColumns: ['status'],
+                    where: [(0, metric_catalog_helpers_1.eq)('status', 'pending')],
+                    seriesAggregate: 'max',
+                    over: 'last',
+                },
+                {
+                    column: 'running',
+                    label: 'Running',
+                    unit: 'count',
+                    table: 'app_jobs_queue_depth',
+                    requiredColumns: ['status'],
+                    where: [(0, metric_catalog_helpers_1.eq)('status', 'running')],
+                    seriesAggregate: 'max',
+                    over: 'last',
+                },
+                {
+                    column: 'oldestPendingSeconds',
+                    label: 'Oldest pending',
+                    unit: 'seconds',
+                    table: 'app_jobs_oldest_pending_age_seconds',
+                    seriesAggregate: 'max',
+                    over: 'last',
+                },
+                {
+                    column: 'succeeded',
+                    label: 'Succeeded',
+                    unit: 'count',
+                    table: 'app_jobs_settled_total',
+                    requiredColumns: ['outcome'],
+                    where: [(0, metric_catalog_helpers_1.eq)('outcome', 'succeeded')],
+                    seriesAggregate: 'sum',
+                    over: 'increase',
+                },
+                {
+                    column: 'failed',
+                    label: 'Failed',
+                    unit: 'count',
+                    table: 'app_jobs_settled_total',
+                    requiredColumns: ['outcome'],
+                    where: [(0, metric_catalog_helpers_1.eq)('outcome', 'failed')],
+                    seriesAggregate: 'sum',
+                    over: 'increase',
+                },
+            ],
+            histogram: { column: 'durationP95Seconds', label: 'Duration p95', family: 'jobDurationP95' },
+        },
+    ],
+};
+//# sourceMappingURL=queue.metric-group.js.map

package/dist/telemetry/metrics/groups/queue.metric-group.js.map

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

package/dist/telemetry/metrics/groups/uptime.metric-group.d.ts

@@ -0,0 +1,7 @@
+import type { MetricGroupDef } from '../metric-group.registry';
+/**
+ * The `uptime` metric group (httpcheck and nginx: status per URL, latency, TLS, edge traffic).
+ * The entries moved verbatim from `metric-catalog.ts` (#680); registered by `../metric-group.manifest.ts`.
+ */
+export declare const UPTIME_METRIC_GROUP: MetricGroupDef;
+//# sourceMappingURL=uptime.metric-group.d.ts.map

package/dist/telemetry/metrics/groups/uptime.metric-group.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"uptime.metric-group.d.ts","sourceRoot":"","sources":["../../../../src/telemetry/metrics/groups/uptime.metric-group.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAG/D;;;GAGG;AACH,eAAO,MAAM,mBAAmB,EAAE,cA6FjC,CAAC"}

package/dist/telemetry/metrics/groups/uptime.metric-group.js

@@ -0,0 +1,103 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UPTIME_METRIC_GROUP = void 0;
+const metric_catalog_helpers_1 = require("../metric-catalog.helpers");
+/**
+ * The `uptime` metric group (httpcheck and nginx: status per URL, latency, TLS, edge traffic).
+ * The entries moved verbatim from `metric-catalog.ts` (#680); registered by `../metric-group.manifest.ts`.
+ */
+exports.UPTIME_METRIC_GROUP = {
+    id: 'uptime',
+    label: 'Uptime and edge',
+    title: 'Uptime & dependencies',
+    order: 50,
+    description: 'checks per URL, TLS days left, nginx',
+    families: [
+        {
+            key: 'httpDuration',
+            group: 'uptime',
+            label: 'Check duration',
+            table: 'httpcheck_duration_milliseconds',
+            kind: 'gauge',
+            unit: 'ms',
+            groupBy: 'http_url',
+            requiredColumns: ['http_url'],
+            seriesAggregate: 'max',
+            bucketAggregate: 'avg',
+            filters: metric_catalog_helpers_1.HOST_FILTERS,
+            tileAggregate: 'max',
+        },
+        {
+            key: 'tlsDaysLeft',
+            group: 'uptime',
+            label: 'TLS certificate days left',
+            table: 'httpcheck_tls_cert_remaining_seconds',
+            kind: 'gauge',
+            unit: 'days',
+            groupBy: 'http_url',
+            requiredColumns: ['http_url'],
+            seriesAggregate: 'min',
+            bucketAggregate: 'min',
+            scale: 1 / 86_400,
+            filters: metric_catalog_helpers_1.HOST_FILTERS,
+            tileAggregate: 'min',
+            verdict: { ...metric_catalog_helpers_1.T.tlsDaysLeft, direction: 'below' },
+        },
+        {
+            key: 'nginxRequests',
+            group: 'uptime',
+            label: 'nginx requests',
+            table: 'nginx_requests_total',
+            kind: 'counter',
+            unit: 'per_s',
+            rate: 'per_s',
+            requiredColumns: ['host_name'],
+            filters: metric_catalog_helpers_1.HOST_FILTERS,
+        },
+        {
+            key: 'nginxConnections',
+            group: 'uptime',
+            label: 'nginx connections',
+            table: 'nginx_connections_current',
+            kind: 'gauge',
+            unit: 'count',
+            groupBy: 'state',
+            requiredColumns: ['state', 'host_name'],
+            seriesAggregate: 'sum',
+            bucketAggregate: 'max',
+            filters: metric_catalog_helpers_1.HOST_FILTERS,
+            tileGroups: ['active'],
+        },
+    ],
+    tables: [
+        {
+            key: 'uptimeTargets',
+            group: 'uptime',
+            label: 'Uptime targets',
+            keyColumn: 'http_url',
+            keyLabel: 'URL',
+            filters: metric_catalog_helpers_1.HOST_FILTERS,
+            httpcheck: true,
+            parts: [
+                {
+                    column: 'durationMs',
+                    label: 'Duration',
+                    unit: 'ms',
+                    table: 'httpcheck_duration_milliseconds',
+                    seriesAggregate: 'max',
+                    over: 'last',
+                },
+                {
+                    column: 'tlsDaysLeft',
+                    label: 'TLS days left',
+                    unit: 'days',
+                    table: 'httpcheck_tls_cert_remaining_seconds',
+                    seriesAggregate: 'min',
+                    over: 'last',
+                    scale: 1 / 86_400,
+                },
+            ],
+        },
+    ],
+};
+//# sourceMappingURL=uptime.metric-group.js.map

package/dist/telemetry/metrics/groups/uptime.metric-group.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"uptime.metric-group.js","sourceRoot":"","sources":["../../../../src/telemetry/metrics/groups/uptime.metric-group.ts"],"names":[],"mappings":";;;AACA,sEAA4D;AAE5D;;;GAGG;AACU,QAAA,mBAAmB,GAAmB;IACjD,EAAE,EAAE,QAAQ;IACZ,KAAK,EAAE,iBAAiB;IACxB,KAAK,EAAE,uBAAuB;IAC9B,KAAK,EAAE,EAAE;IACT,WAAW,EAAE,sCAAsC;IACnD,QAAQ,EAAE;QACR;YACE,GAAG,EAAE,cAAc;YACnB,KAAK,EAAE,QAAQ;YACf,KAAK,EAAE,gBAAgB;YACvB,KAAK,EAAE,iCAAiC;YACxC,IAAI,EAAE,OAAO;YACb,IAAI,EAAE,IAAI;YACV,OAAO,EAAE,UAAU;YACnB,eAAe,EAAE,CAAC,UAAU,CAAC;YAC7B,eAAe,EAAE,KAAK;YACtB,eAAe,EAAE,KAAK;YACtB,OAAO,EAAE,qCAAY;YACrB,aAAa,EAAE,KAAK;SACrB;QACD;YACE,GAAG,EAAE,aAAa;YAClB,KAAK,EAAE,QAAQ;YACf,KAAK,EAAE,2BAA2B;YAClC,KAAK,EAAE,sCAAsC;YAC7C,IAAI,EAAE,OAAO;YACb,IAAI,EAAE,MAAM;YACZ,OAAO,EAAE,UAAU;YACnB,eAAe,EAAE,CAAC,UAAU,CAAC;YAC7B,eAAe,EAAE,KAAK;YACtB,eAAe,EAAE,KAAK;YACtB,KAAK,EAAE,CAAC,GAAG,MAAM;YACjB,OAAO,EAAE,qCAAY;YACrB,aAAa,EAAE,KAAK;YACpB,OAAO,EAAE,EAAE,GAAG,0BAAC,CAAC,WAAW,EAAE,SAAS,EAAE,OAAO,EAAE;SAClD;QACD;YACE,GAAG,EAAE,eAAe;YACpB,KAAK,EAAE,QAAQ;YACf,KAAK,EAAE,gBAAgB;YACvB,KAAK,EAAE,sBAAsB;YAC7B,IAAI,EAAE,SAAS;YACf,IAAI,EAAE,OAAO;YACb,IAAI,EAAE,OAAO;YACb,eAAe,EAAE,CAAC,WAAW,CAAC;YAC9B,OAAO,EAAE,qCAAY;SACtB;QACD;YACE,GAAG,EAAE,kBAAkB;YACvB,KAAK,EAAE,QAAQ;YACf,KAAK,EAAE,mBAAmB;YAC1B,KAAK,EAAE,2BAA2B;YAClC,IAAI,EAAE,OAAO;YACb,IAAI,EAAE,OAAO;YACb,OAAO,EAAE,OAAO;YAChB,eAAe,EAAE,CAAC,OAAO,EAAE,WAAW,CAAC;YACvC,eAAe,EAAE,KAAK;YACtB,eAAe,EAAE,KAAK;YACtB,OAAO,EAAE,qCAAY;YACrB,UAAU,EAAE,CAAC,QAAQ,CAAC;SACvB;KACF;IACD,MAAM,EAAE;QACN;YACE,GAAG,EAAE,eAAe;YACpB,KAAK,EAAE,QAAQ;YACf,KAAK,EAAE,gBAAgB;YACvB,SAAS,EAAE,UAAU;YACrB,QAAQ,EAAE,KAAK;YACf,OAAO,EAAE,qCAAY;YACrB,SAAS,EAAE,IAAI;YACf,KAAK,EAAE;gBACL;oBACE,MAAM,EAAE,YAAY;oBACpB,KAAK,EAAE,UAAU;oBACjB,IAAI,EAAE,IAAI;oBACV,KAAK,EAAE,iCAAiC;oBACxC,eAAe,EAAE,KAAK;oBACtB,IAAI,EAAE,MAAM;iBACb;gBACD;oBACE,MAAM,EAAE,aAAa;oBACrB,KAAK,EAAE,eAAe;oBACtB,IAAI,EAAE,MAAM;oBACZ,KAAK,EAAE,sCAAsC;oBAC7C,eAAe,EAAE,KAAK;oBACtB,IAAI,EAAE,MAAM;oBACZ,KAAK,EAAE,CAAC,GAAG,MAAM;iBAClB;aACF;SACF;KACF;CACF,CAAC"}

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

@@ -0,0 +1,324 @@
+import type { TelemetrySchema } from '../dto/telemetry-query.dto';
+import './metric-group.manifest';
+import { METRIC_UNITS } from './metric-catalog.helpers';
+import { type MetricGroup, type MetricGroupDef } from './metric-group.registry';
+export { APP_FILTERS, eq, HOST_FILTERS, HOST_TABLES, LARGEST_TABLES_MAX_ROWS, METRIC_FILTER_COLUMNS, METRIC_UNITS, } from './metric-catalog.helpers';
+export { METRIC_GROUP_ID_PATTERN, metricGroupRegistry, registerMetricGroups, type MetricGroup, type MetricGroupDef, type MetricGroupIds, } from './metric-group.registry';
+/**
+ * The unit of a family, ratio or table column (the contract's `METRIC_UNITS`).
+ *
+ * @stability stable
+ */
+export type MetricUnit = (typeof METRIC_UNITS)[number];
+/**
+ * The request filters a family may honour (`METRIC_FILTER_COLUMNS` maps each to its column).
+ *
+ * @stability stable
+ */
+export type MetricFilterKey = 'service' | 'instance' | 'host';
+export declare const METRIC_TIME_COLUMN = "greptime_timestamp";
+export declare const METRIC_VALUE_COLUMN = "greptime_value";
+/**
+ * A fixed label predicate. Values are catalog constants, never request input.
+ *
+ * @stability stable
+ */
+export interface MetricPredicate {
+    /** The tag column. */
+    column: string;
+    /** Equals or differs. */
+    op: '=' | '<>';
+    /** The constant compared with. */
+    value: string;
+}
+/**
+ * How a gauge's rows of one timestamp combine across series.
+ *
+ * @stability stable
+ */
+export type SeriesAggregate = 'sum' | 'max' | 'min' | 'avg';
+/**
+ * How a gauge's per-timestamp values combine within one bucket.
+ *
+ * @stability stable
+ */
+export type BucketAggregate = 'avg' | 'max' | 'min';
+/**
+ * How a family's groups combine into one tile.
+ *
+ * @stability stable
+ */
+export type TileAggregate = 'sum' | 'max' | 'min' | 'countPositive' | 'countZero';
+/**
+ * The verdict thresholds a family documents (the rule itself lives in the verdict).
+ *
+ * @stability stable
+ */
+export interface MetricVerdictThresholds {
+    /** The degraded bound. */
+    degraded: number;
+    /** The critical bound. */
+    critical: number;
+    /** `above`: `value >= threshold` fires; `below`: `value < threshold` fires. */
+    direction: 'above' | 'below';
+}
+interface MetricFamilyBase {
+    /** Unique across every family, ratio and table of every group: names a tile, a series and a `skipped` entry. */
+    key: string;
+    /** The group that declares the family. */
+    group: MetricGroup;
+    /** The tile and series label. */
+    label: string;
+    /** The metric table it reads. */
+    table: string;
+    /** The displayed unit. */
+    unit: MetricUnit;
+    /** Tag columns the family reads, beyond the time and value columns. Absent → skipped. */
+    requiredColumns: readonly string[];
+    /** Fixed label predicates. */
+    where?: readonly MetricPredicate[];
+    /** The label column series are split by (one series per value). */
+    groupBy?: string;
+    /** Which request filters apply. */
+    filters: readonly MetricFilterKey[];
+    /** How groups combine into the tile (default: `sum`). */
+    tileAggregate?: TileAggregate;
+    /** One tile per listed group value instead of one combined tile. */
+    tileGroups?: readonly string[];
+    /** Emit a tile (default true). */
+    tile?: boolean;
+    /** Emit series (default true). */
+    series?: boolean;
+    /** The verdict thresholds the summary applies to this family (documentary; the rule lives in the verdict). */
+    verdict?: MetricVerdictThresholds;
+}
+/**
+ * A level (a gauge table).
+ *
+ * @stability stable
+ */
+export interface GaugeFamily extends MetricFamilyBase {
+    /** Always `gauge`. */
+    kind: 'gauge';
+    /** Per-row value expression (fixed SQL over `greptime_value`); default the value itself. */
+    valueSql?: string;
+    /** How the rows of one timestamp combine across series (sum for "how many", max for "the worst"). */
+    seriesAggregate: SeriesAggregate;
+    /** How the per-timestamp values combine within a bucket. */
+    bucketAggregate: BucketAggregate;
+    /** Display multiplier (ratio → %: 100). */
+    scale?: number;
+    /** `ageHours`: the value is a Unix-seconds instant, shown as hours before the bucket end (or now). */
+    transform?: 'ageHours';
+}
+/**
+ * A cumulative counter (`_total`): reset-aware increases per series.
+ *
+ * @stability stable
+ */
+export interface CounterFamily extends MetricFamilyBase {
+    /** Always `counter`. */
+    kind: 'counter';
+    /** `per_s` / `per_min`: increase over time; `count`: the increase itself. */
+    rate: 'per_s' | 'per_min' | 'count';
+    /** Display multiplier applied after the rate. */
+    scale?: number;
+}
+/**
+ * Cumulative `_bucket` counters with a string `le` tag; the quantile is
+ * interpolated from the increases per `le`.
+ *
+ * @stability stable
+ */
+export interface HistogramFamily extends MetricFamilyBase {
+    /** Always `histogram`. */
+    kind: 'histogram';
+    /** The quantile shown, e.g. 0.95. */
+    quantile: number;
+    /** Display multiplier (s → ms: 1000). */
+    scale?: number;
+}
+/**
+ * One metric family of a group.
+ *
+ * @stability stable
+ */
+export type MetricFamily = GaugeFamily | CounterFamily | HistogramFamily;
+/**
+ * A reference to (some groups of) a family, for ratios.
+ *
+ * @stability stable
+ */
+export interface MetricRef {
+    /** The referenced family's key. */
+    family: string;
+    /** Only these group values (default: every group). */
+    groups?: readonly string[];
+}
+/**
+ * A family derived from others: `sum(numerator) / sum(denominator) * scale`, bucket by bucket.
+ *
+ * @stability stable
+ */
+export interface MetricRatio {
+    /** Unique across every family, ratio and table key. */
+    key: string;
+    /** The group that declares it. */
+    group: MetricGroup;
+    /** The tile label. */
+    label: string;
+    /** The displayed unit. */
+    unit: MetricUnit;
+    /** The numerator families. */
+    numerator: readonly MetricRef[];
+    /** The denominator; `numerator` is added to it when `addNumerator` (hit / (hit + read)). */
+    denominator: readonly MetricRef[];
+    /** Add the numerator to the denominator. */
+    addNumerator?: boolean;
+    /** Display multiplier (ratio → %: 100). */
+    scale: number;
+    /** Documentary verdict thresholds. */
+    verdict?: MetricVerdictThresholds;
+}
+/**
+ * One column of a per-key table, read as the latest (or max/min/increase/count) value per key.
+ *
+ * @stability stable
+ */
+export interface MetricTablePart {
+    /** The output column name. */
+    column: string;
+    /** Its header. */
+    label: string;
+    /** Its unit. */
+    unit: MetricUnit;
+    /** The metric table it reads. */
+    table: string;
+    /** Tag columns needed beyond the key column. */
+    requiredColumns?: readonly string[];
+    /** Per-row value expression (fixed SQL); default the value itself. */
+    valueSql?: string;
+    /** Fixed label predicates. */
+    where?: readonly MetricPredicate[];
+    /** Per timestamp across series sharing the key. */
+    seriesAggregate: SeriesAggregate;
+    /** Over the window: the latest value, an extreme, the counter increase, or the number of timestamps. */
+    over: 'last' | 'max' | 'min' | 'increase' | 'count';
+    /** Display multiplier. */
+    scale?: number;
+}
+/**
+ * A computed column of a table: `numerator / denominator * scale` (both are part columns).
+ *
+ * @stability stable
+ */
+export interface MetricTableDerived {
+    /** The output column name. */
+    column: string;
+    /** Its header. */
+    label: string;
+    /** Its unit. */
+    unit: MetricUnit;
+    /** The numerator part column. */
+    numerator: string;
+    /** The denominator part column. */
+    denominator: string;
+    /** Display multiplier. */
+    scale: number;
+}
+/**
+ * A per-key table of a group (one row per value of `keyColumn`).
+ *
+ * @stability stable
+ */
+export interface MetricTableSpec {
+    /** Unique across every family, ratio and table key. */
+    key: string;
+    /** The group that declares it. */
+    group: MetricGroup;
+    /** The table's title. */
+    label: string;
+    /** The label column every part is keyed by (one row per value). */
+    keyColumn: string;
+    /** The key column's header. */
+    keyLabel: string;
+    /** Which request filters apply. */
+    filters: readonly MetricFilterKey[];
+    /** The columns read per key. */
+    parts: readonly MetricTablePart[];
+    /** Columns computed from the parts. */
+    derived?: readonly MetricTableDerived[];
+    /** Order rows by the first part's value, descending (the statement then has ONE part). */
+    orderByValue?: boolean;
+    /** Extra per-key columns from a histogram family (quantile per key). */
+    histogram?: {
+        /** The output column name. */
+        column: string;
+        /** Its header. */
+        label: string;
+        /** The histogram family's key. */
+        family: string;
+    };
+    /** Extra per-URL status columns from `httpcheck_status` / `httpcheck_error`. */
+    httpcheck?: boolean;
+    /** Rows this table returns at most; default `METRIC_TABLE_MAX_ROWS` (#632). */
+    maxRows?: number;
+}
+/** Where `/filters` reads the distinct host names from: small, always written by hostmetrics. */
+export declare const HOST_DISTINCT_TABLE: "system_cpu_load_average_1m";
+export declare const HTTPCHECK_STATUS_TABLE = "httpcheck_status";
+export declare const HTTPCHECK_ERROR_TABLE = "httpcheck_error";
+/**
+ * Every registered group id, in dashboard order. Non-empty (the platform registers six).
+ *
+ * @stability experimental
+ */
+export declare const METRIC_GROUPS: readonly [MetricGroup, ...MetricGroup[]];
+/**
+ * The API label of every group (the dashboard section title is `MetricGroupDef.title`).
+ *
+ * @stability experimental
+ */
+export declare const METRIC_GROUP_LABELS: Readonly<Record<MetricGroup, string>>;
+export declare const METRIC_FAMILIES: readonly MetricFamily[];
+export declare const METRIC_RATIOS: readonly MetricRatio[];
+export declare const METRIC_TABLES: readonly MetricTableSpec[];
+/**
+ * Every registered group, in dashboard order, read live from the registry.
+ *
+ * @stability experimental
+ */
+export declare function metricGroups(): MetricGroupDef[];
+/**
+ * Every registered group id, in dashboard order, read live from the registry.
+ *
+ * @stability experimental
+ */
+export declare function metricGroupIds(): MetricGroup[];
+/**
+ * Whether `id` names a registered group.
+ *
+ * @stability experimental
+ */
+export declare function isMetricGroup(id: unknown): id is MetricGroup;
+export declare function familiesOf(group: MetricGroup): MetricFamily[];
+export declare function ratiosOf(group: MetricGroup): MetricRatio[];
+export declare function tablesOf(group: MetricGroup): MetricTableSpec[];
+export declare function familyByKey(key: string): MetricFamily | undefined;
+/** One metric table as the store describes it. */
+export interface MetricTableInfo {
+    columns: ReadonlySet<string>;
+    /** Tag columns: every series-identifying column (the `lag` partition of a counter). */
+    tags: readonly string[];
+}
+/** Discovered metric tables, by name. A table absent here does not exist (yet). */
+export type MetricTables = ReadonlyMap<string, MetricTableInfo>;
+/**
+ * Every table of the schema that looks like a metric table (has the time and
+ * value columns), with its tag columns: `semantic_type = 'TAG'` where the
+ * store reports it, else every column but the time and value.
+ */
+export declare function metricTablesOf(schema: TelemetrySchema): MetricTables;
+/** The table's info when it exists with every required column, else null. */
+export declare function tableWith(tables: MetricTables, table: string, required: readonly string[]): MetricTableInfo | null;
+//# sourceMappingURL=metric-catalog.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"metric-catalog.d.ts","sourceRoot":"","sources":["../../../src/telemetry/metrics/metric-catalog.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAClE,OAAO,yBAAyB,CAAC;AACjC,OAAO,EAAe,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACrE,OAAO,EAAuB,KAAK,WAAW,EAAE,KAAK,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAqDrG,OAAO,EACL,WAAW,EACX,EAAE,EACF,YAAY,EACZ,WAAW,EACX,uBAAuB,EACvB,qBAAqB,EACrB,YAAY,GACb,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,uBAAuB,EACvB,mBAAmB,EACnB,oBAAoB,EACpB,KAAK,WAAW,EAChB,KAAK,cAAc,EACnB,KAAK,cAAc,GACpB,MAAM,yBAAyB,CAAC;AAEjC;;;;GAIG;AACH,MAAM,MAAM,UAAU,GAAG,CAAC,OAAO,YAAY,CAAC,CAAC,MAAM,CAAC,CAAC;AAEvD;;;;GAIG;AACH,MAAM,MAAM,eAAe,GAAG,SAAS,GAAG,UAAU,GAAG,MAAM,CAAC;AAE9D,eAAO,MAAM,kBAAkB,uBAAuB,CAAC;AACvD,eAAO,MAAM,mBAAmB,mBAAmB,CAAC;AAEpD;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,sBAAsB;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,yBAAyB;IACzB,EAAE,EAAE,GAAG,GAAG,IAAI,CAAC;IACf,kCAAkC;IAClC,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;GAIG;AACH,MAAM,MAAM,eAAe,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,CAAC;AAC5D;;;;GAIG;AACH,MAAM,MAAM,eAAe,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,CAAC;AACpD;;;;GAIG;AACH,MAAM,MAAM,aAAa,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,eAAe,GAAG,WAAW,CAAC;AAElF;;;;GAIG;AACH,MAAM,WAAW,uBAAuB;IACtC,0BAA0B;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,0BAA0B;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,+EAA+E;IAC/E,SAAS,EAAE,OAAO,GAAG,OAAO,CAAC;CAC9B;AAED,UAAU,gBAAgB;IACxB,gHAAgH;IAChH,GAAG,EAAE,MAAM,CAAC;IACZ,0CAA0C;IAC1C,KAAK,EAAE,WAAW,CAAC;IACnB,iCAAiC;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,iCAAiC;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,0BAA0B;IAC1B,IAAI,EAAE,UAAU,CAAC;IACjB,yFAAyF;IACzF,eAAe,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,8BAA8B;IAC9B,KAAK,CAAC,EAAE,SAAS,eAAe,EAAE,CAAC;IACnC,mEAAmE;IACnE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,mCAAmC;IACnC,OAAO,EAAE,SAAS,eAAe,EAAE,CAAC;IACpC,yDAAyD;IACzD,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,oEAAoE;IACpE,UAAU,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC/B,kCAAkC;IAClC,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,kCAAkC;IAClC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,8GAA8G;IAC9G,OAAO,CAAC,EAAE,uBAAuB,CAAC;CACnC;AAED;;;;GAIG;AACH,MAAM,WAAW,WAAY,SAAQ,gBAAgB;IACnD,sBAAsB;IACtB,IAAI,EAAE,OAAO,CAAC;IACd,4FAA4F;IAC5F,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,qGAAqG;IACrG,eAAe,EAAE,eAAe,CAAC;IACjC,4DAA4D;IAC5D,eAAe,EAAE,eAAe,CAAC;IACjC,2CAA2C;IAC3C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,sGAAsG;IACtG,SAAS,CAAC,EAAE,UAAU,CAAC;CACxB;AAED;;;;GAIG;AACH,MAAM,WAAW,aAAc,SAAQ,gBAAgB;IACrD,wBAAwB;IACxB,IAAI,EAAE,SAAS,CAAC;IAChB,6EAA6E;IAC7E,IAAI,EAAE,OAAO,GAAG,SAAS,GAAG,OAAO,CAAC;IACpC,iDAAiD;IACjD,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;GAKG;AACH,MAAM,WAAW,eAAgB,SAAQ,gBAAgB;IACvD,0BAA0B;IAC1B,IAAI,EAAE,WAAW,CAAC;IAClB,qCAAqC;IACrC,QAAQ,EAAE,MAAM,CAAC;IACjB,yCAAyC;IACzC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;GAIG;AACH,MAAM,MAAM,YAAY,GAAG,WAAW,GAAG,aAAa,GAAG,eAAe,CAAC;AAEzE;;;;GAIG;AACH,MAAM,WAAW,SAAS;IACxB,mCAAmC;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,sDAAsD;IACtD,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC5B;AAED;;;;GAIG;AACH,MAAM,WAAW,WAAW;IAC1B,uDAAuD;IACvD,GAAG,EAAE,MAAM,CAAC;IACZ,kCAAkC;IAClC,KAAK,EAAE,WAAW,CAAC;IACnB,sBAAsB;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,0BAA0B;IAC1B,IAAI,EAAE,UAAU,CAAC;IACjB,8BAA8B;IAC9B,SAAS,EAAE,SAAS,SAAS,EAAE,CAAC;IAChC,4FAA4F;IAC5F,WAAW,EAAE,SAAS,SAAS,EAAE,CAAC;IAClC,4CAA4C;IAC5C,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,2CAA2C;IAC3C,KAAK,EAAE,MAAM,CAAC;IACd,sCAAsC;IACtC,OAAO,CAAC,EAAE,uBAAuB,CAAC;CACnC;AAED;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,8BAA8B;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,kBAAkB;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,gBAAgB;IAChB,IAAI,EAAE,UAAU,CAAC;IACjB,iCAAiC;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,gDAAgD;IAChD,eAAe,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,sEAAsE;IACtE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,8BAA8B;IAC9B,KAAK,CAAC,EAAE,SAAS,eAAe,EAAE,CAAC;IACnC,mDAAmD;IACnD,eAAe,EAAE,eAAe,CAAC;IACjC,wGAAwG;IACxG,IAAI,EAAE,MAAM,GAAG,KAAK,GAAG,KAAK,GAAG,UAAU,GAAG,OAAO,CAAC;IACpD,0BAA0B;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IACjC,8BAA8B;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,kBAAkB;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,gBAAgB;IAChB,IAAI,EAAE,UAAU,CAAC;IACjB,iCAAiC;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,mCAAmC;IACnC,WAAW,EAAE,MAAM,CAAC;IACpB,0BAA0B;IAC1B,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,uDAAuD;IACvD,GAAG,EAAE,MAAM,CAAC;IACZ,kCAAkC;IAClC,KAAK,EAAE,WAAW,CAAC;IACnB,yBAAyB;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,mEAAmE;IACnE,SAAS,EAAE,MAAM,CAAC;IAClB,+BAA+B;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,mCAAmC;IACnC,OAAO,EAAE,SAAS,eAAe,EAAE,CAAC;IACpC,gCAAgC;IAChC,KAAK,EAAE,SAAS,eAAe,EAAE,CAAC;IAClC,uCAAuC;IACvC,OAAO,CAAC,EAAE,SAAS,kBAAkB,EAAE,CAAC;IACxC,0FAA0F;IAC1F,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,wEAAwE;IACxE,SAAS,CAAC,EAAE;QACV,8BAA8B;QAC9B,MAAM,EAAE,MAAM,CAAC;QACf,kBAAkB;QAClB,KAAK,EAAE,MAAM,CAAC;QACd,kCAAkC;QAClC,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC;IACF,gFAAgF;IAChF,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,+EAA+E;IAC/E,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,iGAAiG;AACjG,eAAO,MAAM,mBAAmB,8BAAqB,CAAC;AAEtD,eAAO,MAAM,sBAAsB,qBAAqB,CAAC;AACzD,eAAO,MAAM,qBAAqB,oBAAoB,CAAC;AAcvD;;;;GAIG;AACH,eAAO,MAAM,aAAa,EAA0D,SAAS,CAC3F,WAAW,EACX,GAAG,WAAW,EAAE,CACjB,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,EAAE,QAAQ,CAAC,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC,CAErE,CAAC;AAEF,eAAO,MAAM,eAAe,EAAE,SAAS,YAAY,EAAuE,CAAC;AAC3H,eAAO,MAAM,aAAa,EAAE,SAAS,WAAW,EAA6E,CAAC;AAC9H,eAAO,MAAM,aAAa,EAAE,SAAS,eAAe,EAA6E,CAAC;AAIlI;;;;GAIG;AACH,wBAAgB,YAAY,IAAI,cAAc,EAAE,CAE/C;AAED;;;;GAIG;AACH,wBAAgB,cAAc,IAAI,WAAW,EAAE,CAE9C;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,EAAE,EAAE,OAAO,GAAG,EAAE,IAAI,WAAW,CAE5D;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,WAAW,GAAG,YAAY,EAAE,CAE7D;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,WAAW,GAAG,WAAW,EAAE,CAE1D;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,WAAW,GAAG,eAAe,EAAE,CAE9D;AAED,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAMjE;AAID,kDAAkD;AAClD,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAC7B,uFAAuF;IACvF,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;CACzB;AAED,mFAAmF;AACnF,MAAM,MAAM,YAAY,GAAG,WAAW,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;AAEhE;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,eAAe,GAAG,YAAY,CAiBpE;AAED,6EAA6E;AAC7E,wBAAgB,SAAS,CACvB,MAAM,EAAE,YAAY,EACpB,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,SAAS,MAAM,EAAE,GAC1B,eAAe,GAAG,IAAI,CAIxB"}

package/dist/telemetry/metrics/metric-catalog.helpers.d.ts

@@ -0,0 +1,30 @@
+import { METRIC_UNITS } from '@marinoscar/platform-contract/telemetry';
+import type { MetricFilterKey, MetricPredicate } from './metric-catalog';
+/** Display units of tiles, series and table columns (part of the wire: `@marinoscar/platform-contract/telemetry`, #702). */
+export { METRIC_UNITS };
+/**
+ * The request filters a family may honour, and the column each one matches.
+ *
+ * @stability experimental
+ */
+export declare const METRIC_FILTER_COLUMNS: Record<MetricFilterKey, string>;
+/** API tables (`app_*`): the service and the instance id. Their `host_name` is the API container, not a host. */
+export declare const APP_FILTERS: readonly MetricFilterKey[];
+/** Tables the collector scraped itself: `host_name` is the real host. */
+export declare const HOST_FILTERS: readonly MetricFilterKey[];
+export declare const HOST_TABLES: {
+    readonly cpuUtilization: "system_cpu_utilization_ratio";
+    readonly memoryUtilization: "system_memory_utilization_ratio";
+    readonly load1m: "system_cpu_load_average_1m";
+    readonly filesystemUtilization: "system_filesystem_utilization_ratio";
+    readonly filesystemUsage: "system_filesystem_usage_bytes";
+    readonly diskIo: "system_disk_io_bytes_total";
+    readonly networkIo: "system_network_io_bytes_total";
+};
+/** Rows of `largestTables`: every table of a realistic schema; bounded so a runaway schema can't blow the payload (#632). */
+export declare const LARGEST_TABLES_MAX_ROWS = 500;
+/** The dashboard's verdict thresholds, which several families declare (documentary). */
+export declare const T: import("../dashboard/telemetry-dashboard.verdict").VerdictThresholds;
+/** A fixed label predicate. Values are catalog constants, never request input. */
+export declare const eq: (column: string, value: string) => MetricPredicate;
+//# sourceMappingURL=metric-catalog.helpers.d.ts.map

package/dist/telemetry/metrics/metric-catalog.helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metric-catalog.helpers.d.ts","sourceRoot":"","sources":["../../../src/telemetry/metrics/metric-catalog.helpers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,yCAAyC,CAAC;AAGvE,OAAO,KAAK,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAoBzE,4HAA4H;AAC5H,OAAO,EAAE,YAAY,EAAE,CAAC;AAExB;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,EAAE,MAAM,CAAC,eAAe,EAAE,MAAM,CAIjE,CAAC;AAEF,iHAAiH;AACjH,eAAO,MAAM,WAAW,EAAE,SAAS,eAAe,EAA4B,CAAC;AAC/E,yEAAyE;AACzE,eAAO,MAAM,YAAY,EAAE,SAAS,eAAe,EAAa,CAAC;AAEjE,eAAO,MAAM,WAAW;;;;;;;;CAQd,CAAC;AAEX,6HAA6H;AAC7H,eAAO,MAAM,uBAAuB,MAAM,CAAC;AAE3C,wFAAwF;AACxF,eAAO,MAAM,CAAC,sEAA6B,CAAC;AAE5C,kFAAkF;AAClF,eAAO,MAAM,EAAE,GAAI,QAAQ,MAAM,EAAE,OAAO,MAAM,KAAG,eAA+C,CAAC"}