1 import { cpus
} from
'node:os'
3 import type { IPool
} from
'../pool.js'
4 import type { IWorker
} from
'../worker.js'
5 import type { WorkerChoiceStrategiesContext
} from
'./worker-choice-strategies-context.js'
7 import { FairShareWorkerChoiceStrategy
} from
'./fair-share-worker-choice-strategy.js'
8 import { InterleavedWeightedRoundRobinWorkerChoiceStrategy
} from
'./interleaved-weighted-round-robin-worker-choice-strategy.js'
9 import { LeastBusyWorkerChoiceStrategy
} from
'./least-busy-worker-choice-strategy.js'
10 import { LeastEluWorkerChoiceStrategy
} from
'./least-elu-worker-choice-strategy.js'
11 import { LeastUsedWorkerChoiceStrategy
} from
'./least-used-worker-choice-strategy.js'
12 import { RoundRobinWorkerChoiceStrategy
} from
'./round-robin-worker-choice-strategy.js'
14 type IWorkerChoiceStrategy
,
15 type MeasurementStatisticsRequirements
,
17 type TaskStatisticsRequirements
,
18 WorkerChoiceStrategies
,
19 type WorkerChoiceStrategy
,
20 type WorkerChoiceStrategyOptions
,
21 } from
'./selection-strategies-types.js'
22 import { WeightedRoundRobinWorkerChoiceStrategy
} from
'./weighted-round-robin-worker-choice-strategy.js'
24 const estimatedCpuSpeed
= (): number => {
25 const runs
= 150000000
26 const begin
= performance
.now()
27 // eslint-disable-next-line no-empty
28 for (let i
= runs
; i
> 0; i
--) {}
29 const end
= performance
.now()
30 const duration
= end
- begin
31 return Math.trunc(runs
/ duration
/ 1000) // in MHz
34 const getDefaultWorkerWeight
= (): number => {
35 const currentCpus
= cpus()
36 let estCpuSpeed
: number | undefined
37 // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition
38 if (currentCpus
.every(cpu
=> cpu
.speed
== null || cpu
.speed
=== 0)) {
39 estCpuSpeed
= estimatedCpuSpeed()
41 let cpusCycleTimeWeight
= 0
42 for (const cpu
of currentCpus
) {
43 // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition
44 if (cpu
.speed
== null || cpu
.speed
=== 0) {
46 // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition
47 currentCpus
.find(cpu
=> cpu
.speed
!= null && cpu
.speed
!== 0)?.speed
??
51 // CPU estimated cycle time
52 const numberOfDigits
= cpu
.speed
.toString().length
- 1
53 const cpuCycleTime
= 1 / (cpu
.speed
/ Math.pow(10, numberOfDigits
))
54 cpusCycleTimeWeight
+= cpuCycleTime
* Math.pow(10, numberOfDigits
)
56 return Math.round(cpusCycleTimeWeight
/ currentCpus
.length
)
59 const getDefaultWeights
= (
61 defaultWorkerWeight
?: number
62 ): Record
<number, number> => {
63 defaultWorkerWeight
= defaultWorkerWeight
?? getDefaultWorkerWeight()
64 const weights
: Record
<number, number> = {}
65 for (let workerNodeKey
= 0; workerNodeKey
< poolMaxSize
; workerNodeKey
++) {
66 weights
[workerNodeKey
] = defaultWorkerWeight
71 export const getWorkerChoiceStrategiesRetries
= <
72 Worker
extends IWorker
,
76 pool
: IPool
<Worker
, Data
, Response
>,
77 opts
?: WorkerChoiceStrategyOptions
81 Object.keys(opts
?.weights
?? getDefaultWeights(pool
.info
.maxSize
)).length
85 export const buildWorkerChoiceStrategyOptions
= <
86 Worker
extends IWorker
,
90 pool
: IPool
<Worker
, Data
, Response
>,
91 opts
?: WorkerChoiceStrategyOptions
92 ): WorkerChoiceStrategyOptions
=> {
93 opts
= structuredClone(opts
?? {})
94 opts
.weights
= opts
.weights
?? getDefaultWeights(pool
.info
.maxSize
)
97 elu
: { median
: false },
98 runTime
: { median
: false },
99 waitTime
: { median
: false },
105 export const toggleMedianMeasurementStatisticsRequirements
= (
106 measurementStatisticsRequirements
: MeasurementStatisticsRequirements
,
107 toggleMedian
: boolean
109 if (measurementStatisticsRequirements
.average
&& toggleMedian
) {
110 measurementStatisticsRequirements
.average
= false
111 measurementStatisticsRequirements
.median
= toggleMedian
113 if (measurementStatisticsRequirements
.median
&& !toggleMedian
) {
114 measurementStatisticsRequirements
.average
= true
115 measurementStatisticsRequirements
.median
= toggleMedian
119 export const buildWorkerChoiceStrategiesPolicy
= (
120 workerChoiceStrategies
: Map
<WorkerChoiceStrategy
, IWorkerChoiceStrategy
>
121 ): StrategyPolicy
=> {
122 const policies
: StrategyPolicy
[] = Array.from(
123 workerChoiceStrategies
,
124 ([_
, workerChoiceStrategy
]) => workerChoiceStrategy
.strategyPolicy
127 dynamicWorkerReady
: policies
.some(p
=> p
.dynamicWorkerReady
),
128 dynamicWorkerUsage
: policies
.some(p
=> p
.dynamicWorkerUsage
),
132 export const buildWorkerChoiceStrategiesTaskStatisticsRequirements
= (
133 workerChoiceStrategies
: Map
<WorkerChoiceStrategy
, IWorkerChoiceStrategy
>
134 ): TaskStatisticsRequirements
=> {
135 const taskStatisticsRequirements
: TaskStatisticsRequirements
[] = Array.from(
136 workerChoiceStrategies
,
137 ([_
, workerChoiceStrategy
]) =>
138 workerChoiceStrategy
.taskStatisticsRequirements
142 aggregate
: taskStatisticsRequirements
.some(r
=> r
.elu
.aggregate
),
143 average
: taskStatisticsRequirements
.some(r
=> r
.elu
.average
),
144 median
: taskStatisticsRequirements
.some(r
=> r
.elu
.median
),
147 aggregate
: taskStatisticsRequirements
.some(r
=> r
.runTime
.aggregate
),
148 average
: taskStatisticsRequirements
.some(r
=> r
.runTime
.average
),
149 median
: taskStatisticsRequirements
.some(r
=> r
.runTime
.median
),
152 aggregate
: taskStatisticsRequirements
.some(r
=> r
.waitTime
.aggregate
),
153 average
: taskStatisticsRequirements
.some(r
=> r
.waitTime
.average
),
154 median
: taskStatisticsRequirements
.some(r
=> r
.waitTime
.median
),
159 export const getWorkerChoiceStrategy
= <Worker
extends IWorker
, Data
, Response
>(
160 workerChoiceStrategy
: WorkerChoiceStrategy
,
161 pool
: IPool
<Worker
, Data
, Response
>,
162 context
: ThisType
<WorkerChoiceStrategiesContext
<Worker
, Data
, Response
>>,
163 opts
?: WorkerChoiceStrategyOptions
164 ): IWorkerChoiceStrategy
=> {
165 switch (workerChoiceStrategy
) {
166 case WorkerChoiceStrategies
.FAIR_SHARE
:
167 return new (FairShareWorkerChoiceStrategy
.bind(context
))(pool
, opts
)
168 case WorkerChoiceStrategies
.INTERLEAVED_WEIGHTED_ROUND_ROBIN
:
169 return new (InterleavedWeightedRoundRobinWorkerChoiceStrategy
.bind(
172 case WorkerChoiceStrategies
.LEAST_BUSY
:
173 return new (LeastBusyWorkerChoiceStrategy
.bind(context
))(pool
, opts
)
174 case WorkerChoiceStrategies
.LEAST_ELU
:
175 return new (LeastEluWorkerChoiceStrategy
.bind(context
))(pool
, opts
)
176 case WorkerChoiceStrategies
.LEAST_USED
:
177 return new (LeastUsedWorkerChoiceStrategy
.bind(context
))(pool
, opts
)
178 case WorkerChoiceStrategies
.ROUND_ROBIN
:
179 return new (RoundRobinWorkerChoiceStrategy
.bind(context
))(pool
, opts
)
180 case WorkerChoiceStrategies
.WEIGHTED_ROUND_ROBIN
:
181 return new (WeightedRoundRobinWorkerChoiceStrategy
.bind(context
))(
187 // eslint-disable-next-line @typescript-eslint/restrict-template-expressions
188 `Worker choice strategy '${workerChoiceStrategy}' is not valid`