import { AbstractWorkerChoiceStrategy } from './abstract-worker-choice-strategy'
import type {
IWorkerChoiceStrategy,
- RequiredStatistics,
+ TaskStatistics,
WorkerChoiceStrategyOptions
} from './selection-strategies-types'
-/**
- * Worker virtual task timestamp.
- */
-interface WorkerVirtualTaskTimestamp {
- start: number
- end: number
-}
-
/**
* Selects the next worker with a fair share scheduling algorithm.
* Loosely modeled after the fair queueing algorithm: https://en.wikipedia.org/wiki/Fair_queuing.
extends AbstractWorkerChoiceStrategy<Worker, Data, Response>
implements IWorkerChoiceStrategy {
/** @inheritDoc */
- public readonly requiredStatistics: RequiredStatistics = {
+ public readonly taskStatistics: TaskStatistics = {
runTime: true,
avgRunTime: true,
- medRunTime: false
+ medRunTime: false,
+ waitTime: false,
+ avgWaitTime: false,
+ medWaitTime: false,
+ elu: false
}
/**
- * Workers' virtual task execution timestamp.
+ * Workers' virtual task end execution timestamp.
*/
- private workersVirtualTaskTimestamp: WorkerVirtualTaskTimestamp[] = []
+ private workersVirtualTaskEndTimestamp: number[] = []
/** @inheritDoc */
public constructor (
opts: WorkerChoiceStrategyOptions = DEFAULT_WORKER_CHOICE_STRATEGY_OPTIONS
) {
super(pool, opts)
- this.checkOptions(this.opts)
+ this.setTaskStatistics(this.opts)
}
/** @inheritDoc */
public reset (): boolean {
- this.workersVirtualTaskTimestamp = []
+ this.workersVirtualTaskEndTimestamp = []
return true
}
/** @inheritDoc */
- public update (): boolean {
- for (const [workerNodeKey] of this.pool.workerNodes.entries()) {
- this.computeWorkerVirtualTaskTimestamp(workerNodeKey)
- }
+ public update (workerNodeKey: number): boolean {
+ this.computeWorkerVirtualTaskEndTimestamp(workerNodeKey)
return true
}
let minWorkerVirtualTaskEndTimestamp = Infinity
let chosenWorkerNodeKey!: number
for (const [workerNodeKey] of this.pool.workerNodes.entries()) {
+ if (this.workersVirtualTaskEndTimestamp[workerNodeKey] == null) {
+ this.computeWorkerVirtualTaskEndTimestamp(workerNodeKey)
+ }
const workerVirtualTaskEndTimestamp =
- this.workersVirtualTaskTimestamp[workerNodeKey]?.end ?? 0
+ this.workersVirtualTaskEndTimestamp[workerNodeKey]
if (workerVirtualTaskEndTimestamp < minWorkerVirtualTaskEndTimestamp) {
minWorkerVirtualTaskEndTimestamp = workerVirtualTaskEndTimestamp
chosenWorkerNodeKey = workerNodeKey
/** @inheritDoc */
public remove (workerNodeKey: number): boolean {
- this.workersVirtualTaskTimestamp.splice(workerNodeKey, 1)
+ this.workersVirtualTaskEndTimestamp.splice(workerNodeKey, 1)
return true
}
/**
- * Computes worker virtual task timestamp.
+ * Computes the worker node key virtual task end timestamp.
*
* @param workerNodeKey - The worker node key.
*/
- private computeWorkerVirtualTaskTimestamp (workerNodeKey: number): void {
- const workerVirtualTaskStartTimestamp = Math.max(
+ private computeWorkerVirtualTaskEndTimestamp (workerNodeKey: number): void {
+ this.workersVirtualTaskEndTimestamp[workerNodeKey] =
+ this.getWorkerVirtualTaskEndTimestamp(
+ workerNodeKey,
+ this.getWorkerVirtualTaskStartTimestamp(workerNodeKey)
+ )
+ }
+
+ private getWorkerVirtualTaskEndTimestamp (
+ workerNodeKey: number,
+ workerVirtualTaskStartTimestamp: number
+ ): number {
+ return (
+ workerVirtualTaskStartTimestamp + this.getWorkerTaskRunTime(workerNodeKey)
+ )
+ }
+
+ private getWorkerVirtualTaskStartTimestamp (workerNodeKey: number): number {
+ return Math.max(
performance.now(),
- this.workersVirtualTaskTimestamp[workerNodeKey]?.end ?? -Infinity
+ this.workersVirtualTaskEndTimestamp[workerNodeKey] ?? -Infinity
)
- const workerVirtualTaskTRunTime = this.requiredStatistics.medRunTime
- ? this.pool.workerNodes[workerNodeKey].tasksUsage.medRunTime
- : this.pool.workerNodes[workerNodeKey].tasksUsage.avgRunTime
- this.workersVirtualTaskTimestamp[workerNodeKey] = {
- start: workerVirtualTaskStartTimestamp,
- end: workerVirtualTaskStartTimestamp + workerVirtualTaskTRunTime
- }
}
}