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

package/dist/telemetry/dashboard/telemetry-dashboard.controller.js

@@ -0,0 +1,342 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createTelemetryDashboardController = createTelemetryDashboardController;
+const common_1 = require("@nestjs/common");
+const swagger_1 = require("@nestjs/swagger");
+const nestjs_zod_1 = require("nestjs-zod");
+const index_1 = require("../../core/index");
+const telemetry_dashboard_dto_1 = require("../dto/telemetry-dashboard.dto");
+const metric_catalog_1 = require("../metrics/metric-catalog");
+const metric_presentation_1 = require("../metrics/metric-presentation");
+const telemetry_dashboard_service_1 = require("./telemetry-dashboard.service");
+const telemetry_dashboard_panel_service_1 = require("./panels/telemetry-dashboard-panel.service");
+const telemetry_permissions_1 = require("../telemetry.permissions");
+// =============================================================================
+// TelemetryDashboardController (issue #577, epic #576)
+// =============================================================================
+//
+//   GET /api/admin/telemetry/dashboard/summary      telemetry:query
+//   GET /api/admin/telemetry/dashboard/timeseries   telemetry:query
+//   GET /api/admin/telemetry/dashboard/top          telemetry:query
+//   GET /api/admin/telemetry/dashboard/events       telemetry:query
+//   GET /api/admin/telemetry/dashboard/filters      telemetry:query
+//   GET /api/admin/telemetry/dashboard/metrics      telemetry:query   (#601)
+//   GET /api/admin/telemetry/dashboard/metric-groups telemetry:query  (#680)
+//   GET /api/admin/telemetry/dashboard/panels        telemetry:query  (PP-14.18)
+//   GET /api/admin/telemetry/dashboard/panels/:id    telemetry:query  (PP-14.18)
+//
+// Same permission as the explorer: these read telemetry DATA. Every statement
+// is a server-authored template (`telemetry-dashboard.sql.ts`); the exact SQL
+// run is returned in `sql` so the UI can offer "open in explorer".
+// `metric-groups` is the exception: it reads only the in-memory metric-group
+// registry (no store query, no audit row), so the dashboard can render one
+// section per registered group, the app's included.
+// =============================================================================
+const COMMON_DOC = 'Window: `range` (`15m`, `1h`, `6h`, `24h`, `7d`; default `1h`) or `from` + `to` (ISO 8601; ' +
+    '`from` < `to`, `to` at most 1 minute ahead, span at most 30 days; not both). `buckets` (30 or ' +
+    '60) sets the bucket size: span / buckets rounded up to 10s, 30s, 1m, 5m, 10m, 15m, 30m, 1h, 3h ' +
+    'or 6h. `service` and `instance` must be values `/filters` reports for the same window. Every ' +
+    'response carries `range`, `generatedAt`, `truncated` and `sql` (the statement(s) run, primary ' +
+    'first). Results are cached for 15 seconds. Each store read is audited as `telemetry:dashboard`.\n\n' +
+    'Failures carry `details.reason`: `TELEMETRY_DASHBOARD_BAD_FILTER` (400, unknown service or ' +
+    'instance for the window), `TELEMETRY_NOT_CONFIGURED` (503), `TELEMETRY_UNREACHABLE` (503), ' +
+    '`TELEMETRY_DISABLED` (409), `TELEMETRY_QUERY_FAILED` (400) and `TELEMETRY_QUERY_TIMEOUT` (504).';
+function CommonQueries() {
+    return (target, key, descriptor) => {
+        const decorators = [
+            (0, swagger_1.ApiQuery)({ name: 'range', required: false, enum: telemetry_dashboard_dto_1.DASHBOARD_RANGES, description: 'Default `1h`. Not with `from`/`to`.' }),
+            (0, swagger_1.ApiQuery)({ name: 'from', required: false, type: String, description: 'ISO 8601 window start; requires `to`.' }),
+            (0, swagger_1.ApiQuery)({ name: 'to', required: false, type: String, description: 'ISO 8601 window end; requires `from`.' }),
+            (0, swagger_1.ApiQuery)({ name: 'service', required: false, type: String, description: 'Only this service (<= 200 chars).' }),
+            (0, swagger_1.ApiQuery)({ name: 'instance', required: false, type: String, description: 'Only this instance id (<= 200 chars).' }),
+            (0, swagger_1.ApiQuery)({ name: 'buckets', required: false, enum: telemetry_dashboard_dto_1.DASHBOARD_BUCKET_COUNTS, description: 'Default `60`.' }),
+            (0, swagger_1.ApiResponse)({ status: 400, description: 'Invalid parameters, or an unknown service/instance', type: index_1.ErrorDto }),
+            (0, swagger_1.ApiResponse)({ status: 409, description: 'Telemetry is disabled', type: index_1.ErrorDto }),
+            (0, swagger_1.ApiResponse)({ status: 503, description: 'No telemetry store, or it did not answer', type: index_1.ErrorDto }),
+            (0, swagger_1.ApiResponse)({ status: 504, description: 'A statement timed out', type: index_1.ErrorDto }),
+        ];
+        for (const decorate of decorators)
+            decorate(target, key, descriptor);
+        return descriptor;
+    };
+}
+/**
+ * Creates the `TelemetryDashboardController` class for one set of module options: its routes
+ * guarded by the app's access decorators (`options.host.access`), the caller
+ * resolved by `options.actorId`. `TelemetryModule.forRoot()` calls it.
+ *
+ * @param options - the resolved module options.
+ * @returns the controller class.
+ *
+ * @stability experimental
+ */
+function createTelemetryDashboardController(options) {
+    const access = options.host.access;
+    const ActorId = options.actorIdParam;
+    // The metric groups registered when `forRoot` runs: the six platform groups
+    // and the app's `metricGroups` (#703). They are the documented `group` enum;
+    // validation still reads the live registry, so a group an app registers
+    // later (from its own `onModuleInit`) is served, only not documented.
+    const groups = (0, metric_catalog_1.metricGroupIds)();
+    class TelemetryDashboardMetricsQueryDto extends (0, nestjs_zod_1.createZodDto)((0, telemetry_dashboard_dto_1.createTelemetryDashboardMetricsQueryDtoSchema)(groups)) {
+    }
+    class TelemetryDashboardMetricsDto extends (0, nestjs_zod_1.createZodDto)((0, telemetry_dashboard_dto_1.createTelemetryDashboardMetricsDtoSchema)(groups)) {
+    }
+    let TelemetryDashboardController = class TelemetryDashboardController {
+        dashboard;
+        panels;
+        constructor(dashboard, panels) {
+            this.dashboard = dashboard;
+            this.panels = panels;
+        }
+        async summary(query, userId) {
+            return this.dashboard.summary(userId, query);
+        }
+        async timeseries(query, userId) {
+            return this.dashboard.timeseries(userId, query);
+        }
+        async top(query, userId) {
+            return this.dashboard.top(userId, query);
+        }
+        async events(query, userId) {
+            return this.dashboard.events(userId, query);
+        }
+        async filters(query, userId) {
+            return this.dashboard.filters(userId, query);
+        }
+        async metrics(query, userId) {
+            return this.dashboard.metrics(userId, query);
+        }
+        metricGroups() {
+            return {
+                data: (0, metric_catalog_1.metricGroups)().map((group) => {
+                    const units = (0, metric_presentation_1.customUnitsOf)(group);
+                    return {
+                        id: group.id,
+                        label: group.label,
+                        title: group.title,
+                        order: group.order,
+                        ...(group.presentation ? { presentation: group.presentation } : {}),
+                        ...(units.length > 0 ? { units } : {}),
+                    };
+                }),
+            };
+        }
+        listPanels() {
+            return this.panels.list();
+        }
+        async readPanel(id, query, userId) {
+            return this.panels.read(userId, id, query);
+        }
+    };
+    __decorate([
+        (0, common_1.Get)('summary'),
+        (access.requirePermissions([telemetry_permissions_1.TELEMETRY_PERMISSIONS.QUERY])),
+        (0, swagger_1.ApiOperation)({
+            summary: 'Telemetry health verdict and headline tiles (Admin only)',
+            description: 'The verdict (`healthy`, `degraded`, `critical`, `no_data`) with one reason per fired rule, ' +
+                'and tiles for requests/min, 5xx rate, p95 latency, error and warning logs and the latest ' +
+                'data timestamp — each with the previous window of equal length and a per-bucket sparkline. ' +
+                '`runtime` (heap used, event-loop delay p99) appears when those metrics are collected; it is ' +
+                'not filtered by instance. Routes are request paths with id-like segments normalized to `:id`. ' +
+                '`unknownRoutes` (tile and block) counts requests to API routes that do not exist — 404s from ' +
+                'the not-found handler, split by whether a bearer was sent; any with a bearer degrades the ' +
+                'verdict. It is absent (tile value null) until the store has recorded one.\n\n' +
+                COMMON_DOC,
+        }),
+        CommonQueries(),
+        (0, swagger_1.ApiResponse)({ status: 200, description: 'The summary', type: telemetry_dashboard_dto_1.TelemetryDashboardSummaryDto }),
+        __param(0, (0, common_1.Query)()),
+        __param(1, ActorId()),
+        __metadata("design:type", Function),
+        __metadata("design:paramtypes", [telemetry_dashboard_dto_1.TelemetryDashboardQueryDto, String]),
+        __metadata("design:returntype", Promise)
+    ], TelemetryDashboardController.prototype, "summary", null);
+    __decorate([
+        (0, common_1.Get)('timeseries'),
+        (access.requirePermissions([telemetry_permissions_1.TELEMETRY_PERMISSIONS.QUERY])),
+        (0, swagger_1.ApiOperation)({
+            summary: 'Telemetry time series for one dashboard panel (Admin only)',
+            description: '`panel=api`: server requests per bucket by status class (2xx–5xx) and p95 latency (ms). ' +
+                '`panel=logs`: log records per bucket by severity (error >= 17, warn 13–16, info 9–12, ' +
+                'other). Empty buckets are zero-filled.\n\n' +
+                COMMON_DOC,
+        }),
+        (0, swagger_1.ApiQuery)({ name: 'panel', required: true, enum: telemetry_dashboard_dto_1.DASHBOARD_PANELS }),
+        CommonQueries(),
+        (0, swagger_1.ApiResponse)({ status: 200, description: 'The series', type: telemetry_dashboard_dto_1.TelemetryDashboardTimeseriesDto }),
+        __param(0, (0, common_1.Query)()),
+        __param(1, ActorId()),
+        __metadata("design:type", Function),
+        __metadata("design:paramtypes", [telemetry_dashboard_dto_1.TelemetryDashboardTimeseriesQueryDto, String]),
+        __metadata("design:returntype", Promise)
+    ], TelemetryDashboardController.prototype, "timeseries", null);
+    __decorate([
+        (0, common_1.Get)('top'),
+        (access.requirePermissions([telemetry_permissions_1.TELEMETRY_PERMISSIONS.QUERY])),
+        (0, swagger_1.ApiOperation)({
+            summary: 'Top routes or top error messages (Admin only)',
+            description: '`kind=routes`: the ten request paths (normalized) with the most 5xx responses, then the most ' +
+                '4xx except 401 (`clientErrors`), then the highest p95; `unknown` marks a method + path no API ' +
+                'route matches. `kind=errors`: the ten most frequent error log messages (first 200 ' +
+                'characters) with first/last seen, a sample trace id and the service.\n\n' +
+                COMMON_DOC,
+        }),
+        (0, swagger_1.ApiQuery)({ name: 'kind', required: true, enum: telemetry_dashboard_dto_1.DASHBOARD_TOP_KINDS }),
+        CommonQueries(),
+        (0, swagger_1.ApiResponse)({ status: 200, description: 'The top list', type: telemetry_dashboard_dto_1.TelemetryDashboardTopDto }),
+        __param(0, (0, common_1.Query)()),
+        __param(1, ActorId()),
+        __metadata("design:type", Function),
+        __metadata("design:paramtypes", [telemetry_dashboard_dto_1.TelemetryDashboardTopQueryDto, String]),
+        __metadata("design:returntype", Promise)
+    ], TelemetryDashboardController.prototype, "top", null);
+    __decorate([
+        (0, common_1.Get)('events'),
+        (access.requirePermissions([telemetry_permissions_1.TELEMETRY_PERMISSIONS.QUERY])),
+        (0, swagger_1.ApiOperation)({
+            summary: 'Recent log events, newest first (Admin only)',
+            description: 'At most 50 log records per page, newest first, filtered by `severity` (default ' +
+                '`error,warn`) and an optional case-insensitive body substring `q` (at most 200 characters; ' +
+                '`%` and `_` match literally). Pass `nextCursor` back as `cursor` for the next page; it is ' +
+                'null on the last page. A malformed cursor is refused with **400** (`details.reason: ' +
+                '"TELEMETRY_DASHBOARD_BAD_CURSOR"`).\n\n' +
+                COMMON_DOC,
+        }),
+        (0, swagger_1.ApiQuery)({ name: 'severity', required: false, type: String, description: 'Comma-separated: error, warn, info.' }),
+        (0, swagger_1.ApiQuery)({ name: 'q', required: false, type: String, description: 'Body substring, <= 200 characters.' }),
+        (0, swagger_1.ApiQuery)({ name: 'cursor', required: false, type: String, description: '`nextCursor` of the previous page.' }),
+        CommonQueries(),
+        (0, swagger_1.ApiResponse)({ status: 200, description: 'A page of events', type: telemetry_dashboard_dto_1.TelemetryDashboardEventsDto }),
+        __param(0, (0, common_1.Query)()),
+        __param(1, ActorId()),
+        __metadata("design:type", Function),
+        __metadata("design:paramtypes", [telemetry_dashboard_dto_1.TelemetryDashboardEventsQueryDto, String]),
+        __metadata("design:returntype", Promise)
+    ], TelemetryDashboardController.prototype, "events", null);
+    __decorate([
+        (0, common_1.Get)('filters'),
+        (access.requirePermissions([telemetry_permissions_1.TELEMETRY_PERMISSIONS.QUERY])),
+        (0, swagger_1.ApiOperation)({
+            summary: 'Services and instances seen in a window (Admin only)',
+            description: 'The distinct service names and instance ids (at most 200 each) in traces and logs over the ' +
+                'window — the values `service` and `instance` accept — and the host names (`hosts`, at most ' +
+                '200) the host metrics report, the values `/metrics` `host` accepts. Cached for 60 seconds.\n\n' +
+                COMMON_DOC,
+        }),
+        CommonQueries(),
+        (0, swagger_1.ApiResponse)({ status: 200, description: 'The filter values', type: telemetry_dashboard_dto_1.TelemetryDashboardFiltersDto }),
+        __param(0, (0, common_1.Query)()),
+        __param(1, ActorId()),
+        __metadata("design:type", Function),
+        __metadata("design:paramtypes", [telemetry_dashboard_dto_1.TelemetryDashboardQueryDto, String]),
+        __metadata("design:returntype", Promise)
+    ], TelemetryDashboardController.prototype, "filters", null);
+    __decorate([
+        (0, common_1.Get)('metrics'),
+        (access.requirePermissions([telemetry_permissions_1.TELEMETRY_PERMISSIONS.QUERY])),
+        (0, swagger_1.ApiOperation)({
+            summary: 'One metric group of the dashboard catalog (Admin only)',
+            description: 'Tiles, series and per-key tables for one `group` of the metric catalog: `host` (CPU, memory, ' +
+                'load, filesystems, disk and network IO), `database` (connections against the maximum, size, ' +
+                'commits, rollbacks, deadlocks, cache hit ratio, largest tables), `queue` (queue depth, oldest ' +
+                'pending job, settle rate, failure ratio, duration p95, last backup), `nodes` (fleet health, ' +
+                'per-node vitals, job types without an eligible node), `uptime` (status, duration and TLS ' +
+                'expiry per URL, nginx traffic) or `pipeline` (collector points sent/failed, exporter queue, ' +
+                'refused points, GreptimeDB write stalls, scrape targets). Counters are reset-aware increases ' +
+                'over the window; tiles compare with the previous window of equal length. Buckets are at least ' +
+                'one minute. A family whose table or column is absent is listed in `skipped`, never an error; ' +
+                '`available` is false when nothing of the group exists yet. `host` must be a value `/filters` ' +
+                'reports in `hosts`; it applies to collector-scraped metrics only, while `service` and ' +
+                '`instance` apply to the API\'s own metrics (`queue`, `nodes`). `sql` lists every statement run.\n\n' +
+                COMMON_DOC.replace('`service` and `instance` must', '`service`, `instance` and `host` must'),
+        }),
+        (0, swagger_1.ApiQuery)({ name: 'group', required: true, enum: groups }),
+        (0, swagger_1.ApiQuery)({ name: 'host', required: false, type: String, description: 'Only this host (<= 200 chars).' }),
+        CommonQueries(),
+        (0, swagger_1.ApiResponse)({ status: 200, description: 'The metric group', type: TelemetryDashboardMetricsDto }),
+        __param(0, (0, common_1.Query)()),
+        __param(1, ActorId()),
+        __metadata("design:type", Function),
+        __metadata("design:paramtypes", [TelemetryDashboardMetricsQueryDto, String]),
+        __metadata("design:returntype", Promise)
+    ], TelemetryDashboardController.prototype, "metrics", null);
+    __decorate([
+        (0, common_1.Get)('metric-groups'),
+        (access.requirePermissions([telemetry_permissions_1.TELEMETRY_PERMISSIONS.QUERY])),
+        (0, swagger_1.ApiOperation)({
+            summary: 'The metric groups the dashboard renders (Admin only)',
+            description: 'Every registered metric group (the six platform groups and any the application registers), in ' +
+                'dashboard order: `id` (the `/metrics` `group` value), `label`, the dashboard section `title` and ' +
+                '`order`, then, when the group declares them, its `presentation` (data only: tiles, charts, tables ' +
+                'and computed columns the dashboard renders) and the `units` it uses that are not built in, with ' +
+                'how to format them. Read from the in-memory metric-group registry: no telemetry store query, so it ' +
+                'answers even while the store is unconfigured or unreachable, and it is not audited.',
+        }),
+        (0, swagger_1.ApiResponse)({ status: 200, description: 'The metric groups', type: telemetry_dashboard_dto_1.TelemetryDashboardMetricGroupsDto }),
+        __metadata("design:type", Function),
+        __metadata("design:paramtypes", []),
+        __metadata("design:returntype", Object)
+    ], TelemetryDashboardController.prototype, "metricGroups", null);
+    __decorate([
+        (0, common_1.Get)('panels'),
+        (access.requirePermissions([telemetry_permissions_1.TELEMETRY_PERMISSIONS.QUERY])),
+        (0, swagger_1.ApiOperation)({
+            summary: 'The dashboard panels (Admin only)',
+            description: 'Every registered dashboard panel (the platform\'s `api` and `logs`, and any the application ' +
+                'registers), in dashboard order: `id`, `label`, `order` and whether it is `builtin`. Read from the ' +
+                'in-memory panel registry: no telemetry store query, not audited.',
+        }),
+        (0, swagger_1.ApiResponse)({ status: 200, description: 'The panels', type: telemetry_dashboard_dto_1.TelemetryDashboardPanelsDto }),
+        __metadata("design:type", Function),
+        __metadata("design:paramtypes", []),
+        __metadata("design:returntype", Object)
+    ], TelemetryDashboardController.prototype, "listPanels", null);
+    __decorate([
+        (0, common_1.Get)('panels/:id'),
+        (access.requirePermissions([telemetry_permissions_1.TELEMETRY_PERMISSIONS.QUERY])),
+        (0, swagger_1.ApiOperation)({
+            summary: 'One dashboard panel\'s data (Admin only)',
+            description: 'Runs the registered panel\'s `data` function for the dashboard window and answers its JSON `payload` ' +
+                '(at most 262144 bytes). The panel reads the telemetry store only through the explorer\'s guarded ' +
+                'path (one read-only statement at a time, the row cap, the timeout, an audit row with source ' +
+                '`panel`). An unknown id is **404**; a panel that throws, outruns its 30 second budget or returns ' +
+                'something that is not bounded JSON is **500** with `details.reason: "TELEMETRY_PANEL_FAILED"` ' +
+                'and a generic message (the cause is in the server log).\n\n' +
+                COMMON_DOC,
+        }),
+        (0, swagger_1.ApiParam)({ name: 'id', description: 'The panel id from `/panels`.', schema: { type: 'string', pattern: '^[a-z][a-z0-9_-]{1,47}$' } }),
+        CommonQueries(),
+        (0, swagger_1.ApiResponse)({ status: 200, description: 'The panel\'s payload', type: telemetry_dashboard_dto_1.TelemetryDashboardPanelDataDto }),
+        (0, swagger_1.ApiResponse)({ status: 404, description: 'No such panel', type: index_1.ErrorDto }),
+        (0, swagger_1.ApiResponse)({ status: 500, description: 'The panel failed', type: index_1.ErrorDto }),
+        __param(0, (0, common_1.Param)('id')),
+        __param(1, (0, common_1.Query)()),
+        __param(2, ActorId()),
+        __metadata("design:type", Function),
+        __metadata("design:paramtypes", [String, telemetry_dashboard_dto_1.TelemetryDashboardQueryDto, String]),
+        __metadata("design:returntype", Promise)
+    ], TelemetryDashboardController.prototype, "readPanel", null);
+    TelemetryDashboardController = __decorate([
+        (0, swagger_1.ApiTags)('Telemetry'),
+        (0, common_1.Controller)('admin/telemetry/dashboard'),
+        __param(0, (0, common_1.Inject)(telemetry_dashboard_service_1.TelemetryDashboardService)),
+        __param(1, (0, common_1.Inject)(telemetry_dashboard_panel_service_1.TelemetryDashboardPanelService)),
+        __metadata("design:paramtypes", [telemetry_dashboard_service_1.TelemetryDashboardService,
+            telemetry_dashboard_panel_service_1.TelemetryDashboardPanelService])
+    ], TelemetryDashboardController);
+    return TelemetryDashboardController;
+}
+//# sourceMappingURL=telemetry-dashboard.controller.js.map

package/dist/telemetry/dashboard/telemetry-dashboard.controller.js.map

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

package/dist/telemetry/dashboard/telemetry-dashboard.service.d.ts

@@ -0,0 +1,129 @@
+import { type TelemetryDashboardEvents, type TelemetryDashboardEventsQuery, type TelemetryDashboardFilters, type TelemetryDashboardMetrics, type TelemetryDashboardMetricsQuery, type TelemetryDashboardQuery, type TelemetryDashboardSummary, type TelemetryDashboardTimeseries, type TelemetryDashboardTimeseriesQuery, type TelemetryDashboardTop, type TelemetryDashboardTopQuery } from '../dto/telemetry-dashboard.dto';
+import type { TelemetrySchema } from '../dto/telemetry-query.dto';
+import { type TelemetryQueryResult, type TelemetrySqlDialect, type TelemetryStore } from '../stores/telemetry-store';
+import { TelemetrySchemaService } from '../query/telemetry-schema.service';
+import { type TelemetryAuditSink } from '../ports';
+import { TelemetrySettingsService } from '../telemetry-settings.service';
+import { type DashboardSqlWindow, type EventSeverity, type EventsCursor } from './telemetry-dashboard.sql';
+import type { DashboardPanelWindow } from './panels/dashboard-panel.registry';
+import { type VerdictThresholds } from './telemetry-dashboard.verdict';
+import { type VerdictPolicy } from './verdict-policy';
+export declare const DASHBOARD_RESULT_CACHE_MS = 15000;
+export declare const DASHBOARD_DISTINCT_CACHE_MS = 60000;
+/** Entries each cache keeps at most (oldest evicted first). */
+export declare const DASHBOARD_CACHE_MAX_ENTRIES = 500;
+/** How far back "latest data" looks. */
+export declare const LAST_DATA_LOOKBACK_MS: number;
+/** Runtime metrics are exported every 60 s: a finer bucket would be half empty. */
+export declare const RUNTIME_MIN_BUCKET_SECONDS = 60;
+/** How much of `q` an audit row or log line keeps. */
+export declare const DASHBOARD_LOG_Q_MAX = 64;
+export declare const TELEMETRY_DASHBOARD_AUDIT_ACTION = "telemetry:dashboard";
+export type DashboardRoute = 'summary' | 'timeseries' | 'top' | 'events' | 'filters' | 'metrics' | 'panel';
+/** The window a request resolved to. */
+export interface ResolvedWindow extends DashboardSqlWindow {
+    previousFrom: Date;
+    spanMs: number;
+    /** Cache key of the window: the range name, or the absolute instants; plus the bucket count. */
+    key: string;
+    /** `key` without the bucket count (the distinct-values cache). */
+    spanKey: string;
+}
+type CommonQuery = Pick<TelemetryDashboardQuery, 'range' | 'from' | 'to' | 'buckets'>;
+/** The request's window at `now`. The DTO has already refused conflicting or oversized windows. */
+export declare function resolveWindow(query: CommonQuery, now?: number): ResolvedWindow;
+/** A TTL cache whose concurrent misses for one key share one promise. Failures are not cached. */
+export declare class SharedTtlCache<T> {
+    private readonly ttlMs;
+    private readonly maxEntries;
+    private readonly entries;
+    private readonly inflight;
+    constructor(ttlMs: number, maxEntries?: number);
+    get(key: string, load: () => Promise<T>): Promise<T>;
+    clear(): void;
+    private evict;
+}
+/** What exists in the store, decided from its schema. */
+export interface DashboardCatalog {
+    traces: boolean;
+    tracesHaveInstance: boolean;
+    /** `"span_attributes.app.route.matched"` exists (#650): unknown routes can be told apart. */
+    tracesHaveRouteMatched: boolean;
+    /** `"span_attributes.app.request.bearer"` exists (#650). */
+    tracesHaveBearer: boolean;
+    logs: boolean;
+    heap: boolean;
+    eventLoop: boolean;
+}
+export declare function catalogOf(schema: TelemetrySchema): DashboardCatalog;
+export declare function encodeCursor(cursor: EventsCursor): string;
+/** Strictly decodes a cursor, or throws 400 TELEMETRY_DASHBOARD_BAD_CURSOR. */
+export declare function decodeCursor(raw: string): EventsCursor;
+/** ns (number or UInt64 text) → ms rounded to 0.1, or null. */
+export declare function nsToMs(value: unknown): number | null;
+/** A store timestamp as a Date, or null. */
+export declare function toDate(value: unknown): Date | null;
+/** Bucket starts covering `[from, to)`, aligned to the epoch like `date_bin`. */
+export declare function bucketStarts(from: Date, to: Date, bucketSeconds: number): number[];
+export declare class TelemetryDashboardService {
+    private readonly store;
+    private readonly settings;
+    private readonly schema;
+    private readonly auditSink;
+    private readonly verdictPolicy;
+    private readonly thresholds;
+    private readonly metricFreshMs;
+    private readonly dialect;
+    private readonly logger;
+    private readonly results;
+    private readonly distinct;
+    constructor(store: TelemetryStore, settings: TelemetrySettingsService, schema: TelemetrySchemaService, auditSink: TelemetryAuditSink, verdictPolicy?: VerdictPolicy, thresholds?: VerdictThresholds, metricFreshMs?: number, dialect?: TelemetrySqlDialect);
+    summary(userId: string, query: TelemetryDashboardQuery): Promise<TelemetryDashboardSummary>;
+    timeseries(userId: string, query: TelemetryDashboardTimeseriesQuery): Promise<TelemetryDashboardTimeseries>;
+    top(userId: string, query: TelemetryDashboardTopQuery): Promise<TelemetryDashboardTop>;
+    /** One metric group of the catalog (#601): tiles, series and tables. */
+    metrics(userId: string, query: TelemetryDashboardMetricsQuery): Promise<TelemetryDashboardMetrics>;
+    events(userId: string, query: TelemetryDashboardEventsQuery): Promise<TelemetryDashboardEvents>;
+    /**
+     * The window and the validated `service` / `instance` filters an app's
+     * dashboard panel is read for (PP-14.18): the preconditions every dashboard
+     * route shares (store configured and telemetry enabled), the same window
+     * rules, and a filter value refused unless it was seen in the range, so a
+     * panel never receives a filter the store has not produced. Audited like any
+     * dashboard read that touches the store.
+     */
+    panelScope(userId: string, query: TelemetryDashboardQuery): Promise<{
+        window: DashboardPanelWindow;
+        filters: {
+            service?: string;
+            instance?: string;
+        };
+    }>;
+    filters(userId: string, query: TelemetryDashboardQuery): Promise<TelemetryDashboardFilters>;
+    /** Preconditions, window, result cache, audit. */
+    private cached;
+    /** Runs `work`, then writes the audit row (for a failure too) and logs the outcome. */
+    private audited;
+    private audit;
+    /** `service`/`instance`/`host` as SQL filters, or 400 when one was not seen in the range. */
+    private validateFilters;
+    private loadDistinct;
+    private computeSummary;
+    private computeMetrics;
+    private computeTimeseries;
+    private computeTop;
+    private computeEvents;
+}
+/** Unknown API routes the summary lists (#650); a short list, the verdict only needs 3 or more. */
+export declare const UNKNOWN_ROUTES_TOP_N = 5;
+/** The summary's `unknownRoutes` block from its two statements (#650). */
+export declare function unknownRoutesOf(totals: TelemetryQueryResult | null, top: TelemetryQueryResult | null, sql: string[]): NonNullable<TelemetryDashboardSummary['unknownRoutes']>;
+export declare function parseSeverities(raw: string | undefined): EventSeverity[];
+/**
+ * Request parameters as an audit row keeps them: control characters removed
+ * (PostgreSQL's jsonb refuses `\u0000`), `q` cut to 64 characters, the cursor
+ * only as present.
+ */
+export declare function auditParams(params: Record<string, unknown>): Record<string, unknown>;
+export {};
+//# sourceMappingURL=telemetry-dashboard.service.d.ts.map

package/dist/telemetry/dashboard/telemetry-dashboard.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry-dashboard.service.d.ts","sourceRoot":"","sources":["../../../src/telemetry/dashboard/telemetry-dashboard.service.ts"],"names":[],"mappings":"AAEA,OAAO,EAIL,KAAK,wBAAwB,EAC7B,KAAK,6BAA6B,EAClC,KAAK,yBAAyB,EAC9B,KAAK,yBAAyB,EAC9B,KAAK,8BAA8B,EACnC,KAAK,uBAAuB,EAC5B,KAAK,yBAAyB,EAE9B,KAAK,4BAA4B,EACjC,KAAK,iCAAiC,EACtC,KAAK,qBAAqB,EAC1B,KAAK,0BAA0B,EAChC,MAAM,gCAAgC,CAAC;AACxC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAElE,OAAO,EAGL,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,EACxB,KAAK,cAAc,EACpB,MAAM,2BAA2B,CAAC;AAInC,OAAO,EAAE,sBAAsB,EAAE,MAAM,mCAAmC,CAAC;AAC3E,OAAO,EAAwB,KAAK,kBAAkB,EAAE,MAAM,UAAU,CAAC;AACzE,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AAKzE,OAAO,EAeL,KAAK,kBAAkB,EACvB,KAAK,aAAa,EAClB,KAAK,YAAY,EAiBlB,MAAM,2BAA2B,CAAC;AAEnC,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC;AAC9E,OAAO,EAA8B,KAAK,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AACnG,OAAO,EAAwC,KAAK,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAoC5F,eAAO,MAAM,yBAAyB,QAAS,CAAC;AAChD,eAAO,MAAM,2BAA2B,QAAS,CAAC;AAClD,+DAA+D;AAC/D,eAAO,MAAM,2BAA2B,MAAM,CAAC;AAC/C,wCAAwC;AACxC,eAAO,MAAM,qBAAqB,QAAuB,CAAC;AAC1D,mFAAmF;AACnF,eAAO,MAAM,0BAA0B,KAAK,CAAC;AAC7C,sDAAsD;AACtD,eAAO,MAAM,mBAAmB,KAAK,CAAC;AAEtC,eAAO,MAAM,gCAAgC,wBAAwB,CAAC;AAEtE,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG,YAAY,GAAG,KAAK,GAAG,QAAQ,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,CAAC;AAE3G,wCAAwC;AACxC,MAAM,WAAW,cAAe,SAAQ,kBAAkB;IACxD,YAAY,EAAE,IAAI,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,gGAAgG;IAChG,GAAG,EAAE,MAAM,CAAC;IACZ,kEAAkE;IAClE,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,KAAK,WAAW,GAAG,IAAI,CAAC,uBAAuB,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC,CAAC;AAEtF,mGAAmG;AACnG,wBAAgB,aAAa,CAAC,KAAK,EAAE,WAAW,EAAE,GAAG,SAAa,GAAG,cAAc,CA4BlF;AAED,kGAAkG;AAClG,qBAAa,cAAc,CAAC,CAAC;IAKzB,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,UAAU;IAL7B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA+C;IACvE,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAiC;gBAGvC,KAAK,EAAE,MAAM,EACb,UAAU,SAA8B;IAG3D,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAqBpD,KAAK,IAAI,IAAI;IAIb,OAAO,CAAC,KAAK;CAUd;AAED,yDAAyD;AACzD,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,OAAO,CAAC;IAChB,kBAAkB,EAAE,OAAO,CAAC;IAC5B,6FAA6F;IAC7F,sBAAsB,EAAE,OAAO,CAAC;IAChC,4DAA4D;IAC5D,gBAAgB,EAAE,OAAO,CAAC;IAC1B,IAAI,EAAE,OAAO,CAAC;IACd,IAAI,EAAE,OAAO,CAAC;IACd,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,wBAAgB,SAAS,CAAC,MAAM,EAAE,eAAe,GAAG,gBAAgB,CAiBnE;AAID,wBAAgB,YAAY,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CAEzD;AAED,+EAA+E;AAC/E,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,YAAY,CAuBtD;AASD,+DAA+D;AAC/D,wBAAgB,MAAM,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAIpD;AAYD,4CAA4C;AAC5C,wBAAgB,MAAM,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,GAAG,IAAI,CAKlD;AAUD,iFAAiF;AACjF,wBAAgB,YAAY,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,aAAa,EAAE,MAAM,GAAG,MAAM,EAAE,CAKlF;AAkFD,qBACa,yBAAyB;IAMT,OAAO,CAAC,QAAQ,CAAC,KAAK;IAC/C,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACO,OAAO,CAAC,QAAQ,CAAC,SAAS;IAGhC,OAAO,CAAC,QAAQ,CAAC,aAAa;IAChB,OAAO,CAAC,QAAQ,CAAC,UAAU;IAElB,OAAO,CAAC,QAAQ,CAAC,aAAa;IAElC,OAAO,CAAC,QAAQ,CAAC,OAAO;IAhBrE,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA8C;IACrE,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA0D;IAClF,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAmE;gBAGhD,KAAK,EAAE,cAAc,EAC9C,QAAQ,EAAE,wBAAwB,EAClC,MAAM,EAAE,sBAAsB,EACA,SAAS,EAAE,kBAAkB,EAGnC,aAAa,GAAE,aAA0C,EAC3C,UAAU,GAAE,iBAA8C,EAEjD,aAAa,GAAE,MAAwB,EAE3C,OAAO,GAAE,mBAA0C;IAG3G,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,uBAAuB,GAAG,OAAO,CAAC,yBAAyB,CAAC;IAI3F,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,iCAAiC,GAAG,OAAO,CAAC,4BAA4B,CAAC;IAM3G,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,0BAA0B,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAI5F,wEAAwE;IAClE,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,8BAA8B,GAAG,OAAO,CAAC,yBAAyB,CAAC;IAIlG,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,6BAA6B,GAAG,OAAO,CAAC,wBAAwB,CAAC;IAcrG;;;;;;;OAOG;IACG,UAAU,CACd,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,uBAAuB,GAC7B,OAAO,CAAC;QAAE,MAAM,EAAE,oBAAoB,CAAC;QAAC,OAAO,EAAE;YAAE,OAAO,CAAC,EAAE,MAAM,CAAC;YAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,CAAC;IA6BxF,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,uBAAuB,GAAG,OAAO,CAAC,yBAAyB,CAAC;IAuBjG,kDAAkD;YACpC,MAAM;IAmCpB,uFAAuF;YACzE,OAAO;YA+BP,KAAK;IAenB,6FAA6F;YAC/E,eAAe;YAiCf,YAAY;YAuDZ,cAAc;YA0Md,cAAc;YAwBd,iBAAiB;YAsDjB,UAAU;YAiDV,aAAa;CAoD5B;AAED,mGAAmG;AACnG,eAAO,MAAM,oBAAoB,IAAI,CAAC;AAEtC,0EAA0E;AAC1E,wBAAgB,eAAe,CAC7B,MAAM,EAAE,oBAAoB,GAAG,IAAI,EACnC,GAAG,EAAE,oBAAoB,GAAG,IAAI,EAChC,GAAG,EAAE,MAAM,EAAE,GACZ,WAAW,CAAC,yBAAyB,CAAC,eAAe,CAAC,CAAC,CA2BzD;AAeD,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,aAAa,EAAE,CAIxE;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAUpF"}