X-Git-Url: https://git.piment-noir.org/?a=blobdiff_plain;f=src%2Fpools%2Fworker.ts;h=ba9393ab9ba8241e5f1a1184165d42055b859835;hb=f0bbd436ca3a985f79cf530ba82805d8d617d509;hp=adec0138d86e940686f1d60026616c0ce9c2c922;hpb=7d6b5ad23febf5c7830f98a10fb75fb29853bcdb;p=poolifier.git diff --git a/src/pools/worker.ts b/src/pools/worker.ts index adec0138..ba9393ab 100644 --- a/src/pools/worker.ts +++ b/src/pools/worker.ts @@ -1,4 +1,6 @@ +import type { EventLoopUtilization } from 'node:perf_hooks' import type { CircularArray } from '../circular-array' +import type { Queue } from '../queue' /** * Callback invoked if the worker has received a message. @@ -36,50 +38,94 @@ export type ExitHandler = ( * @internal */ export interface Task { + /** + * Task name. + */ + readonly name?: string /** * Task input data that will be passed to the worker. */ readonly data?: Data /** - * UUID of the message. + * Timestamp. + */ + readonly timestamp?: number + /** + * Message UUID. */ readonly id?: string } /** - * Worker tasks usage statistics. + * Measurement statistics. + * + * @internal + */ +export interface MeasurementStatistics { + /** + * Measurement aggregation. + */ + aggregation: number + /** + * Measurement average. + */ + average: number + /** + * Measurement median. + */ + median: number + /** + * Measurement history. + */ + history: CircularArray +} + +/** + * Task statistics. * * @internal */ -export interface TasksUsage { +export interface TaskStatistics { /** * Number of tasks executed. */ - run: number + executed: number + /** + * Number of tasks executing. + */ + executing: number /** - * Number of tasks running. + * Number of tasks queued. */ - running: number + queued: number /** - * Tasks runtime. + * Number of tasks failed. */ - runTime: number + failed: number +} + +/** + * Worker usage statistics. + * + * @internal + */ +export interface WorkerUsage { /** - * Tasks runtime history. + * Tasks statistics. */ - runTimeHistory: CircularArray + tasks: TaskStatistics /** - * Average tasks runtime. + * Tasks runtime statistics. */ - avgRunTime: number + runTime: MeasurementStatistics /** - * Median tasks runtime. + * Tasks wait time statistics. */ - medRunTime: number + waitTime: MeasurementStatistics /** - * Number of tasks errored. + * Event loop utilization. */ - error: number + elu: EventLoopUtilization | undefined } /** @@ -118,11 +164,11 @@ export interface WorkerNode { */ readonly worker: Worker /** - * Worker node tasks usage statistics. + * Worker node worker usage statistics. */ - tasksUsage: TasksUsage + workerUsage: WorkerUsage /** * Worker node tasks queue. */ - readonly tasksQueue: Array> + readonly tasksQueue: Queue> }