@harperfast/harper 5.0.30 → 5.1.0-beta.2

package/dist/resources/analytics/metadata.d.ts

@@ -6,5 +6,6 @@ export declare const METRIC: {
     readonly RESOURCE_USAGE: "resource-usage";
     readonly UTILIZATION: "utilization";
     readonly NODE_STORAGE: "node-storage";
+    readonly ROCKSDB_STATS: "rocksdb-stats";
 };
 export type BuiltInMetricName = (typeof METRIC)[keyof typeof METRIC];

package/dist/resources/analytics/metadata.js

@@ -9,5 +9,6 @@ exports.METRIC = {
     RESOURCE_USAGE: 'resource-usage',
     UTILIZATION: 'utilization',
     NODE_STORAGE: 'node-storage',
+    ROCKSDB_STATS: 'rocksdb-stats',
 };
 //# sourceMappingURL=metadata.js.map

package/dist/resources/analytics/metadata.js.map

@@ -1 +1 @@
-{"version":3,"file":"metadata.js","sourceRoot":"","sources":["../../../resources/analytics/metadata.ts"],"names":[],"mappings":";;;AAAa,QAAA,MAAM,GAAG;IACrB,UAAU,EAAE,YAAY;IACxB,aAAa,EAAE,eAAe;IAC9B,cAAc,EAAE,gBAAgB;IAChC,uBAAuB,EAAE,yBAAyB;IAClD,cAAc,EAAE,gBAAgB;IAChC,WAAW,EAAE,aAAa;IAC1B,YAAY,EAAE,cAAc;CACnB,CAAC"}
+{"version":3,"file":"metadata.js","sourceRoot":"","sources":["../../../resources/analytics/metadata.ts"],"names":[],"mappings":";;;AAAa,QAAA,MAAM,GAAG;IACrB,UAAU,EAAE,YAAY;IACxB,aAAa,EAAE,eAAe;IAC9B,cAAc,EAAE,gBAAgB;IAChC,uBAAuB,EAAE,yBAAyB;IAClD,cAAc,EAAE,gBAAgB;IAChC,WAAW,EAAE,aAAa;IAC1B,YAAY,EAAE,cAAc;IAC5B,aAAa,EAAE,eAAe;CACrB,CAAC"}

package/dist/resources/analytics/read.d.ts

@@ -1,14 +1,21 @@
 import type { Metric } from './write.ts';
 import type { Conditions } from '../ResourceInterface.ts';
 interface GetAnalyticsRequest {
+    operation?: string;
     metric: string;
     start_time?: number;
     end_time?: number;
     get_attributes?: string[];
     coalesce_time?: boolean;
     conditions?: Conditions;
+    replicated?: boolean;
 }
-type GetAnalyticsResponse = Metric[];
+type GetAnalyticsResponse = AsyncIterable<Metric> | Metric[];
+/**
+ * Validates the `get_analytics` request and returns the analytics results.
+ * @param req
+ * @returns
+ */
 export declare function getOp(req: GetAnalyticsRequest): Promise<GetAnalyticsResponse>;
 interface GetAnalyticsOpts {
     getAttributes?: string[];

package/dist/resources/analytics/read.js

@@ -9,15 +9,19 @@ exports.listMetricsOp = listMetricsOp;
 exports.listMetrics = listMetrics;
 exports.describeMetricOp = describeMetricOp;
 exports.describeMetric = describeMetric;
-const harper_logger_js_1 = __importDefault(require("../../utility/logging/harper_logger.js"));
-const { forComponent } = harper_logger_js_1.default;
+const harper_logger_ts_1 = __importDefault(require("../../utility/logging/harper_logger.js"));
+const { forComponent } = harper_logger_ts_1.default;
 const hostnames_ts_1 = require("./hostnames.js");
 const metadata_ts_1 = require("./metadata.js");
 const hdbTerms_ts_1 = require("../../utility/hdbTerms.js");
-const environmentManager_js_1 = require("../../utility/environment/environmentManager.js");
+const environmentManager_ts_1 = require("../../utility/environment/environmentManager.js");
+const analyticsValidator_ts_1 = require("../../validation/analyticsValidator.js");
+const hdbError_ts_1 = require("../../utility/errors/hdbError.js");
+const nodeName_ts_1 = require("../../server/nodeName.js");
 // default to one week time window for finding custom metrics
 const defaultCustomMetricWindow = 1000 * 60 * 60 * 24 * 7;
-const log = forComponent('analytics').conditional;
+const logger = forComponent('analytics');
+const log = logger.conditional;
 async function lookupHostname(nodeId) {
     const result = await (0, hostnames_ts_1.getAnalyticsHostnameTable)().get(nodeId);
     if (result?.hostname)
@@ -29,15 +33,72 @@ async function lookupHostname(nodeId) {
 function isSelected(querySelect, attr) {
     return querySelect.length === 0 || querySelect.includes(attr);
 }
-function getOp(req) {
+/**
+ * Validates the `get_analytics` request and returns the analytics results.
+ * @param req
+ * @returns
+ */
+async function getOp(req) {
     log.trace?.('get_analytics request:', req);
-    return get(req.metric, {
-        getAttributes: req.get_attributes,
+    const validationError = (0, analyticsValidator_ts_1.validateGetAnalytics)(req);
+    if (validationError) {
+        throw (0, hdbError_ts_1.handleHDBError)(validationError, validationError.message, hdbError_ts_1.hdbErrors.HTTP_STATUS_CODES.BAD_REQUEST, undefined, undefined, true);
+    }
+    // `replicated` fans the query out to every peer node and merges each node's
+    // analytics into one cluster-wide result set. Fan-out is skipped when:
+    //  - the request did not ask for it;
+    //  - this is standalone core, which has no `server.nodes` (harper-pro populates it);
+    //  - `hdb_analytics` already replicates across the cluster, in which case a local
+    //    query already holds every node's rows and fanning out would double-count.
+    //    The DB layer marks the table `replicate === false` only when it is *not*
+    //    replicated (`analytics_replicate: false`), which is exactly when fan-out helps.
+    const analyticsReplicatedByDb = databases.system.hdb_analytics.replicate !== false;
+    const peers = req.replicated && !analyticsReplicatedByDb && server.nodes?.length ? server.nodes : undefined;
+    // When merging across the cluster, make sure every row keeps its origin `node`
+    // attribute so callers can tell the nodes apart. An empty/absent `get_attributes`
+    // already selects everything (including `node`), so only an explicit list needs it.
+    let getAttributes = req.get_attributes;
+    if (peers && getAttributes?.length && !getAttributes.includes('node')) {
+        getAttributes = [...getAttributes, 'node'];
+    }
+    const localResults = await get(req.metric, {
+        getAttributes,
         startTime: req.start_time,
         endTime: req.end_time,
         coalesceTime: req.coalesce_time,
         additionalConditions: req.conditions,
     });
+    if (!peers)
+        return localResults;
+    return mergeAnalyticsFromPeers(localResults, { ...req, get_attributes: getAttributes }, peers);
+}
+/**
+ * Streams the local analytics, then appends each peer node's analytics. The same
+ * query is forwarded to every peer with `replicated` cleared so each returns only
+ * its own local metrics (no recursive fan-out). Best-effort: a peer that fails is
+ * logged and omitted rather than failing the whole query.
+ */
+async function* mergeAnalyticsFromPeers(localResults, req, peers) {
+    const thisNode = (0, nodeName_ts_1.getThisNodeName)();
+    const peerReq = { ...req, replicated: false };
+    // `sendOperationToNode` is typed for a node name string, but the replication
+    // implementation expects the full node object (the stub-vs-impl mismatch that
+    // `restart` works around the same way).
+    const sendOperationToNode = server.replication.sendOperationToNode;
+    const peerResults = peers
+        .filter((node) => node.name !== thisNode)
+        .map((node) => sendOperationToNode(node, peerReq).then(
+    // an array response is wrapped as `{ results }` over the replication channel;
+    // fall back to an empty list for any other (malformed) shape so a bad peer
+    // can't break the merge
+    (response) => Array.isArray(response) ? response : Array.isArray(response?.results) ? response.results : [], (error) => {
+        logger.warn(`get_analytics replication to node '${node.name}' failed; omitting its results`, error);
+        return [];
+    }));
+    yield* localResults;
+    for (const peerResult of peerResults) {
+        yield* await peerResult;
+    }
 }
 function conformCondition(condition) {
     if ('conditions' in condition) {
@@ -124,7 +185,7 @@ async function get(metric, opts) {
     });
     if (opts?.coalesceTime) {
         // coalescing window is the aggregate period converted to milliseconds
-        const window = (0, environmentManager_js_1.get)(hdbTerms_ts_1.CONFIG_PARAMS.ANALYTICS_AGGREGATEPERIOD) * 1000;
+        const window = (0, environmentManager_ts_1.get)(hdbTerms_ts_1.CONFIG_PARAMS.ANALYTICS_AGGREGATEPERIOD) * 1000;
         results = coalesceResults(results, window);
     }
     return results;

package/dist/resources/analytics/read.js.map

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

package/dist/resources/analytics/write.d.ts

@@ -48,6 +48,34 @@ export declare function calculateCPUUtilization(resourceUsage: ResourceUsage, pe
  *  new values for this time period.
  */
 export declare function diffResourceUsage(lastResourceUsage: ResourceUsage, resourceUsage: ResourceUsage): ResourceUsage;
+export declare function toRocksDBCamelCase(key: string): string;
+export declare function diffRocksDBCounter(curr: number, last: number | undefined): number;
+/**
+ * Filter a raw RocksDB stats record to numeric scalar entries, camelCasing the keys.
+ * Histogram entries (objects) are dropped — they don't fit the flat analytics row model.
+ * @param raw - The raw RocksDB stats record to normalize.
+ * @returns The normalized RocksDB stats record.
+ */
+export declare function normalizeRocksDBStats(raw: Record<string, unknown>): Record<string, number>;
+/**
+ * Gathers metrics for a RocksDB database.
+ * @param dbName - The name of the database.
+ * @param stats - The stats to build the metric from.
+ * @param lastStats - The last stats to diff the stats from.
+ * @param now - The current time.
+ * @param period - The period to store the metrics for.
+ */
+export declare function buildRocksDBDbMetric(dbName: string, stats: Record<string, number>, lastStats: Record<string, number> | undefined, now: number, period: number | undefined): Record<string, unknown>;
+/**
+ * Gathers metrics for a RocksDB table. Only gauges are reported per-table; ticker counters
+ * are DB-wide (see ROCKSDB_DB_COUNTERS comment) and live on the DB-level metric.
+ * @param dbName - The name of the database.
+ * @param tableName - The name of the table.
+ * @param stats - The stats to build the metric from.
+ * @param now - The current time.
+ * @param period - The period to store the metrics for.
+ */
+export declare function buildRocksDBTableMetric(dbName: string, tableName: string, stats: Record<string, number>, now: number, period: number | undefined): Record<string, unknown>;
 export declare function getDirectorySizeAsync(dirPath: string): Promise<number>;
 export declare function onAnalyticsAggregate(callback: any): void;
 export {};

package/dist/resources/analytics/write.js

@@ -44,18 +44,23 @@ exports.addAnalyticsListener = addAnalyticsListener;
 exports.recordHostname = recordHostname;
 exports.calculateCPUUtilization = calculateCPUUtilization;
 exports.diffResourceUsage = diffResourceUsage;
+exports.toRocksDBCamelCase = toRocksDBCamelCase;
+exports.diffRocksDBCounter = diffRocksDBCounter;
+exports.normalizeRocksDBStats = normalizeRocksDBStats;
+exports.buildRocksDBDbMetric = buildRocksDBDbMetric;
+exports.buildRocksDBTableMetric = buildRocksDBTableMetric;
 exports.getDirectorySizeAsync = getDirectorySizeAsync;
 exports.onAnalyticsAggregate = onAnalyticsAggregate;
 const worker_threads_1 = require("worker_threads");
 const manageThreads_js_1 = require("../../server/threads/manageThreads.js");
 const databases_ts_1 = require("../databases.js");
-const harper_logger_js_1 = __importDefault(require("../../utility/logging/harper_logger.js"));
+const harper_logger_ts_1 = __importDefault(require("../../utility/logging/harper_logger.js"));
 const promises_1 = require("node:fs/promises");
-const { getLogFilePath, forComponent } = harper_logger_js_1.default;
+const { getLogFilePath, forComponent } = harper_logger_ts_1.default;
 const path_1 = require("path");
 const promises_2 = require("fs/promises");
-const commonUtility_js_1 = require("../../utility/lmdb/commonUtility.js");
-const environmentManager_js_1 = require("../../utility/environment/environmentManager.js");
+const commonUtility_ts_1 = require("../../utility/lmdb/commonUtility.js");
+const environmentManager_ts_1 = require("../../utility/environment/environmentManager.js");
 const hdbTerms_ts_1 = require("../../utility/hdbTerms.js");
 const Server_ts_1 = require("../../server/Server.js");
 const fs = __importStar(require("node:fs"));
@@ -63,10 +68,22 @@ const hostnames_ts_1 = require("./hostnames.js");
 const metadata_ts_1 = require("./metadata.js");
 const rocksdb_js_1 = require("@harperfast/rocksdb-js");
 const log = forComponent('analytics').conditional;
-(0, environmentManager_js_1.initSync)();
+const isBun = typeof globalThis.Bun !== 'undefined';
+(0, environmentManager_ts_1.initSync)();
 let activeActions = new Map();
-let analyticsEnabled = (0, environmentManager_js_1.get)(hdbTerms_ts_1.CONFIG_PARAMS.ANALYTICS_AGGREGATEPERIOD) > -1;
+let analyticsEnabled = (0, environmentManager_ts_1.get)(hdbTerms_ts_1.CONFIG_PARAMS.ANALYTICS_AGGREGATEPERIOD) > -1;
+let analyticsReadOnlyChecked = false;
 let sendAnalyticsTimeout;
+// Check read-only mode lazily to avoid circular dependency at module load time
+function checkAnalyticsEnabled() {
+    if (!analyticsReadOnlyChecked) {
+        analyticsReadOnlyChecked = true;
+        if ((0, databases_ts_1.isReadOnlyMode)()) {
+            analyticsEnabled = false;
+        }
+    }
+    return analyticsEnabled;
+}
 function setAnalyticsEnabled(enabled) {
     analyticsEnabled = enabled;
     clearTimeout(sendAnalyticsTimeout); // reset this
@@ -134,7 +151,7 @@ function recordNewAction(key, value, metric, path, method, type) {
  * @param type
  */
 function recordAction(value, metric, path, method, type) {
-    if (!analyticsEnabled)
+    if (!checkAnalyticsEnabled())
         return;
     // TODO: May want to consider nested paths, as they may yield faster hashing of (fixed) strings that hashing concatenated strings
     let key = metric + (path ? '-' + path : '');
@@ -247,6 +264,9 @@ function sendAnalytics() {
     }, exports.analyticsDelay).unref();
 }
 async function recordHostname() {
+    // Skip writes in read-only mode
+    if ((0, databases_ts_1.isReadOnlyMode)())
+        return;
     const hostname = Server_ts_1.server.hostname;
     log.trace?.('recordHostname server.hostname:', hostname);
     const nodeId = (0, hostnames_ts_1.stableNodeId)(hostname);
@@ -271,9 +291,12 @@ function getHostNodeId(hostname) {
     return nodeId;
 }
 function storeMetric(table, metric) {
+    // Skip writes in read-only mode
+    if ((0, databases_ts_1.isReadOnlyMode)())
+        return;
     const nodeId = getHostNodeId(Server_ts_1.server.hostname);
     const metricValue = {
-        id: [(0, commonUtility_js_1.getNextMonotonicTime)(), nodeId],
+        id: [(0, commonUtility_ts_1.getNextMonotonicTime)(), nodeId],
         ...metric,
     };
     log.trace?.(`storing metric ${JSON.stringify(metricValue)}`);
@@ -393,6 +416,176 @@ function storeVolumeMetrics(analyticsTable, databases) {
         }
     }
 }
+// RocksDB stat names are kebab-case with a "rocksdb." prefix (e.g. "rocksdb.block.cache.hit");
+// camelCase them to match the field shape used throughout systemInformation.
+function toRocksDBCamelCase(key) {
+    return key.replace(/^rocksdb\./, '').replace(/[-.]([a-z])/g, (_, c) => c.toUpperCase());
+}
+// Every column family on the same physical RocksDB shares one Statistics object, so all ticker
+// counters returned by getStats() — including memtableHit/memtableMiss — are DB-wide, not per-CF.
+// Listing them as DB-level avoids emitting the same delta on every table row.
+const ROCKSDB_DB_COUNTERS = [
+    'bytesRead',
+    'bytesWritten',
+    'numberKeysRead',
+    'numberKeysWritten',
+    'blockCacheHit',
+    'blockCacheMiss',
+    'blockCacheDataHit',
+    'blockCacheDataMiss',
+    'blockCacheIndexHit',
+    'blockCacheIndexMiss',
+    'blockCacheFilterHit',
+    'blockCacheFilterMiss',
+    'stallMicros',
+    'memtableHit',
+    'memtableMiss',
+];
+// Gauges are scalar values that are not cumulative. They go up and down over time.
+const ROCKSDB_DB_GAUGES = ['blockCacheUsage', 'blockCacheCapacity', 'numRunningFlushes'];
+const ROCKSDB_TABLE_GAUGES = ['numRunningCompactions', 'compactionPending'];
+const lastRocksDBDbStats = new Map();
+let lastRocksDBStatsTime = 0;
+function diffRocksDBCounter(curr, last) {
+    // A negative delta means RocksDB itself reset the counter mid-process (e.g. an internal
+    // statistics reset). Process restarts are handled separately because the module-level
+    // last-stats maps are reinitialized, which takes the no-prior-reading path below.
+    if (last === undefined || curr < last)
+        return curr;
+    return curr - last;
+}
+/**
+ * Filter a raw RocksDB stats record to numeric scalar entries, camelCasing the keys.
+ * Histogram entries (objects) are dropped — they don't fit the flat analytics row model.
+ * @param raw - The raw RocksDB stats record to normalize.
+ * @returns The normalized RocksDB stats record.
+ */
+function normalizeRocksDBStats(raw) {
+    const out = {};
+    if (!raw)
+        return out;
+    for (const [key, value] of Object.entries(raw)) {
+        if (typeof value === 'number')
+            out[toRocksDBCamelCase(key)] = value;
+    }
+    return out;
+}
+/**
+ * Gathers metrics for a RocksDB database.
+ * @param dbName - The name of the database.
+ * @param stats - The stats to build the metric from.
+ * @param lastStats - The last stats to diff the stats from.
+ * @param now - The current time.
+ * @param period - The period to store the metrics for.
+ */
+function buildRocksDBDbMetric(dbName, stats, lastStats, now, period) {
+    const metric = {
+        metric: metadata_ts_1.METRIC.ROCKSDB_STATS,
+        database: dbName,
+        time: now,
+    };
+    if (period !== undefined)
+        metric.period = period;
+    for (const field of ROCKSDB_DB_COUNTERS) {
+        metric[field] = diffRocksDBCounter(stats[field] ?? 0, lastStats?.[field]);
+    }
+    for (const field of ROCKSDB_DB_GAUGES) {
+        metric[field] = stats[field] ?? 0;
+    }
+    return metric;
+}
+/**
+ * Gathers metrics for a RocksDB table. Only gauges are reported per-table; ticker counters
+ * are DB-wide (see ROCKSDB_DB_COUNTERS comment) and live on the DB-level metric.
+ * @param dbName - The name of the database.
+ * @param tableName - The name of the table.
+ * @param stats - The stats to build the metric from.
+ * @param now - The current time.
+ * @param period - The period to store the metrics for.
+ */
+function buildRocksDBTableMetric(dbName, tableName, stats, now, period) {
+    const metric = {
+        metric: metadata_ts_1.METRIC.ROCKSDB_STATS,
+        database: dbName,
+        table: tableName,
+        time: now,
+    };
+    if (period !== undefined)
+        metric.period = period;
+    for (const field of ROCKSDB_TABLE_GAUGES) {
+        metric[field] = stats[field] ?? 0;
+    }
+    return metric;
+}
+/**
+ * Stores the RocksDB stats metrics for the given databases.
+ * @param analyticsTable - The analytics table to store the metrics in.
+ * @param databases - The databases to store the metrics for.
+ * @param now - The current time.
+ * @param period - The period to store the metrics for.
+ */
+function storeRocksDBStatsMetrics(analyticsTable, databases, now, period) {
+    for (const [db, tables] of Object.entries(databases)) {
+        if (!tables)
+            continue; // no tables or not loaded/initialized yet
+        const tableEntries = Object.entries(tables);
+        const [, firstTable] = tableEntries[0] ?? [];
+        if (!(firstTable?.primaryStore instanceof rocksdb_js_1.RocksDatabase))
+            continue;
+        let firstNormalizedStats;
+        for (const [tableName, tbl] of tableEntries) {
+            try {
+                const tableStats = normalizeRocksDBStats(tbl.primaryStore.getStats());
+                if (!firstNormalizedStats)
+                    firstNormalizedStats = tableStats;
+                const tableMetric = buildRocksDBTableMetric(db, tableName, tableStats, now, period);
+                storeMetric(analyticsTable, tableMetric);
+            }
+            catch (error) {
+                // A table may be removed mid-collection — keep iterating siblings.
+                log.warn?.(`Error getting RocksDB stats for table ${db}.${tableName}`, error);
+            }
+        }
+        if (firstNormalizedStats) {
+            // Any table's getStats() returns the same DB-wide counters; reuse the first one's.
+            const lastDbStats = lastRocksDBDbStats.get(db);
+            // Skip the first sample for a db — counters are cumulative since process start,
+            // so reporting them as a delta would produce a misleading spike.
+            if (lastDbStats !== undefined) {
+                const dbMetric = buildRocksDBDbMetric(db, firstNormalizedStats, lastDbStats, now, period);
+                storeMetric(analyticsTable, dbMetric);
+                log.trace?.(`db ${db} rocksdb stats metric: ${JSON.stringify(dbMetric)}`);
+            }
+            lastRocksDBDbStats.set(db, firstNormalizedStats);
+        }
+    }
+}
+/**
+ * Drop cached counter readings for databases that no longer exist, to bound memory
+ * growth across drop/recreate cycles and prevent stale baselines from producing wrong diffs.
+ * @param databases - The databases to prune the stats cache for.
+ */
+function pruneRocksDBStatsCache(databases) {
+    const activeDbs = new Set(Object.keys(databases));
+    for (const key of lastRocksDBDbStats.keys()) {
+        if (!activeDbs.has(key))
+            lastRocksDBDbStats.delete(key);
+    }
+}
+/**
+ * Returns a Databases view that includes the `system` database as an enumerable property.
+ * getDatabases() marks `system` non-enumerable so general consumers skip it; analytics
+ * needs to iterate over it like any other database.
+ */
+function getDatabasesIncludingSystem() {
+    const databases = (0, databases_ts_1.getDatabases)();
+    if (!databases.system)
+        return databases;
+    const all = Object.create(null);
+    Object.assign(all, databases);
+    all.system = databases.system;
+    return all;
+}
 async function getDirectorySizeAsync(dirPath) {
     try {
         const entries = await (0, promises_1.readdir)(dirPath, { withFileTypes: true });
@@ -421,7 +614,7 @@ async function storeNodeStorageMetric(analyticsTable) {
     if (nodeStorageInterval <= 0 || ++nodeStorageCycleCount % nodeStorageInterval !== 1)
         return;
     try {
-        const size = await getDirectorySizeAsync((0, environmentManager_js_1.getHdbBasePath)());
+        const size = await getDirectorySizeAsync((0, environmentManager_ts_1.getHdbBasePath)());
         storeMetric(analyticsTable, {
             metric: metadata_ts_1.METRIC.NODE_STORAGE,
             size,
@@ -440,7 +633,7 @@ async function aggregation(fromPeriod, toPeriod = 60000) {
         await (0, promises_1.stat)(getLogFilePath());
         const delay = performance.now() - start;
         if (delay > 5000) {
-            log.warn?.('Unusually high task queue latency on the main thread of ' + Math.round(now - start) + 'ms');
+            log.warn?.('Unusually high task queue latency on the main thread of ' + Math.round(delay) + 'ms');
         }
         return delay;
     })();
@@ -596,7 +789,9 @@ async function aggregation(fromPeriod, toPeriod = 60000) {
         }
     }
     const now = Date.now();
-    const { idle, active } = performance.eventLoopUtilization();
+    const { idle, active } = globalThis.Bun
+        ? { idle: 0, active: 0 }
+        : performance.eventLoopUtilization();
     // don't record boring entries
     if (hasUpdates || active * 10 > idle) {
         const value = {
@@ -629,13 +824,18 @@ async function aggregation(fromPeriod, toPeriod = 60000) {
     };
     storeMetric(analyticsTable, cruMetric);
     lastResourceUsage = resourceUsage;
+    // `system` is set as non-enumerable on the object returned by getDatabases() so most
+    // callers skip it; for analytics we want it included, so build a view where it's enumerable.
+    const databases = getDatabasesIncludingSystem();
     // database-size & table-size metrics
-    const databases = (0, databases_ts_1.getDatabases)();
     storeDBSizeMetrics(analyticsTable, databases);
-    storeDBSizeMetrics(analyticsTable, { system: databases.system });
     // database storage volume metrics
     storeVolumeMetrics(analyticsTable, databases);
-    storeVolumeMetrics(analyticsTable, { system: databases.system });
+    // rocksdb engine stats (only for RocksDB-backed databases)
+    const rocksDBPeriod = lastRocksDBStatsTime ? now - lastRocksDBStatsTime : undefined;
+    storeRocksDBStatsMetrics(analyticsTable, databases, now, rocksDBPeriod);
+    pruneRocksDBStatsCache(databases);
+    lastRocksDBStatsTime = now;
     // node storage metric (total HDB directory size)
     await storeNodeStorageMetric(analyticsTable);
 }
@@ -647,6 +847,9 @@ let lastResourceUsage = {
 };
 const rest = () => new Promise(setImmediate);
 async function cleanup(AnalyticsTable, expiration) {
+    // Skip writes in read-only mode
+    if ((0, databases_ts_1.isReadOnlyMode)())
+        return;
     const end = Date.now() - expiration;
     for (const key of AnalyticsTable.primaryStore.getKeys({ start: false, end })) {
         AnalyticsTable.primaryStore.remove(key);
@@ -709,13 +912,19 @@ if (!worker_threads_1.parentPort)
 let scheduledTasksRunning;
 function startScheduledTasks() {
     scheduledTasksRunning = true;
-    nodeStorageInterval = (0, environmentManager_js_1.get)(hdbTerms_ts_1.CONFIG_PARAMS.ANALYTICS_STORAGEINTERVAL) ?? DEFAULT_STORAGE_INTERVAL;
-    const AGGREGATE_PERIOD = (0, environmentManager_js_1.get)(hdbTerms_ts_1.CONFIG_PARAMS.ANALYTICS_AGGREGATEPERIOD) * 1000;
+    nodeStorageInterval = (0, environmentManager_ts_1.get)(hdbTerms_ts_1.CONFIG_PARAMS.ANALYTICS_STORAGEINTERVAL) ?? DEFAULT_STORAGE_INTERVAL;
+    const AGGREGATE_PERIOD = (0, environmentManager_ts_1.get)(hdbTerms_ts_1.CONFIG_PARAMS.ANALYTICS_AGGREGATEPERIOD) * 1000;
     if (AGGREGATE_PERIOD) {
+        // Clamp raw retention to at least one full aggregation period so raw records
+        // are never deleted before they can be rolled up.
+        const rawRetentionMs = Math.max((0, environmentManager_ts_1.get)(hdbTerms_ts_1.CONFIG_PARAMS.ANALYTICS_RAWRETENTIONMS) ?? RAW_EXPIRATION, AGGREGATE_PERIOD);
+        const aggregateRetentionMs = (0, environmentManager_ts_1.get)(hdbTerms_ts_1.CONFIG_PARAMS.ANALYTICS_AGGREGATERETENTIONMS) ?? AGGREGATE_EXPIRATION;
         setInterval(async () => {
             await aggregation(exports.analyticsDelay, AGGREGATE_PERIOD);
-            await cleanup(getRawAnalyticsTable(), RAW_EXPIRATION);
-            await cleanup(getAnalyticsTable(), AGGREGATE_EXPIRATION);
+            await cleanup(getRawAnalyticsTable(), rawRetentionMs);
+            // 0 means "keep forever" — skip aggregate cleanup, matching storageInterval: 0 convention
+            if (aggregateRetentionMs)
+                await cleanup(getAnalyticsTable(), aggregateRetentionMs);
         }, Math.min(AGGREGATE_PERIOD / 2, 0x7fffffff)).unref();
     }
 }
@@ -723,6 +932,9 @@ let totalBytesProcessed = 0;
 const lastUtilizations = new Map();
 const LOG_ANALYTICS = false; // TODO: Make this a config option if we really want this
 function recordAnalytics(message, worker) {
+    // Skip writes in read-only mode
+    if ((0, databases_ts_1.isReadOnlyMode)())
+        return;
     const report = message.report;
     report.threadId = worker?.threadId || worker_threads_1.threadId;
     // Add system information stats as well
@@ -732,14 +944,14 @@ function recordAnalytics(message, worker) {
         }
     }
     report.totalBytesProcessed = totalBytesProcessed;
-    if (worker) {
+    if (worker && !isBun) {
         report.metrics.push({
             metric: metadata_ts_1.METRIC.UTILIZATION,
             ...worker.performance.eventLoopUtilization(lastUtilizations.get(worker)),
         });
         lastUtilizations.set(worker, worker.performance.eventLoopUtilization());
     }
-    report.id = (0, commonUtility_js_1.getNextMonotonicTime)();
+    report.id = (0, commonUtility_ts_1.getNextMonotonicTime)();
     getRawAnalyticsTable().primaryStore.put(report.id, report);
     if (!scheduledTasksRunning)
         startScheduledTasks();