X-Git-Url: https://git.piment-noir.org/?a=blobdiff_plain;f=src%2Fpools%2Fselection-strategies%2Fselection-strategies-types.ts;h=0fbb4d4d43165737d3bd3c0c7378b2c55d7e03d2;hb=4eb9e75a6d47a08541d38b70505e5ba1126aa2f1;hp=18ba40b410d5190271a82d248a12b5e2179485de;hpb=a77ac8fcba99a9580ff6524d70d2fab7dbdd448d;p=poolifier.git diff --git a/src/pools/selection-strategies/selection-strategies-types.ts b/src/pools/selection-strategies/selection-strategies-types.ts index 18ba40b4..0fbb4d4d 100644 --- a/src/pools/selection-strategies/selection-strategies-types.ts +++ b/src/pools/selection-strategies/selection-strategies-types.ts @@ -14,6 +14,12 @@ export const WorkerChoiceStrategies = Object.freeze({ * Least busy worker selection strategy. */ LEAST_BUSY: 'LEAST_BUSY', + /** + * Least ELU worker selection strategy. + * + * @experimental + */ + LEAST_ELU: 'LEAST_ELU', /** * Fair share worker selection strategy. */ @@ -35,22 +41,32 @@ export const WorkerChoiceStrategies = Object.freeze({ */ export type WorkerChoiceStrategy = keyof typeof WorkerChoiceStrategies +/** + * Measurement options. + */ +interface MeasurementOptions { + /** + * Set measurement median. + */ + median: boolean +} + /** * Worker choice strategy options. */ export interface WorkerChoiceStrategyOptions { /** - * Use tasks median runtime instead of average runtime. + * Runtime options. * - * @defaultValue false + * @defaultValue \{ median: false \} */ - medRunTime?: boolean + runTime?: MeasurementOptions /** - * Use tasks median wait time instead of average runtime. + * Wait time options. * - * @defaultValue false + * @defaultValue \{ median: false \} */ - medWaitTime?: boolean + waitTime?: MeasurementOptions /** * Worker weights to use for weighted round robin worker selection strategy. * Weight is the tasks maximum average or median runtime in milliseconds. @@ -61,35 +77,43 @@ export interface WorkerChoiceStrategyOptions { } /** - * Pool worker tasks usage statistics requirements. + * Measurement statistics requirements. * * @internal */ -export interface RequiredStatistics { +interface MeasurementStatisticsRequirements { /** - * Require tasks runtime. + * Require measurement aggregate. */ - runTime: boolean + aggregate: boolean /** - * Require tasks average runtime. + * Require measurement average. */ - avgRunTime: boolean + average: boolean /** - * Require tasks median runtime. + * Require measurement median. */ - medRunTime: boolean + median: boolean +} + +/** + * Pool worker node worker usage statistics requirements. + * + * @internal + */ +export interface TaskStatisticsRequirements { /** - * Require tasks wait time. + * Tasks runtime requirements. */ - waitTime: boolean + runTime: MeasurementStatisticsRequirements /** - * Require tasks average wait time. + * Tasks wait time requirements. */ - avgWaitTime: boolean + waitTime: MeasurementStatisticsRequirements /** - * Require tasks median wait time. + * Event loop utilization. */ - medWaitTime: boolean + elu: boolean } /** @@ -97,9 +121,9 @@ export interface RequiredStatistics { */ export interface IWorkerChoiceStrategy { /** - * Required tasks usage statistics. + * Tasks statistics requirements. */ - readonly requiredStatistics: RequiredStatistics + readonly taskStatisticsRequirements: TaskStatisticsRequirements /** * Resets strategy internals. *