/* * 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 . */ import {getDefaultTelemetryConfig} from '@fluxer/telemetry/src/telemetry_runtime/TelemetryConfig'; import { createDefaultTelemetryLogger, type ITelemetryInitLogger, } from '@fluxer/telemetry/src/telemetry_runtime/TelemetryLogger'; import { createTelemetryRuntimeManager, type ITelemetryRuntimeManager, } from '@fluxer/telemetry/src/telemetry_runtime/TelemetryManager'; export interface InstrumentationConfig { cassandra?: boolean; aws?: boolean; fetch?: boolean; } export interface TelemetryConfig { enabled: boolean; serviceName: string; serviceVersion: string; serviceInstanceId: string; environment: string; traceSamplingRatio: number; otlpEndpoint: string; otlpApiKey?: string; exportTimeout: number; metricExportIntervalMs: number; ignoreIncomingPaths: Array; instrumentations?: InstrumentationConfig; } export interface OtlpConfig { endpoints: { traces: string; metrics: string; logs: string; }; headers?: Record; } export interface TelemetryInitLogger { info(msg: string): void; info(obj: Record, msg: string): void; } export interface ITelemetryManager { initialize(config?: Partial): Promise; shutdown(): Promise; isActive(): boolean; shouldInitialize(): boolean; getConfig(): TelemetryConfig | null; getOtlpConfig(): OtlpConfig | null; } export interface TelemetryManagerOptions { logger?: TelemetryInitLogger; shouldInitialize?: () => boolean; } function createRuntimeManager(options?: TelemetryManagerOptions): ITelemetryRuntimeManager { const logger: ITelemetryInitLogger = options?.logger ?? createDefaultTelemetryLogger(); return createTelemetryRuntimeManager({ logger, shouldInitialize: options?.shouldInitialize ?? (() => true), }); } function createManagerFacade(runtimeManager: ITelemetryRuntimeManager): ITelemetryManager { return { initialize(config?: Partial): Promise { return runtimeManager.initialize(config); }, shutdown(): Promise { return runtimeManager.shutdown(); }, isActive(): boolean { return runtimeManager.isActive(); }, shouldInitialize(): boolean { return runtimeManager.shouldInitialize(); }, getConfig(): TelemetryConfig | null { return runtimeManager.getConfig(); }, getOtlpConfig(): OtlpConfig | null { return runtimeManager.getOtlpConfig(); }, }; } export function createTelemetryManager(options?: TelemetryManagerOptions): ITelemetryManager { return createManagerFacade(createRuntimeManager(options)); } const defaultTelemetryManager = createTelemetryManager(); export function isTelemetryActive(): boolean { return defaultTelemetryManager.isActive(); } export function getDefaultConfig(): TelemetryConfig { return getDefaultTelemetryConfig(); } export function shouldInitializeTelemetry(): boolean { return defaultTelemetryManager.shouldInitialize(); } export async function initializeTelemetry(config?: Partial): Promise { await defaultTelemetryManager.initialize(config); } export async function shutdownTelemetry(): Promise { await defaultTelemetryManager.shutdown(); } export function getTelemetryConfig(): TelemetryConfig | null { return defaultTelemetryManager.getConfig(); } export function getOtlpConfig(): OtlpConfig | null { return defaultTelemetryManager.getOtlpConfig(); }