@tencent-rtc/mcp 1.0.0

package/@tencent/polaris/dist/consumer/index.js

@@ -0,0 +1,348 @@
+"use strict";
+var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
+    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
+};
+var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
+    if (kind === "m") throw new TypeError("Private method is not writable");
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
+    return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
+};
+var _a, _Consumer_currentInstances, _Consumer_maxInstances;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Consumer = exports.InternalConsumer = exports.SelectResponse = void 0;
+const process_1 = require("process");
+const errors_1 = require("../errors");
+const plugins_1 = require("../plugins");
+const polaris_1 = require("../plugins/breaker/polaris");
+const wr_1 = require("../plugins/lb/wr");
+const console_1 = require("../plugins/logging/console");
+const memory_1 = require("../plugins/registry/memory");
+const nearby_1 = require("../plugins/router/polaris/nearby");
+const rule_1 = require("../plugins/router/polaris/rule");
+const polaris_2 = require("../plugins/weight/polaris");
+const registry_1 = require("../registry");
+const skeleton_1 = require("../skeleton");
+const utils_1 = require("../utils");
+const health_1 = require("./health");
+const monitor_1 = require("./monitor");
+const selector_1 = require("./selector");
+const kSelector = Symbol("kSelector");
+const kMonitor = Symbol("kMonitor");
+const kHealth = Symbol("kHealth");
+const kRegistry = Symbol("kRegistry");
+class SelectResponse {
+    constructor(callee, instance, monitor) {
+        this.callee = callee;
+        this.instance = instance;
+        this[kMonitor] = monitor;
+    }
+    /**
+     * 上报调用结果
+     * @param success 是否调用成功
+     * @param cost 调用耗时（需大于等于 0，默认为 0）
+     * @param code 返回码（可选）
+     */
+    update(success, cost = 0, code) {
+        this[kMonitor].update(this.callee.namespace, this.callee.service, this.instance, success, cost, code);
+    }
+}
+exports.SelectResponse = SelectResponse;
+/**
+ * For internal use only.
+ * Use `Consumer` instead of `InternalConsumer`.
+ */
+class InternalConsumer extends skeleton_1.SkeletonClass {
+    /**
+     * Create Consumer
+     * @param plugins 插件
+     * @param options 配置参数（可选）
+     * @param logger Logger 对象共享，如不传则会自动创建
+     */
+    constructor(plugins, options = {}, logger) {
+        const pluginList = InternalConsumer.mergePluginList(plugins, options);
+        super(pluginList, options, logger);
+        const naming = pluginList[plugins_1.PluginType.NamingService];
+        switch (naming.mode) {
+            case plugins_1.OperatingMode.Internal: {
+                this[kRegistry] = new registry_1.LocalRegistry(this[skeleton_1.kLogger], naming, this.plugins[plugins_1.PluginType.LocalRegistry], this.plugins[plugins_1.PluginType.StatReporter], undefined, options);
+                this[kHealth] = new health_1.Health(this[skeleton_1.kLogger], this[kRegistry], this.plugins[plugins_1.PluginType.LoadBalancer], this.plugins[plugins_1.PluginType.OutlierDetector], this.plugins[plugins_1.PluginType.StatReporter], options);
+                this[kRegistry].on("SyncInstanceStatus" /* SyncInstanceStatus */, (namespace, service, instance, status) => {
+                    this[kHealth].changeStatus(namespace, service, instance, status, "[Registry], synchronized by naming");
+                });
+                this[kSelector] = new selector_1.InternalSelector(this[skeleton_1.kGlobal], this[skeleton_1.kLogger], this[kHealth], this[kRegistry], this.plugins[plugins_1.PluginType.ServiceRouter], this.plugins[plugins_1.PluginType.LoadBalancer], options);
+                this[kMonitor] = new monitor_1.InternalMonitor(this[skeleton_1.kLogger], this[kHealth], this[kRegistry], this.plugins[plugins_1.PluginType.WeightAdjuster], this.plugins[plugins_1.PluginType.StatReporter], this.plugins[plugins_1.PluginType.CircuitBreaker], options);
+                break;
+            }
+            case plugins_1.OperatingMode.External: {
+                this[kSelector] = new selector_1.ExternalSelector(naming);
+                this[kMonitor] = new monitor_1.ExternalMonitor(this[skeleton_1.kLogger], this.plugins[plugins_1.PluginType.StatReporter]);
+                break;
+            }
+            default: {
+                (0, utils_1.UNREACHABLE)();
+            }
+        }
+    }
+    static mergePluginList(plugins, options) {
+        const pluginList = {
+            [plugins_1.PluginType.NamingService]: plugins[plugins_1.PluginType.NamingService],
+            [plugins_1.PluginType.LocalRegistry]: plugins[plugins_1.PluginType.LocalRegistry] || new memory_1.MemoryOnlyRegistry(),
+            [plugins_1.PluginType.LoadBalancer]: plugins[plugins_1.PluginType.LoadBalancer] || new wr_1.WRLoadBalancer(),
+            [plugins_1.PluginType.ServiceRouter]: plugins[plugins_1.PluginType.ServiceRouter] || [new rule_1.PolarisRuleRouter(), new nearby_1.PolarisNearbyRouter()],
+            [plugins_1.PluginType.TraceLogging]: plugins[plugins_1.PluginType.TraceLogging] || [new console_1.ConsoleTraceLogging()],
+            [plugins_1.PluginType.WeightAdjuster]: plugins[plugins_1.PluginType.WeightAdjuster] || [],
+            [plugins_1.PluginType.OutlierDetector]: plugins[plugins_1.PluginType.OutlierDetector] || [],
+            [plugins_1.PluginType.StatReporter]: plugins[plugins_1.PluginType.StatReporter] || [],
+            [plugins_1.PluginType.CircuitBreaker]: plugins[plugins_1.PluginType.CircuitBreaker]
+        };
+        /**
+         * 在某些特殊场景下，为了避免死循环与内存开销，
+         * `NamingService` 与 `StatReporter` 插件实现在一个对象内
+         */
+        const naming = pluginList[plugins_1.PluginType.NamingService];
+        if ((0, skeleton_1.isStatReporterPlugin)(naming)) {
+            pluginList[plugins_1.PluginType.StatReporter].push(naming);
+        }
+        /**
+         * `LoadBalancer` 插件不支持动态权重调整时，则不开启
+         */
+        if (pluginList[plugins_1.PluginType.LoadBalancer].supportedWeightType !== 0 /* Dynamic */) {
+            options.enableDynamicWeights = false;
+        }
+        /**
+         * 如启用动态权重调整，又未配置插件实现时，使用默认实现
+         */
+        if (options.enableDynamicWeights && pluginList[plugins_1.PluginType.WeightAdjuster].length === 0) {
+            pluginList[plugins_1.PluginType.WeightAdjuster] = [new polaris_2.PolarisDynamicWeight()];
+        }
+        /**
+         * 如启用节点熔断插件，又未配置插件实现时，使用默认实现
+         */
+        if ((!options.breakerSwitch || options.breakerSwitch.period || options.breakerSwitch.realtime)
+            && !pluginList[plugins_1.PluginType.CircuitBreaker]) {
+            pluginList[plugins_1.PluginType.CircuitBreaker] = new polaris_1.PolarisCircuitBreaker();
+        }
+        return pluginList;
+    }
+    /**
+     * 销毁（释放）所占资源
+     *
+     * @description
+     * dispose order:
+     *  Monitor -> Health -> Selector -> Registry -> [plguins]
+     *
+     * @param sync 是否同步释放（可选）
+     */
+    dispose(sync = false) {
+        var _b, _c;
+        const { [skeleton_1.kLogger]: logger, [skeleton_1.kDisposed]: disposed } = this;
+        if (disposed) {
+            return;
+        }
+        logger.trace("Consumer" /* Consumer */, Consumer.name, "dispose", undefined, "started");
+        this[kMonitor].dispose();
+        this[kHealth].dispose();
+        (_c = (_b = this[kSelector]).dispose) === null || _c === void 0 ? void 0 : _c.call(_b);
+        this[kRegistry].dispose();
+        super.dispose(sync);
+        logger.trace("Consumer" /* Consumer */, Consumer.name, "dispose", undefined, "dispose completed");
+    }
+    async select(...args) {
+        const startTime = (0, process_1.uptime)();
+        let callee;
+        let caller;
+        let callArgs;
+        if (typeof args[0] === "string" && typeof args[1] === "string") {
+            const exactArgs = args;
+            callee = {
+                namespace: exactArgs[0],
+                service: exactArgs[1],
+                metadata: exactArgs[2]
+            };
+            const [, , metadata] = exactArgs;
+            if (metadata) {
+                caller = {
+                    namespace: "",
+                    service: "",
+                    metadata
+                };
+            }
+            [, , , callArgs] = exactArgs;
+        }
+        else {
+            [callee, caller, callArgs] = args;
+        }
+        const { [skeleton_1.kLogger]: logger } = this;
+        const { transaction } = logger;
+        this[skeleton_1.kLogger].trace("Consumer" /* Consumer */, Consumer.name, "select", transaction, "caller is", caller, "callee is", callee, "with args:", callArgs);
+        let instance = null;
+        let err;
+        try {
+            this[skeleton_1.kMaybeAlreadyDisposed]();
+            instance = await this[kSelector].select(callee, caller, callArgs);
+        }
+        catch (e) {
+            err = e;
+        }
+        this[skeleton_1.kAPICollector]("Consumer.select", ((0, process_1.uptime)() - startTime) * utils_1.kSeconds, err);
+        if (err) {
+            logger.trace("Consumer" /* Consumer */, Consumer.name, "select", transaction, "exception", err);
+            throw err;
+        }
+        if (instance === null) {
+            logger.trace("Consumer" /* Consumer */, Consumer.name, "select", transaction, "not found matching instance");
+            return null;
+        }
+        logger.trace("Consumer" /* Consumer */, Consumer.name, "select", transaction, "selected instance is", instance);
+        return new SelectResponse(callee, instance, this[kMonitor]);
+    }
+    /**
+     * 获取全部服务实例
+     * @param namespace 服务名字空间
+     * @param service 服务名
+     */
+    async list(namespace, service) {
+        const startTime = (0, process_1.uptime)();
+        const { [skeleton_1.kLogger]: logger } = this;
+        const { transaction } = logger;
+        if (logger.tracingEnabled) {
+            logger.trace("Consumer" /* Consumer */, Consumer.name, "list", transaction, `list ${namespace}.${service} instances`);
+        }
+        let err;
+        try {
+            this[skeleton_1.kMaybeAlreadyDisposed]();
+            const instances = await this[kSelector].list(namespace, service);
+            logger.trace("Consumer" /* Consumer */, Consumer.name, "list", transaction, "all instances:", instances);
+            return instances;
+        }
+        catch (e) {
+            err = e;
+        }
+        finally {
+            this[skeleton_1.kAPICollector]("Consumer.list", ((0, process_1.uptime)() - startTime) * utils_1.kSeconds, err);
+        }
+        logger.trace("Consumer" /* Consumer */, Consumer.name, "list", transaction, "exception", err);
+        throw err;
+    }
+    /**
+     * 获取服务规则路由
+     * @param namespace 服务名字空间
+     * @param service 服务名
+     */
+    async rules(namespace, service) {
+        const startTime = (0, process_1.uptime)();
+        const { [skeleton_1.kLogger]: logger } = this;
+        const { transaction } = logger;
+        if (logger.tracingEnabled) {
+            logger.trace("Consumer" /* Consumer */, Consumer.name, "rules", transaction, `list ${namespace}.${service} rules`);
+        }
+        let err;
+        try {
+            this[skeleton_1.kMaybeAlreadyDisposed]();
+            const rules = await this[kSelector].rules(namespace, service);
+            logger.trace("Consumer" /* Consumer */, Consumer.name, "rules", transaction, "service rules:", rules);
+            return rules;
+        }
+        catch (e) {
+            err = e;
+        }
+        finally {
+            this[skeleton_1.kAPICollector]("Consumer.rules", ((0, process_1.uptime)() - startTime) * utils_1.kSeconds, err);
+        }
+        logger.trace("Consumer" /* Consumer */, Consumer.name, "rules", transaction, "exception", err);
+        throw err;
+    }
+    /**
+     * 强制刷新缓存
+     * @param namespace 服务名字空间
+     * @param service 服务名
+     * @param type 数据存储类别
+     */
+    async update(namespace, service, type) {
+        const startTime = (0, process_1.uptime)();
+        const { [skeleton_1.kLogger]: logger } = this;
+        const { transaction } = logger;
+        if (logger.tracingEnabled) {
+            logger.trace("Consumer" /* Consumer */, Consumer.name, "update", transaction, `update ${namespace}.${service} ${type}`);
+        }
+        let err;
+        try {
+            this[skeleton_1.kMaybeAlreadyDisposed]();
+            const hasUpdated = await this[kRegistry].update(type, namespace, service);
+            logger.trace("Consumer" /* Consumer */, Consumer.name, "update", transaction, hasUpdated ? "no updates" : `updated ${type}`);
+            return hasUpdated;
+        }
+        catch (e) {
+            err = e;
+        }
+        finally {
+            this[skeleton_1.kAPICollector]("Consumer.update", ((0, process_1.uptime)() - startTime) * utils_1.kSeconds, err);
+        }
+        logger.trace("Consumer" /* Consumer */, Consumer.name, "update", transaction, "exception", err);
+        throw err;
+    }
+}
+exports.InternalConsumer = InternalConsumer;
+class Consumer extends InternalConsumer {
+    /**
+     * Create Consumer
+     * @param plugins 插件
+     * @param options 配置参数（可选）
+     */
+    constructor(plugins, options = {}) {
+        var _b;
+        super(plugins, options);
+        __classPrivateFieldSet(_b = Consumer, _a, __classPrivateFieldGet(_b, _a, "f", _Consumer_currentInstances) + 1, "f", _Consumer_currentInstances);
+        if (__classPrivateFieldGet(Consumer, _a, "f", _Consumer_currentInstances) >= __classPrivateFieldGet(Consumer, _a, "f", _Consumer_maxInstances)) {
+            (0, skeleton_1.emitMaxInstancesExceededWarning)("Consumer", __classPrivateFieldGet(Consumer, _a, "f", _Consumer_maxInstances));
+        }
+    }
+    /**
+     * 当前可实例化的最大次数
+     */
+    static get maxInstances() {
+        return __classPrivateFieldGet(Consumer, _a, "f", _Consumer_maxInstances);
+    }
+    /**
+     * 设置可实例化的最大次数
+     * @param n 最大次数
+     */
+    static setMaxInstances(n) {
+        if (typeof n !== "number" || n < 0 || Number.isNaN(n)) {
+            throw new errors_1.ArgumentError("|n| must be a non-negative number");
+        }
+        __classPrivateFieldSet(Consumer, _a, n, "f", _Consumer_maxInstances);
+    }
+    /**
+     * 销毁（释放）所占资源
+     * @param sync 是否同步释放（可选）
+     */
+    dispose(sync = false) {
+        var _b;
+        if (this[skeleton_1.kDisposed]) {
+            return;
+        }
+        super.dispose(sync);
+        __classPrivateFieldSet(_b = Consumer, _a, __classPrivateFieldGet(_b, _a, "f", _Consumer_currentInstances) - 1, "f", _Consumer_currentInstances);
+        if (__classPrivateFieldGet(Consumer, _a, "f", _Consumer_currentInstances) < 0) {
+            (0, utils_1.UNREACHABLE)();
+        }
+    }
+}
+exports.Consumer = Consumer;
+_a = Consumer;
+_Consumer_currentInstances = { value: 0 };
+_Consumer_maxInstances = { value: void 0 };
+(() => {
+    let maxInstances = 10;
+    const { POLARIS_CONSUMER_INSTANCE_LIMIT } = process.env;
+    if (POLARIS_CONSUMER_INSTANCE_LIMIT !== undefined) {
+        maxInstances = parseInt(POLARIS_CONSUMER_INSTANCE_LIMIT, 10);
+        maxInstances = (maxInstances === 0 /** Unlimited */ ? Infinity : maxInstances);
+    }
+    _a.setMaxInstances(maxInstances);
+})();
+//# sourceMappingURL=index.js.map

package/@tencent/polaris/dist/consumer/index.js.map

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

package/@tencent/polaris/dist/consumer/monitor.d.ts

@@ -0,0 +1,145 @@
+/// <reference types="node" />
+import { Instance } from "../instance";
+import { Logger } from "../logging";
+import { CircuitBreakerPlugin, StatReporterPlugin, WeightAdjusterPlugin } from "../plugins";
+import { LocalRegistry } from "../registry";
+import { Health } from "./health";
+export interface StatProp {
+    /**
+     * 总调用量，其值可为 0
+     */
+    count: number;
+    /**
+     * 总耗时，其值可为 0
+     */
+    cost: number;
+}
+/**
+ * 用于 `BucketStat` 索引
+ *
+ * 第一个字符代表调用是否成功（0 为失败，1 为成功），剩余部分代表返回状态码
+ *
+ * Background:
+ * 由于 ECMAScript 没有办法重写对象 Key 的比较函数，
+ * 所以这里将维度打平为字符串以提高查找性能，以减少额外开销
+ */
+declare type BucketStatKey = `${0 | 1}${string}`;
+export interface ComputeStatKey {
+    /**
+     * 是否调用成功
+     */
+    success: boolean;
+    /**
+     * 返回码
+     */
+    code: string;
+}
+export interface ComputedStat {
+    /**
+     * 统计周期
+     */
+    statWindow: number;
+    /**
+     * 汇总统计值
+     */
+    summaryStat: Map<Instance, Map<ComputeStatKey, StatProp>>;
+}
+/**
+ * 采用滑动窗口，分桶方式进行
+ */
+interface BucketStat {
+    /**
+     * 所在统计周期
+     */
+    period: number;
+    /**
+     * 统计值
+     */
+    stat: Record<BucketStatKey, StatProp>;
+}
+declare const kDefaultOptions: {
+    /**
+     * 统计周期
+     *
+     * 与统计单元数，共同确定了统计数据的计算间隔（监控子的系统最小分辨率）
+     */
+    statWindow: number;
+    /**
+     * 统计单元数
+     *
+     * 与统计周期，共同确定了统计数据的计算间隔（监控子的系统最小分辨率）
+     */
+    bucketsCount: number;
+    /**
+     * 是否开启动态权重
+     *
+     * 仅 `InternalMonitor` 有效
+     */
+    enableDynamicWeights: boolean;
+    /**
+     * 节点熔断插件开启状态
+     *
+     * 仅 `InternalMonitor` 有效
+     */
+    breakerSwitch: {
+        /**
+         * 实时熔断是否开启
+         */
+        realtime: boolean;
+        /**
+         * 周期熔断是否开启
+         */
+        period: boolean;
+    };
+};
+export declare type MonitorOptions = typeof kDefaultOptions;
+/** 统计要求 */
+declare const enum StatisticalBitfield {
+    /** 不做任何统计 */
+    None = 0,
+    /** 统计全量数据 */
+    Full = 1,
+    /** 仅统计存活数据，实例状态不为 `Fused` */
+    Alive = 2
+}
+declare class StatStore {
+    store: Partial<Record<string, Partial<Record<string, Map<Instance, BucketStat[]>>>>>;
+    get(namespace: string, service: string): Map<Instance, BucketStat[]>;
+}
+export declare abstract class Monitor {
+    protected currentPeriod: number;
+    protected timer: NodeJS.Timeout | undefined;
+    protected disposed: boolean;
+    protected fullStat?: StatStore;
+    protected aliveStat?: StatStore;
+    protected abstract options: MonitorOptions;
+    constructor(requisite?: StatisticalBitfield);
+    dispose(): void;
+    update(namespace: string, service: string, instance: Instance, success: boolean, cost: number, code?: string): void;
+    private performUpdate;
+    protected abstract compute(): void;
+}
+export declare class InternalMonitor extends Monitor {
+    protected options: MonitorOptions;
+    private readonly health;
+    private readonly logger;
+    private readonly registry;
+    private readonly breaker?;
+    private readonly adjusters;
+    private readonly reporters;
+    constructor(logger: Logger, health: Health, registry: LocalRegistry, adjusters: WeightAdjusterPlugin[], reporters: StatReporterPlugin[], breaker?: CircuitBreakerPlugin, options?: Partial<MonitorOptions>);
+    update(namespace: string, service: string, instance: Instance, success: boolean, cost: number, code?: string): void;
+    protected performCompute({ store }: StatStore, handle: (namespace: string, service: string, computed: ComputedStat) => void): void;
+    protected compute(): void;
+    private performFullStat;
+    private performAliveStat;
+}
+export declare class ExternalMonitor extends Monitor {
+    protected options: MonitorOptions;
+    private readonly logger;
+    private readonly reporters;
+    private nowPeriod;
+    constructor(logger: Logger, reporters: StatReporterPlugin[], options?: Partial<MonitorOptions>);
+    compute(): Promise<void>;
+}
+export {};