@harperfast/harper 5.0.0-alpha.10

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

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

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

@@ -0,0 +1,41 @@
+import type { Metric } from './write.ts';
+import type { Conditions } from '../ResourceInterface.ts';
+interface GetAnalyticsRequest {
+    metric: string;
+    start_time?: number;
+    end_time?: number;
+    get_attributes?: string[];
+    coalesce_time?: boolean;
+    conditions?: Conditions;
+}
+type GetAnalyticsResponse = Metric[];
+export declare function getOp(req: GetAnalyticsRequest): Promise<GetAnalyticsResponse>;
+interface GetAnalyticsOpts {
+    getAttributes?: string[];
+    startTime?: number;
+    endTime?: number;
+    coalesceTime?: boolean;
+    additionalConditions?: Conditions;
+}
+export declare function get(metric: string, opts?: GetAnalyticsOpts): Promise<Metric[]>;
+type MetricType = 'builtin' | 'custom';
+interface ListMetricsRequest {
+    metric_types: MetricType[];
+    custom_metrics_window?: number;
+}
+type ListMetricsResponse = string[];
+export declare function listMetricsOp(req: ListMetricsRequest): Promise<ListMetricsResponse>;
+export declare function listMetrics(metricTypes?: MetricType[], customWindow?: number): Promise<string[]>;
+interface DescribeMetricRequest {
+    metric: string;
+}
+interface MetricDescription {
+    name: string;
+    type: string;
+}
+interface DescribeMetricResponse {
+    attributes?: MetricDescription[];
+}
+export declare function describeMetricOp(req: DescribeMetricRequest): Promise<DescribeMetricResponse>;
+export declare function describeMetric(metric: string): Promise<DescribeMetricResponse>;
+export {};

package/dist/resources/analytics/read.js

@@ -0,0 +1,189 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getOp = getOp;
+exports.get = get;
+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 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");
+// default to one week time window for finding custom metrics
+const defaultCustomMetricWindow = 1000 * 60 * 60 * 24 * 7;
+const log = forComponent('analytics').conditional;
+async function lookupHostname(nodeId) {
+    const result = await (0, hostnames_ts_1.getAnalyticsHostnameTable)().get(nodeId);
+    return result.hostname;
+}
+function isSelected(querySelect, attr) {
+    return querySelect.length === 0 || querySelect.includes(attr);
+}
+function getOp(req) {
+    log.trace?.('get_analytics request:', req);
+    return get(req.metric, {
+        getAttributes: req.get_attributes,
+        startTime: req.start_time,
+        endTime: req.end_time,
+        coalesceTime: req.coalesce_time,
+        additionalConditions: req.conditions,
+    });
+}
+function conformCondition(condition) {
+    if ('conditions' in condition) {
+        return {
+            ...condition,
+            conditions: condition.conditions.map(conformCondition),
+        };
+    }
+    return {
+        attribute: condition.search_attribute ?? condition.attribute,
+        comparator: condition.search_type ?? condition.comparator,
+        value: condition.search_value ?? condition.value,
+    };
+}
+async function coalesceResults(results, window) {
+    const coalescedResults = [];
+    let coalesceId;
+    let lastCoalescedId = new Map();
+    for await (const result of results) {
+        const id = result.id;
+        if (!coalesceId) {
+            coalesceId = id;
+        }
+        const delta = Math.abs(id - coalesceId);
+        if (delta < window && lastCoalescedId.get(result.node) !== id) {
+            coalescedResults.push({ ...result, id: coalesceId });
+            lastCoalescedId[result.node] = id;
+        }
+        else {
+            coalescedResults.push(result);
+            coalesceId = id;
+        }
+    }
+    return coalescedResults;
+}
+async function get(metric, opts) {
+    const { getAttributes, startTime, endTime, additionalConditions } = opts ?? {};
+    const conditions = [{ attribute: 'metric', comparator: 'equals', value: metric }];
+    if (additionalConditions) {
+        conditions.push(...additionalConditions.map(conformCondition));
+    }
+    const select = getAttributes ?? [];
+    // ensure we're always selecting id
+    if (!isSelected(select, 'id')) {
+        select.push('id');
+    }
+    if (startTime) {
+        conditions.push({
+            attribute: 'id',
+            comparator: 'greater_than_equal',
+            value: startTime,
+        });
+    }
+    if (endTime) {
+        conditions.push({
+            attribute: 'id',
+            comparator: 'less_than',
+            value: endTime,
+        });
+    }
+    const request = { conditions, allowConditionsOnDynamicAttributes: true };
+    if (select.length > 0) {
+        request['select'] = select;
+    }
+    log.trace?.('get_analytics hdb_analytics.search request:', JSON.stringify(request));
+    const searchResults = await databases.system.hdb_analytics.search(request);
+    let results = searchResults.map(async (result) => {
+        // remove nodeId from 'id' attr and resolve it to the actual hostname and
+        // add back in as 'node' attr if selected
+        const nodeId = result.id[1];
+        result['id'] = result['id'][0];
+        if (isSelected(select, 'node')) {
+            log.trace?.(`get_analytics lookup hostname for nodeId: ${nodeId}`);
+            result['node'] = await lookupHostname(nodeId);
+        }
+        log.trace?.(`get_analytics result:`, JSON.stringify(result));
+        return result;
+    });
+    if (opts?.coalesceTime) {
+        // coalescing window is the aggregate period plus 10% & converted to milliseconds
+        const window = (0, environmentManager_js_1.get)(hdbTerms_ts_1.CONFIG_PARAMS.ANALYTICS_AGGREGATEPERIOD) * 1.1 * 1000;
+        results = await coalesceResults(results, window);
+    }
+    return results;
+}
+function listMetricsOp(req) {
+    return listMetrics(req.metric_types, req.custom_metrics_window);
+}
+async function listMetrics(metricTypes = ['builtin'], customWindow = defaultCustomMetricWindow) {
+    let metrics = [];
+    const builtins = Object.values(metadata_ts_1.METRIC);
+    if (metricTypes.includes('builtin')) {
+        metrics = builtins;
+    }
+    if (metricTypes.includes('custom')) {
+        const oldestCustomId = Date.now() - customWindow;
+        const conditions = [
+            {
+                attribute: 'id',
+                comparator: 'greater_than',
+                value: oldestCustomId,
+            },
+        ];
+        const metricConditions = builtins.map((c) => {
+            return {
+                attribute: 'metric',
+                comparator: 'not_equal',
+                value: c,
+            };
+        });
+        conditions.push(...metricConditions);
+        const customMetricsSearch = {
+            select: ['metric'],
+            conditions: conditions,
+        };
+        const customMetrics = new Set();
+        const searchResults = await databases.system.hdb_analytics.search(customMetricsSearch);
+        for await (const record of searchResults) {
+            customMetrics.add(record.metric);
+        }
+        metrics.push(...Array.from(customMetrics.values()));
+    }
+    return metrics;
+}
+function describeMetricOp(req) {
+    return describeMetric(req.metric);
+}
+async function describeMetric(metric) {
+    const lastEntrySearch = {
+        conditions: [{ attribute: 'metric', comparator: 'equals', value: metric }],
+        sort: {
+            attribute: 'id',
+            descending: true,
+        },
+        limit: 1,
+    };
+    const results = databases.system.hdb_analytics.search(lastEntrySearch);
+    // node is a synthetic attribute, so make sure it's included
+    const attributes = [{ name: 'node', type: 'string' }];
+    for await (const result of results) {
+        for (const attr in result) {
+            attributes.push({ name: attr, type: typeof result[attr] });
+        }
+        const desc = {
+            attributes,
+        };
+        log.trace?.('describe_metric result:', JSON.stringify(desc));
+        return desc;
+    }
+    // if no results, return empty object
+    return {};
+}
+//# sourceMappingURL=read.js.map

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

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

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

@@ -0,0 +1,131 @@
+type ActionCallback = (action: Action) => void;
+export type Value = number | boolean | ActionCallback;
+interface Action {
+    total?: number;
+    values?: Float32Array;
+    count?: number;
+    callback?: ActionCallback;
+    description?: {
+        metric: string;
+        path: string;
+        method: string;
+        type: string;
+    };
+}
+export declare function setAnalyticsEnabled(enabled: boolean): void;
+/**
+ * Record an action for analytics (like an HTTP request, replication, MQTT message)
+ * @param value
+ * @param metric
+ * @param path
+ * @param method
+ * @param type
+ */
+export declare function recordAction(value: Value, metric: string, path?: string, method?: string, type?: string): void;
+export declare function recordActionBinary(value: any, metric: any, path?: any, method?: any, type?: any): void;
+export declare const analyticsDelay = 1000;
+export declare function addAnalyticsListener(callback: any): void;
+export declare function recordHostname(): Promise<void>;
+export interface Metric {
+    [key: string]: any;
+}
+interface ResourceUsage extends Partial<NodeJS.ResourceUsage> {
+    time?: number;
+    period?: number;
+    cpuUtilization?: number;
+    userCPUTime?: number;
+    systemCPUTime?: number;
+}
+/** calculateCPUUtilization takes a ResourceUsage with at least userCPUTime &
+ *  systemCPUTime set with millisecond values and a time period in milliseconds
+ *  and returns the percentage of that time the CPU was being utilized as a
+ *  decimal value between 0 and 1. So for example, 50% utilization will be
+ *  returned as 0.5.
+ */
+export declare function calculateCPUUtilization(resourceUsage: ResourceUsage, period: number): number;
+/** diffResourceUsage takes a ResourceUsage representing the last time we stored them and a new
+ *  process.resourceUsage() return value and normalizes and diffs the two values to return the
+ *  new values for this time period.
+ */
+export declare function diffResourceUsage(lastResourceUsage: ResourceUsage, resourceUsage: ResourceUsage): ResourceUsage;
+export declare function onAnalyticsAggregate(callback: any): void;
+export {};
+/**
+ * This section contains a possible/experimental approach to bucketing values as they come instead of pushing all into an array and sorting.
+ *
+const BUCKET_COUNT = 100;
+function addToBucket(action, value) {
+    if (!action.buckets) {
+        action.buckets = newBuckets();
+    }
+    const { counts, values, totalCount } = action.buckets;
+    let jump = BUCKET_COUNT >> 1; // amount to jump with each iteration
+    let position = jump; // start at halfway point
+    while ((jump = jump >> 1) > 0) {
+        const bucketValue = values[position];
+        if (bucketValue === 0) {
+            // unused slot, immediately put our value in
+            counts[position] = 1;
+            values[position] = value;
+        }
+        if (value > bucketValue) {
+            position += jump;
+        } else {
+            position -= jump;
+        }
+    }
+    const count = counts[position] + 1;
+    if (position === BUCKET_COUNT) {
+        // if we go beyond the last item, increase the bucket (max) value
+        position--;
+        values[position] = value;
+    }
+    if (count > threshold) {
+        rebalance(action.buckets, false);
+    } else {
+        counts[position] = count;
+    }
+}
+
+function newBuckets() {
+    const ab = new ArrayBuffer(8 * BUCKET_COUNT);
+    return {
+        values: new Float32Array(ab, 0, BUCKET_COUNT),
+        counts: new Uint32Array(ab, BUCKET_COUNT * 4, BUCKET_COUNT),
+        totalCount: 0,
+    };
+}
+
+let balancingBuckets;
+
+ /**
+ * Rebalance the buckets, we can reset the counts at the same time, if this occurred after a delivery
+ * @param param
+ * @param resetCounts
+ *
+function rebalance({ counts, values, totalCount }, resetCounts: boolean) {
+    const countPerBucket = totalCount / BUCKET_COUNT;
+    let targetPosition = 0;
+    let targetCount = 0;
+    let lastTargetValue = 0;
+    const { values: targetValues, counts: targetCounts } = balancingBuckets || (balancingBuckets = newBuckets());
+    for (let i = 0; i < BUCKET_COUNT; i++) {
+        // iterate through the existing buckets, filling up the target buckets in a balanced way
+        let count = counts[i];
+        while ((countPerBucket - targetCount) < count) {
+            const value = values[i];
+            lastTargetValue = ((countPerBucket - targetCount) / count) * (value - lastTargetValue) + lastTargetValue;
+            targetValues[targetPosition] = lastTargetValue;
+            targetCounts[targetPosition] = countPerBucket;
+            count -= countPerBucket;
+            targetPosition++;
+            targetCount = 0;
+        }
+        targetCount += count;
+    }
+    // now copy the balanced buckets back into the original buckets
+    values.set(targetValues);
+    if (resetCounts) counts.fill(0);
+    else counts.set(targetCounts);
+}
+*/