@crawlee/core 4.0.0-beta.8 → 4.0.0-beta.80

package/autoscaling/memory_load_signal.d.ts

@@ -0,0 +1,43 @@
+import type { Configuration } from '../configuration.js';
+import type { CrawleeLogger } from '../log.js';
+import type { LoadSignal, LoadSnapshot } from './load_signal.js';
+import type { SystemInfo } from './system_status.js';
+export interface MemorySnapshot extends LoadSnapshot {
+    usedBytes?: number;
+}
+export interface MemoryLoadSignalOptions {
+    maxUsedMemoryRatio?: number;
+    overloadedRatio?: number;
+    snapshotHistoryMillis?: number;
+    config: Configuration;
+    log?: CrawleeLogger;
+}
+/**
+ * Tracks memory usage via `SYSTEM_INFO` events and reports overload when
+ * the used-to-available memory ratio exceeds a threshold.
+ */
+export declare class MemoryLoadSignal implements LoadSignal {
+    readonly name = "memInfo";
+    readonly overloadedRatio: number;
+    private readonly store;
+    private readonly config;
+    private readonly events;
+    private readonly log;
+    private readonly maxUsedMemoryRatio;
+    private maxMemoryRatio;
+    private maxMemoryBytes;
+    private lastLoggedCriticalMemoryOverloadAt;
+    constructor(options: MemoryLoadSignalOptions);
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    getSample(sampleDurationMillis?: number): MemorySnapshot[];
+    /**
+     * Returns typed memory snapshots for backward compatibility with `Snapshotter`.
+     */
+    getMemorySnapshots(): MemorySnapshot[];
+    /** @internal */
+    _onSystemInfo(systemInfo: SystemInfo): void;
+    /** @internal */
+    _memoryOverloadWarning(systemInfo: SystemInfo, maxMemoryBytes?: number): void;
+    private _getTotalMemoryBytes;
+}

package/autoscaling/memory_load_signal.js

@@ -0,0 +1,102 @@
+import { serviceLocator } from '../service_locator.js';
+import { getMemoryInfo } from '../system-info/memory-info.js';
+import { isContainerized } from '../system-info/runtime.js';
+import { SnapshotStore } from './load_signal.js';
+const RESERVE_MEMORY_RATIO = 0.5;
+const CRITICAL_OVERLOAD_RATE_LIMIT_MILLIS = 10_000;
+/**
+ * Tracks memory usage via `SYSTEM_INFO` events and reports overload when
+ * the used-to-available memory ratio exceeds a threshold.
+ */
+export class MemoryLoadSignal {
+    name = 'memInfo';
+    overloadedRatio;
+    store;
+    config;
+    events;
+    log;
+    maxUsedMemoryRatio;
+    maxMemoryRatio;
+    maxMemoryBytes;
+    lastLoggedCriticalMemoryOverloadAt = null;
+    constructor(options) {
+        this.store = new SnapshotStore(options.snapshotHistoryMillis);
+        this.config = options.config;
+        this.events = serviceLocator.getEventManager();
+        this.log = options.log ?? serviceLocator.getLogger().child({ prefix: 'MemoryLoadSignal' });
+        this.maxUsedMemoryRatio = options.maxUsedMemoryRatio ?? 0.9;
+        this.overloadedRatio = options.overloadedRatio ?? 0.2;
+        this._onSystemInfo = this._onSystemInfo.bind(this);
+    }
+    async start() {
+        const memoryMbytes = this.config.memoryMbytes ?? 0;
+        if (memoryMbytes > 0) {
+            this.maxMemoryBytes = memoryMbytes * 1024 * 1024;
+        }
+        else {
+            this.maxMemoryRatio = this.config.availableMemoryRatio;
+            if (!this.maxMemoryRatio) {
+                throw new Error('availableMemoryRatio is not set in configuration.');
+            }
+            else {
+                this.log.debug(`Setting max memory of this run to ${this.maxMemoryRatio * 100} % of available memory. ` +
+                    'Use the CRAWLEE_MEMORY_MBYTES or CRAWLEE_AVAILABLE_MEMORY_RATIO environment variable to override it.');
+            }
+            // Fallback memory measurement in case memTotalBytes is missing from SystemInfo.
+            this.maxMemoryBytes = await this._getTotalMemoryBytes();
+        }
+        this.events.on("systemInfo" /* EventType.SYSTEM_INFO */, this._onSystemInfo);
+    }
+    async stop() {
+        this.events.off("systemInfo" /* EventType.SYSTEM_INFO */, this._onSystemInfo);
+    }
+    getSample(sampleDurationMillis) {
+        return this.store.getSample(sampleDurationMillis);
+    }
+    /**
+     * Returns typed memory snapshots for backward compatibility with `Snapshotter`.
+     */
+    getMemorySnapshots() {
+        return this.store.getAll();
+    }
+    /** @internal */
+    _onSystemInfo(systemInfo) {
+        const createdAt = systemInfo.createdAt ? new Date(systemInfo.createdAt) : new Date();
+        const { memCurrentBytes, memTotalBytes } = systemInfo;
+        let maxMemoryBytes = this.maxMemoryBytes;
+        if (this.maxMemoryRatio !== undefined && this.maxMemoryRatio > 0) {
+            maxMemoryBytes = this.maxMemoryRatio * (memTotalBytes ?? this.maxMemoryBytes);
+        }
+        const snapshot = {
+            createdAt,
+            isOverloaded: memCurrentBytes / maxMemoryBytes > this.maxUsedMemoryRatio,
+            usedBytes: memCurrentBytes,
+        };
+        this.store.push(snapshot, createdAt);
+        this._memoryOverloadWarning(systemInfo, maxMemoryBytes);
+    }
+    /** @internal */
+    _memoryOverloadWarning(systemInfo, maxMemoryBytes) {
+        const effectiveMax = maxMemoryBytes ?? this.maxMemoryBytes;
+        const { memCurrentBytes } = systemInfo;
+        const createdAt = systemInfo.createdAt ? new Date(systemInfo.createdAt) : new Date();
+        if (this.lastLoggedCriticalMemoryOverloadAt &&
+            +createdAt < +this.lastLoggedCriticalMemoryOverloadAt + CRITICAL_OVERLOAD_RATE_LIMIT_MILLIS)
+            return;
+        const maxDesiredMemoryBytes = this.maxUsedMemoryRatio * effectiveMax;
+        const reserveMemory = effectiveMax * (1 - this.maxUsedMemoryRatio) * RESERVE_MEMORY_RATIO;
+        const criticalOverloadBytes = maxDesiredMemoryBytes + reserveMemory;
+        const isCriticalOverload = memCurrentBytes > criticalOverloadBytes;
+        if (isCriticalOverload) {
+            const usedPercentage = Math.round((memCurrentBytes / effectiveMax) * 100);
+            const toMb = (bytes) => Math.round(bytes / 1024 ** 2);
+            this.log.warning('Memory is critically overloaded. ' +
+                `Using ${toMb(memCurrentBytes)} MB of ${toMb(effectiveMax)} MB (${usedPercentage}%). Consider increasing available memory.`);
+            this.lastLoggedCriticalMemoryOverloadAt = createdAt;
+        }
+    }
+    async _getTotalMemoryBytes() {
+        const containerized = this.config.containerized ?? (await isContainerized());
+        return (await getMemoryInfo({ containerized, logger: serviceLocator.getLogger() })).totalBytes;
+    }
+}

package/autoscaling/snapshotter.d.ts

@@ -1,8 +1,11 @@
-import type { StorageClient } from '@crawlee/types';
-import type { Log } from '@apify/log';
-import type { BetterIntervalID } from '@apify/utilities';
-import { Configuration } from '../configuration.js';
-import type { EventManager } from '../events/event_manager.js';
+import type { StorageBackend } from '@crawlee/types';
+import type { Configuration } from '../configuration.js';
+import type { CrawleeLogger } from '../log.js';
+import type { ClientSnapshot } from './client_load_signal.js';
+import type { CpuSnapshot } from './cpu_load_signal.js';
+import type { EventLoopSnapshot } from './event_loop_load_signal.js';
+import type { LoadSignal } from './load_signal.js';
+import type { MemorySnapshot } from './memory_load_signal.js';
 import type { SystemInfo } from './system_status.js';
 export interface SnapshotterOptions {
     /**
@@ -31,46 +34,22 @@ export interface SnapshotterOptions {
     /**
      * Defines the maximum number of new rate limit errors within
      * the given interval.
-     * @default 1
+     * @default 3
      */
     maxClientErrors?: number;
     /**
      * Sets the interval in seconds for which a history of resource snapshots
      * will be kept. Increasing this to very high numbers will affect performance.
-     * @default 60
+     * @default 30
      */
     snapshotHistorySecs?: number;
     /** @internal */
-    log?: Log;
+    log?: CrawleeLogger;
     /** @internal */
-    client?: StorageClient;
+    client?: StorageBackend;
     /** @internal */
     config?: Configuration;
 }
-interface MemorySnapshot {
-    createdAt: Date;
-    isOverloaded: boolean;
-    usedBytes?: number;
-}
-interface CpuSnapshot {
-    createdAt: Date;
-    isOverloaded: boolean;
-    usedRatio: number;
-    ticks?: {
-        idle: number;
-        total: number;
-    };
-}
-interface EventLoopSnapshot {
-    createdAt: Date;
-    isOverloaded: boolean;
-    exceededMillis: number;
-}
-interface ClientSnapshot {
-    createdAt: Date;
-    isOverloaded: boolean;
-    rateLimitErrorCount: number;
-}
 /**
  * Creates snapshots of system resources at given intervals and marks the resource
  * as either overloaded or not during the last interval. Keeps a history of the snapshots.
@@ -94,27 +73,26 @@ interface ClientSnapshot {
  *
  * Client becomes overloaded when rate limit errors (429 - Too Many Requests),
  * typically received from the request queue, exceed the set limit within the set interval.
+ *
  * @category Scaling
  */
 export declare class Snapshotter {
-    log: Log;
-    client: StorageClient;
+    log: CrawleeLogger;
+    client: StorageBackend;
     config: Configuration;
-    events: EventManager;
-    eventLoopSnapshotIntervalMillis: number;
-    clientSnapshotIntervalMillis: number;
-    snapshotHistoryMillis: number;
-    maxBlockedMillis: number;
-    maxUsedMemoryRatio: number;
-    maxClientErrors: number;
-    maxMemoryBytes: number;
-    cpuSnapshots: CpuSnapshot[];
-    eventLoopSnapshots: EventLoopSnapshot[];
-    memorySnapshots: MemorySnapshot[];
-    clientSnapshots: ClientSnapshot[];
-    eventLoopInterval: BetterIntervalID;
-    clientInterval: BetterIntervalID;
-    lastLoggedCriticalMemoryOverloadAt: Date | null;
+    private readonly memorySignal;
+    private readonly eventLoopSignal;
+    private readonly cpuSignal;
+    private readonly clientSignal;
+    /**
+     * Returns the four built-in signals as an array, so `SystemStatus` can
+     * iterate them alongside any custom `LoadSignal` instances.
+     */
+    getLoadSignals(): LoadSignal[];
+    get cpuSnapshots(): CpuSnapshot[];
+    get eventLoopSnapshots(): EventLoopSnapshot[];
+    get memorySnapshots(): MemorySnapshot[];
+    get clientSnapshots(): ClientSnapshot[];
     /**
      * @param [options] All `Snapshotter` configuration options.
      */
@@ -148,42 +126,27 @@ export declare class Snapshotter {
      */
     getClientSample(sampleDurationMillis?: number): ClientSnapshot[];
     /**
-     * Finds the latest snapshots by sampleDurationMillis in the provided array.
-     */
-    protected _getSample<T extends {
-        createdAt: Date;
-    }>(snapshots: T[], sampleDurationMillis?: number): T[];
-    /**
-     * Creates a snapshot of current memory usage
-     * using the Apify platform `systemInfo` event.
+     * @deprecated Kept for backward compatibility.
      */
     protected _snapshotMemory(systemInfo: SystemInfo): void;
     /**
-     * Checks for critical memory overload and logs it to the console.
+     * @deprecated Kept for backward compatibility.
      */
     protected _memoryOverloadWarning(systemInfo: SystemInfo): void;
     /**
-     * Creates a snapshot of current event loop delay.
+     * @deprecated Kept for backward compatibility.
      */
     protected _snapshotEventLoop(intervalCallback: () => unknown): void;
     /**
-     * Creates a snapshot of current CPU usage using the Apify platform `systemInfo` event.
+     * @deprecated Kept for backward compatibility.
      */
     protected _snapshotCpu(systemInfo: SystemInfo): void;
     /**
-     * Creates a snapshot of current API state by checking for
-     * rate limit errors. Only errors produced by a 2nd retry
-     * of the API call are considered for snapshotting since
-     * earlier errors may just be caused by a random spike in
-     * number of requests and do not necessarily signify API
-     * overloading.
+     * @deprecated Kept for backward compatibility.
      */
     protected _snapshotClient(intervalCallback: () => unknown): void;
     /**
-     * Removes snapshots that are older than the snapshotHistorySecs option
-     * from the array (destructively - in place).
+     * @deprecated Pruning is now handled by individual signals.
      */
-    protected _pruneSnapshots(snapshots: MemorySnapshot[] | CpuSnapshot[] | EventLoopSnapshot[] | ClientSnapshot[], now: Date): void;
+    protected _pruneSnapshots(_snapshots: any[], _now: Date): void;
 }
-export {};
-//# sourceMappingURL=snapshotter.d.ts.map

package/autoscaling/snapshotter.js

@@ -1,11 +1,9 @@
-import { getMemoryInfo, getMemoryInfoV2, isContainerized } from '@crawlee/utils';
 import ow from 'ow';
-import { betterClearInterval, betterSetInterval } from '@apify/utilities';
-import { Configuration } from '../configuration.js';
-import { log as defaultLog } from '../log.js';
-const RESERVE_MEMORY_RATIO = 0.5;
-const CLIENT_RATE_LIMIT_ERROR_RETRY_COUNT = 2;
-const CRITICAL_OVERLOAD_RATE_LIMIT_MILLIS = 10000;
+import { serviceLocator } from '../service_locator.js';
+import { createClientLoadSignal } from './client_load_signal.js';
+import { createCpuLoadSignal } from './cpu_load_signal.js';
+import { createEventLoopLoadSignal } from './event_loop_load_signal.js';
+import { MemoryLoadSignal } from './memory_load_signal.js';
 /**
  * Creates snapshots of system resources at given intervals and marks the resource
  * as either overloaded or not during the last interval. Keeps a history of the snapshots.
@@ -29,27 +27,37 @@ const CRITICAL_OVERLOAD_RATE_LIMIT_MILLIS = 10000;
  *
  * Client becomes overloaded when rate limit errors (429 - Too Many Requests),
  * typically received from the request queue, exceed the set limit within the set interval.
+ *
  * @category Scaling
  */
 export class Snapshotter {
     log;
     client;
     config;
-    events;
-    eventLoopSnapshotIntervalMillis;
-    clientSnapshotIntervalMillis;
-    snapshotHistoryMillis;
-    maxBlockedMillis;
-    maxUsedMemoryRatio;
-    maxClientErrors;
-    maxMemoryBytes;
-    cpuSnapshots = [];
-    eventLoopSnapshots = [];
-    memorySnapshots = [];
-    clientSnapshots = [];
-    eventLoopInterval = null;
-    clientInterval = null;
-    lastLoggedCriticalMemoryOverloadAt = null;
+    memorySignal;
+    eventLoopSignal;
+    cpuSignal;
+    clientSignal;
+    /**
+     * Returns the four built-in signals as an array, so `SystemStatus` can
+     * iterate them alongside any custom `LoadSignal` instances.
+     */
+    getLoadSignals() {
+        return [this.memorySignal, this.eventLoopSignal, this.cpuSignal, this.clientSignal];
+    }
+    // Legacy public properties kept for backward compat (tests read these directly)
+    get cpuSnapshots() {
+        return this.cpuSignal.store.getAll();
+    }
+    get eventLoopSnapshots() {
+        return this.eventLoopSignal.store.getAll();
+    }
+    get memorySnapshots() {
+        return this.memorySignal.getMemorySnapshots();
+    }
+    get clientSnapshots() {
+        return this.clientSignal.store.getAll();
+    }
     /**
      * @param [options] All `Snapshotter` configuration options.
      */
@@ -65,58 +73,50 @@ export class Snapshotter {
             client: ow.optional.object,
             config: ow.optional.object,
         }));
-        const { eventLoopSnapshotIntervalSecs = 0.5, clientSnapshotIntervalSecs = 1, snapshotHistorySecs = 30, maxBlockedMillis = 50, maxUsedMemoryRatio = 0.9, maxClientErrors = 3, log = defaultLog, config = Configuration.getGlobalConfig(), client = config.getStorageClient(), } = options;
+        const { eventLoopSnapshotIntervalSecs = 0.5, clientSnapshotIntervalSecs = 1, snapshotHistorySecs = 30, maxBlockedMillis = 50, maxUsedMemoryRatio = 0.9, maxClientErrors = 3, log = serviceLocator.getLogger(), config = serviceLocator.getConfiguration(), client = serviceLocator.getStorageBackend(), } = options;
         this.log = log.child({ prefix: 'Snapshotter' });
         this.client = client;
         this.config = config;
-        this.events = this.config.getEventManager();
-        this.eventLoopSnapshotIntervalMillis = eventLoopSnapshotIntervalSecs * 1000;
-        this.clientSnapshotIntervalMillis = clientSnapshotIntervalSecs * 1000;
-        this.snapshotHistoryMillis = snapshotHistorySecs * 1000;
-        this.maxBlockedMillis = maxBlockedMillis;
-        this.maxUsedMemoryRatio = maxUsedMemoryRatio;
-        this.maxClientErrors = maxClientErrors;
-        // We need to pre-bind those functions to be able to successfully remove listeners.
-        this._snapshotCpu = this._snapshotCpu.bind(this);
-        this._snapshotMemory = this._snapshotMemory.bind(this);
+        const snapshotHistoryMillis = snapshotHistorySecs * 1000;
+        this.memorySignal = new MemoryLoadSignal({
+            maxUsedMemoryRatio,
+            snapshotHistoryMillis,
+            config: this.config,
+            log: this.log,
+        });
+        this.eventLoopSignal = createEventLoopLoadSignal({
+            eventLoopSnapshotIntervalSecs,
+            maxBlockedMillis,
+            snapshotHistoryMillis,
+        });
+        this.cpuSignal = createCpuLoadSignal({
+            snapshotHistoryMillis,
+            config: this.config,
+        });
+        this.clientSignal = createClientLoadSignal({
+            client: this.client,
+            clientSnapshotIntervalSecs,
+            maxClientErrors,
+            snapshotHistoryMillis,
+        });
     }
     /**
      * Starts capturing snapshots at configured intervals.
      */
     async start() {
-        const memoryMbytes = this.config.get('memoryMbytes', 0);
-        if (memoryMbytes > 0) {
-            this.maxMemoryBytes = memoryMbytes * 1024 * 1024;
-        }
-        else {
-            let totalBytes;
-            if (this.config.get('systemInfoV2')) {
-                const containerized = this.config.get('containerized', await isContainerized());
-                const memInfo = await getMemoryInfoV2(containerized);
-                totalBytes = memInfo.totalBytes;
-            }
-            else {
-                const memInfo = await getMemoryInfo();
-                totalBytes = memInfo.totalBytes;
-            }
-            this.maxMemoryBytes = Math.ceil(totalBytes * this.config.get('availableMemoryRatio'));
-            this.log.debug(`Setting max memory of this run to ${Math.round(this.maxMemoryBytes / 1024 / 1024)} MB. ` +
-                'Use the CRAWLEE_MEMORY_MBYTES or CRAWLEE_AVAILABLE_MEMORY_RATIO environment variable to override it.');
-        }
-        // Start snapshotting.
-        this.eventLoopInterval = betterSetInterval(this._snapshotEventLoop.bind(this), this.eventLoopSnapshotIntervalMillis);
-        this.clientInterval = betterSetInterval(this._snapshotClient.bind(this), this.clientSnapshotIntervalMillis);
-        this.events.on("systemInfo" /* EventType.SYSTEM_INFO */, this._snapshotCpu);
-        this.events.on("systemInfo" /* EventType.SYSTEM_INFO */, this._snapshotMemory);
+        await this.memorySignal.start();
+        await this.eventLoopSignal.start();
+        await this.cpuSignal.start();
+        await this.clientSignal.start();
     }
     /**
      * Stops all resource capturing.
      */
     async stop() {
-        betterClearInterval(this.eventLoopInterval);
-        betterClearInterval(this.clientInterval);
-        this.events.off("systemInfo" /* EventType.SYSTEM_INFO */, this._snapshotCpu);
-        this.events.off("systemInfo" /* EventType.SYSTEM_INFO */, this._snapshotMemory);
+        await this.memorySignal.stop();
+        await this.eventLoopSignal.stop();
+        await this.cpuSignal.stop();
+        await this.clientSignal.stop();
         // Allow microtask queue to unwind before stop returns.
         await new Promise((resolve) => {
             setImmediate(resolve);
@@ -127,166 +127,63 @@ export class Snapshotter {
      * by the sampleDurationMillis parameter. If omitted, it returns a full snapshot history.
      */
     getMemorySample(sampleDurationMillis) {
-        return this._getSample(this.memorySnapshots, sampleDurationMillis);
+        return this.memorySignal.getSample(sampleDurationMillis);
     }
     /**
      * Returns a sample of latest event loop snapshots, with the size of the sample defined
      * by the sampleDurationMillis parameter. If omitted, it returns a full snapshot history.
      */
     getEventLoopSample(sampleDurationMillis) {
-        return this._getSample(this.eventLoopSnapshots, sampleDurationMillis);
+        return this.eventLoopSignal.getSample(sampleDurationMillis);
     }
     /**
      * Returns a sample of latest CPU snapshots, with the size of the sample defined
      * by the sampleDurationMillis parameter. If omitted, it returns a full snapshot history.
      */
     getCpuSample(sampleDurationMillis) {
-        return this._getSample(this.cpuSnapshots, sampleDurationMillis);
+        return this.cpuSignal.getSample(sampleDurationMillis);
     }
     /**
      * Returns a sample of latest Client snapshots, with the size of the sample defined
      * by the sampleDurationMillis parameter. If omitted, it returns a full snapshot history.
      */
     getClientSample(sampleDurationMillis) {
-        return this._getSample(this.clientSnapshots, sampleDurationMillis);
+        return this.clientSignal.getSample(sampleDurationMillis);
     }
     /**
-     * Finds the latest snapshots by sampleDurationMillis in the provided array.
-     */
-    _getSample(snapshots, sampleDurationMillis) {
-        if (!sampleDurationMillis)
-            return snapshots;
-        const sample = [];
-        let idx = snapshots.length;
-        if (!idx)
-            return sample;
-        const latestTime = snapshots[idx - 1].createdAt;
-        while (idx--) {
-            const snapshot = snapshots[idx];
-            if (+latestTime - +snapshot.createdAt <= sampleDurationMillis) {
-                sample.unshift(snapshot);
-            }
-            else {
-                break;
-            }
-        }
-        return sample;
-    }
-    /**
-     * Creates a snapshot of current memory usage
-     * using the Apify platform `systemInfo` event.
+     * @deprecated Kept for backward compatibility.
      */
     _snapshotMemory(systemInfo) {
-        const createdAt = systemInfo.createdAt ? new Date(systemInfo.createdAt) : new Date();
-        this._pruneSnapshots(this.memorySnapshots, createdAt);
-        const { memCurrentBytes } = systemInfo;
-        const snapshot = {
-            createdAt,
-            isOverloaded: memCurrentBytes / this.maxMemoryBytes > this.maxUsedMemoryRatio,
-            usedBytes: memCurrentBytes,
-        };
-        this.memorySnapshots.push(snapshot);
-        this._memoryOverloadWarning(systemInfo);
+        this.memorySignal._onSystemInfo(systemInfo);
     }
     /**
-     * Checks for critical memory overload and logs it to the console.
+     * @deprecated Kept for backward compatibility.
      */
     _memoryOverloadWarning(systemInfo) {
-        const { memCurrentBytes } = systemInfo;
-        const createdAt = systemInfo.createdAt ? new Date(systemInfo.createdAt) : new Date();
-        if (this.lastLoggedCriticalMemoryOverloadAt &&
-            +createdAt < +this.lastLoggedCriticalMemoryOverloadAt + CRITICAL_OVERLOAD_RATE_LIMIT_MILLIS)
-            return;
-        const maxDesiredMemoryBytes = this.maxUsedMemoryRatio * this.maxMemoryBytes;
-        const reserveMemory = this.maxMemoryBytes * (1 - this.maxUsedMemoryRatio) * RESERVE_MEMORY_RATIO;
-        const criticalOverloadBytes = maxDesiredMemoryBytes + reserveMemory;
-        const isCriticalOverload = memCurrentBytes > criticalOverloadBytes;
-        if (isCriticalOverload) {
-            const usedPercentage = Math.round((memCurrentBytes / this.maxMemoryBytes) * 100);
-            const toMb = (bytes) => Math.round(bytes / 1024 ** 2);
-            this.log.warning('Memory is critically overloaded. ' +
-                `Using ${toMb(memCurrentBytes)} MB of ${toMb(this.maxMemoryBytes)} MB (${usedPercentage}%). Consider increasing available memory.`);
-            this.lastLoggedCriticalMemoryOverloadAt = createdAt;
-        }
+        this.memorySignal._memoryOverloadWarning(systemInfo);
     }
     /**
-     * Creates a snapshot of current event loop delay.
+     * @deprecated Kept for backward compatibility.
      */
     _snapshotEventLoop(intervalCallback) {
-        const now = new Date();
-        this._pruneSnapshots(this.eventLoopSnapshots, now);
-        const snapshot = {
-            createdAt: now,
-            isOverloaded: false,
-            exceededMillis: 0,
-        };
-        const previousSnapshot = this.eventLoopSnapshots[this.eventLoopSnapshots.length - 1];
-        if (previousSnapshot) {
-            const { createdAt } = previousSnapshot;
-            const delta = now.getTime() - +createdAt - this.eventLoopSnapshotIntervalMillis;
-            if (delta > this.maxBlockedMillis)
-                snapshot.isOverloaded = true;
-            snapshot.exceededMillis = Math.max(delta - this.maxBlockedMillis, 0);
-        }
-        this.eventLoopSnapshots.push(snapshot);
-        intervalCallback();
+        this.eventLoopSignal.handle(intervalCallback);
     }
     /**
-     * Creates a snapshot of current CPU usage using the Apify platform `systemInfo` event.
+     * @deprecated Kept for backward compatibility.
      */
     _snapshotCpu(systemInfo) {
-        const { cpuCurrentUsage, isCpuOverloaded } = systemInfo;
-        const createdAt = systemInfo.createdAt ? new Date(systemInfo.createdAt) : new Date();
-        this._pruneSnapshots(this.cpuSnapshots, createdAt);
-        this.cpuSnapshots.push({
-            createdAt,
-            isOverloaded: isCpuOverloaded,
-            usedRatio: Math.ceil(cpuCurrentUsage / 100),
-        });
+        this.cpuSignal.handle(systemInfo);
     }
     /**
-     * Creates a snapshot of current API state by checking for
-     * rate limit errors. Only errors produced by a 2nd retry
-     * of the API call are considered for snapshotting since
-     * earlier errors may just be caused by a random spike in
-     * number of requests and do not necessarily signify API
-     * overloading.
+     * @deprecated Kept for backward compatibility.
      */
     _snapshotClient(intervalCallback) {
-        const now = new Date();
-        this._pruneSnapshots(this.clientSnapshots, now);
-        const allErrorCounts = this.client.stats?.rateLimitErrors ?? []; // storage client might not support this
-        const currentErrCount = allErrorCounts[CLIENT_RATE_LIMIT_ERROR_RETRY_COUNT] || 0;
-        // Handle empty snapshots array
-        const snapshot = {
-            createdAt: now,
-            isOverloaded: false,
-            rateLimitErrorCount: currentErrCount,
-        };
-        const previousSnapshot = this.clientSnapshots[this.clientSnapshots.length - 1];
-        if (previousSnapshot) {
-            const { rateLimitErrorCount } = previousSnapshot;
-            const delta = currentErrCount - rateLimitErrorCount;
-            if (delta > this.maxClientErrors)
-                snapshot.isOverloaded = true;
-        }
-        this.clientSnapshots.push(snapshot);
-        intervalCallback();
+        this.clientSignal.handle(intervalCallback);
     }
     /**
-     * Removes snapshots that are older than the snapshotHistorySecs option
-     * from the array (destructively - in place).
+     * @deprecated Pruning is now handled by individual signals.
      */
-    _pruneSnapshots(snapshots, now) {
-        let oldCount = 0;
-        for (let i = 0; i < snapshots.length; i++) {
-            const { createdAt } = snapshots[i];
-            if (now.getTime() - new Date(createdAt).getTime() > this.snapshotHistoryMillis)
-                oldCount++;
-            else
-                break;
-        }
-        snapshots.splice(0, oldCount);
+    _pruneSnapshots(_snapshots, _now) {
+        // no-op — signals prune themselves
     }
 }
-//# sourceMappingURL=snapshotter.js.map