refactor progress
This commit is contained in:
170
packages/worker/src/services/WorkerMetricsCollector.tsx
Normal file
170
packages/worker/src/services/WorkerMetricsCollector.tsx
Normal file
@@ -0,0 +1,170 @@
|
||||
/*
|
||||
* Copyright (C) 2026 Fluxer Contributors
|
||||
*
|
||||
* This file is part of Fluxer.
|
||||
*
|
||||
* Fluxer is free software: you can redistribute it and/or modify
|
||||
* it under the terms of the GNU Affero General Public License as published by
|
||||
* the Free Software Foundation, either version 3 of the License, or
|
||||
* (at your option) any later version.
|
||||
*
|
||||
* Fluxer is distributed in the hope that it will be useful,
|
||||
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
||||
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
||||
* GNU Affero General Public License for more details.
|
||||
*
|
||||
* You should have received a copy of the GNU Affero General Public License
|
||||
* along with Fluxer. If not, see <https://www.gnu.org/licenses/>.
|
||||
*/
|
||||
|
||||
import type {LoggerInterface} from '@fluxer/logger/src/LoggerInterface';
|
||||
import type {MetricsServiceInterface} from '@fluxer/worker/src/contracts/WorkerTypes';
|
||||
import {ms} from 'itty-time';
|
||||
|
||||
export interface QueueWithSize {
|
||||
getQueueSize(): Promise<number>;
|
||||
}
|
||||
|
||||
export interface KVClientInterface {
|
||||
health(): Promise<boolean>;
|
||||
}
|
||||
|
||||
export interface WorkerMetricsCollectorOptions {
|
||||
kvClient: KVClientInterface;
|
||||
metricsService: MetricsServiceInterface;
|
||||
logger: LoggerInterface;
|
||||
queues?: {
|
||||
assetDeletion?: QueueWithSize;
|
||||
cloudflarePurge?: QueueWithSize;
|
||||
bulkMessageDeletion?: QueueWithSize;
|
||||
accountDeletion?: QueueWithSize;
|
||||
};
|
||||
reportIntervalMs?: number;
|
||||
}
|
||||
|
||||
export class WorkerMetricsCollector {
|
||||
private readonly kvClient: KVClientInterface;
|
||||
private readonly metricsService: MetricsServiceInterface;
|
||||
private readonly logger: LoggerInterface;
|
||||
private readonly queues: {
|
||||
assetDeletion?: QueueWithSize;
|
||||
cloudflarePurge?: QueueWithSize;
|
||||
bulkMessageDeletion?: QueueWithSize;
|
||||
accountDeletion?: QueueWithSize;
|
||||
};
|
||||
private readonly reportIntervalMs: number;
|
||||
private intervalHandle: ReturnType<typeof setInterval> | null = null;
|
||||
private kvErrorCount = 0;
|
||||
|
||||
constructor(options: WorkerMetricsCollectorOptions) {
|
||||
this.kvClient = options.kvClient;
|
||||
this.metricsService = options.metricsService;
|
||||
this.logger = options.logger;
|
||||
this.queues = options.queues ?? {};
|
||||
this.reportIntervalMs = options.reportIntervalMs ?? ms('30 seconds');
|
||||
}
|
||||
|
||||
start(): void {
|
||||
if (this.intervalHandle) return;
|
||||
|
||||
this.logger.info({intervalMs: this.reportIntervalMs}, 'Starting WorkerMetricsCollector');
|
||||
|
||||
this.collectAndReport().catch((err) => {
|
||||
this.logger.error({err}, 'Initial metrics collection failed');
|
||||
});
|
||||
|
||||
this.intervalHandle = setInterval(() => {
|
||||
this.collectAndReport().catch((err) => {
|
||||
this.logger.error({err}, 'Metrics collection failed');
|
||||
});
|
||||
}, this.reportIntervalMs);
|
||||
}
|
||||
|
||||
stop(): void {
|
||||
if (this.intervalHandle) {
|
||||
clearInterval(this.intervalHandle);
|
||||
this.intervalHandle = null;
|
||||
this.logger.info({}, 'Stopped WorkerMetricsCollector');
|
||||
}
|
||||
}
|
||||
|
||||
private async collectAndReport(): Promise<void> {
|
||||
const [kvQueueSizes, kvConnectionStatus] = await Promise.all([
|
||||
this.collectKVQueueSizes(),
|
||||
this.collectKVConnectionStatus(),
|
||||
]);
|
||||
|
||||
this.reportKVQueueSizes(kvQueueSizes);
|
||||
this.reportKVHealthMetrics(kvConnectionStatus);
|
||||
}
|
||||
|
||||
private async collectKVQueueSizes(): Promise<{
|
||||
assetDeletion: number;
|
||||
cloudflarePurge: number;
|
||||
bulkMessageDeletion: number;
|
||||
accountDeletion: number;
|
||||
}> {
|
||||
try {
|
||||
const [assetDeletion, cloudflarePurge, bulkMessageDeletion, accountDeletion] = await Promise.all([
|
||||
this.queues.assetDeletion?.getQueueSize() ?? Promise.resolve(0),
|
||||
this.queues.cloudflarePurge?.getQueueSize() ?? Promise.resolve(0),
|
||||
this.queues.bulkMessageDeletion?.getQueueSize() ?? Promise.resolve(0),
|
||||
this.queues.accountDeletion?.getQueueSize() ?? Promise.resolve(0),
|
||||
]);
|
||||
return {assetDeletion, cloudflarePurge, bulkMessageDeletion, accountDeletion};
|
||||
} catch (err) {
|
||||
this.kvErrorCount++;
|
||||
this.logger.error({err}, 'Failed to collect KV queue sizes');
|
||||
return {assetDeletion: 0, cloudflarePurge: 0, bulkMessageDeletion: 0, accountDeletion: 0};
|
||||
}
|
||||
}
|
||||
|
||||
private reportKVQueueSizes(sizes: {
|
||||
assetDeletion: number;
|
||||
cloudflarePurge: number;
|
||||
bulkMessageDeletion: number;
|
||||
accountDeletion: number;
|
||||
}): void {
|
||||
this.metricsService.gauge({
|
||||
name: 'worker.kv_queue.asset_deletion',
|
||||
value: sizes.assetDeletion,
|
||||
});
|
||||
this.metricsService.gauge({
|
||||
name: 'worker.kv_queue.cloudflare_purge',
|
||||
value: sizes.cloudflarePurge,
|
||||
});
|
||||
this.metricsService.gauge({
|
||||
name: 'worker.kv_queue.bulk_message_deletion',
|
||||
value: sizes.bulkMessageDeletion,
|
||||
});
|
||||
this.metricsService.gauge({
|
||||
name: 'worker.kv_queue.account_deletion',
|
||||
value: sizes.accountDeletion,
|
||||
});
|
||||
}
|
||||
|
||||
private async collectKVConnectionStatus(): Promise<boolean> {
|
||||
try {
|
||||
return await this.kvClient.health();
|
||||
} catch (err) {
|
||||
this.kvErrorCount++;
|
||||
this.logger.error({err}, 'KV health check failed');
|
||||
return false;
|
||||
}
|
||||
}
|
||||
|
||||
private reportKVHealthMetrics(isConnected: boolean): void {
|
||||
this.metricsService.gauge({
|
||||
name: 'kv.connection.status',
|
||||
value: isConnected ? 1 : 0,
|
||||
});
|
||||
|
||||
if (this.kvErrorCount > 0) {
|
||||
this.metricsService.counter({
|
||||
name: 'kv.command.error',
|
||||
value: this.kvErrorCount,
|
||||
});
|
||||
this.kvErrorCount = 0;
|
||||
}
|
||||
}
|
||||
}
|
||||
99
packages/worker/src/services/WorkerService.tsx
Normal file
99
packages/worker/src/services/WorkerService.tsx
Normal file
@@ -0,0 +1,99 @@
|
||||
/*
|
||||
* Copyright (C) 2026 Fluxer Contributors
|
||||
*
|
||||
* This file is part of Fluxer.
|
||||
*
|
||||
* Fluxer is free software: you can redistribute it and/or modify
|
||||
* it under the terms of the GNU Affero General Public License as published by
|
||||
* the Free Software Foundation, either version 3 of the License, or
|
||||
* (at your option) any later version.
|
||||
*
|
||||
* Fluxer is distributed in the hope that it will be useful,
|
||||
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
||||
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
||||
* GNU Affero General Public License for more details.
|
||||
*
|
||||
* You should have received a copy of the GNU Affero General Public License
|
||||
* along with Fluxer. If not, see <https://www.gnu.org/licenses/>.
|
||||
*/
|
||||
|
||||
import type {LoggerInterface} from '@fluxer/logger/src/LoggerInterface';
|
||||
import type {IWorkerService} from '@fluxer/worker/src/contracts/IWorkerService';
|
||||
import type {TracingInterface, WorkerJobOptions, WorkerJobPayload} from '@fluxer/worker/src/contracts/WorkerTypes';
|
||||
import type {IQueueProvider} from '@fluxer/worker/src/providers/IQueueProvider';
|
||||
import {createQueueProvider} from '@fluxer/worker/src/providers/QueueProviderFactory';
|
||||
|
||||
export interface WorkerServiceOptions {
|
||||
queueBaseUrl?: string | undefined;
|
||||
queueProvider?: IQueueProvider | undefined;
|
||||
logger: LoggerInterface;
|
||||
tracing?: TracingInterface | undefined;
|
||||
timeoutMs?: number | undefined;
|
||||
}
|
||||
|
||||
export class WorkerService implements IWorkerService {
|
||||
private readonly queue: IQueueProvider;
|
||||
private readonly logger: LoggerInterface;
|
||||
|
||||
constructor(options: WorkerServiceOptions) {
|
||||
this.queue = createQueueProvider({
|
||||
queueProvider: options.queueProvider,
|
||||
queueBaseUrl: options.queueBaseUrl,
|
||||
timeoutMs: options.timeoutMs,
|
||||
tracing: options.tracing,
|
||||
});
|
||||
this.logger = options.logger;
|
||||
}
|
||||
|
||||
async addJob<TPayload extends WorkerJobPayload = WorkerJobPayload>(
|
||||
taskType: string,
|
||||
payload: TPayload,
|
||||
options?: WorkerJobOptions,
|
||||
): Promise<void> {
|
||||
try {
|
||||
await this.queue.enqueue(taskType, payload, {
|
||||
runAt: options?.runAt,
|
||||
maxAttempts: options?.maxAttempts,
|
||||
priority: options?.priority,
|
||||
});
|
||||
this.logger.debug({taskType, payload}, 'Job queued successfully');
|
||||
} catch (error) {
|
||||
this.logger.error({error, taskType, payload}, 'Failed to queue job');
|
||||
throw error;
|
||||
}
|
||||
}
|
||||
|
||||
async cancelJob(jobId: string): Promise<boolean> {
|
||||
try {
|
||||
const cancelled = await this.queue.cancelJob(jobId);
|
||||
if (cancelled) {
|
||||
this.logger.info({jobId}, 'Job cancelled successfully');
|
||||
} else {
|
||||
this.logger.debug({jobId}, 'Job not found (may have already been processed)');
|
||||
}
|
||||
return cancelled;
|
||||
} catch (error) {
|
||||
this.logger.error({error, jobId}, 'Failed to cancel job');
|
||||
throw error;
|
||||
}
|
||||
}
|
||||
|
||||
async retryDeadLetterJob(jobId: string): Promise<boolean> {
|
||||
try {
|
||||
const retried = await this.queue.retryDeadLetterJob(jobId);
|
||||
if (retried) {
|
||||
this.logger.info({jobId}, 'Dead letter job retried successfully');
|
||||
} else {
|
||||
this.logger.debug({jobId}, 'Job not found in dead letter queue');
|
||||
}
|
||||
return retried;
|
||||
} catch (error) {
|
||||
this.logger.error({error, jobId}, 'Failed to retry dead letter job');
|
||||
throw error;
|
||||
}
|
||||
}
|
||||
|
||||
getQueue(): IQueueProvider {
|
||||
return this.queue;
|
||||
}
|
||||
}
|
||||
Reference in New Issue
Block a user