graphdb-workbench/dist/api/services/logging/logger-service.d.ts

The web application for GraphDB APIs

/**
 * LoggerService provides module-specific logging functionality with configurable log levels and multiple loggers.
 *
 * The service automatically formats log messages with timestamp, module name, and log level information.
 * It supports multiple logger implementations and respects minimum log level configuration based on environment.
 */
export declare class LoggerService {
    private readonly module;
    private readonly loggers;
    /**
     * Creates a new LoggerService instance for the specified module.
     *
     * @param module - The name of the module this logger instance belongs to
     */
    constructor(module: string);
    /**
     * Logs a debug message. Debug messages are only logged in development mode.
     *
     * @param message - The debug message to log
     * @param args - Additional arguments to include in the log output
     */
    debug(message: string, ...args: unknown[]): void;
    /**
     * Logs an error message. Error messages are always logged regardless of environment.
     *
     * @param message - The error message to log
     * @param args - Additional arguments to include in the log output
     */
    error(message: string, ...args: unknown[]): void;
    /**
     * Logs an informational message.
     *
     * @param message - The informational message to log
     * @param args - Additional arguments to include in the log output
     */
    info(message: string, ...args: unknown[]): void;
    /**
     * Logs a warning message.
     *
     * @param message - The warning message to log
     * @param args - Additional arguments to include in the log output
     */
    warn(message: string, ...args: unknown[]): void;
    /**
     * Internal method that handles the actual logging logic.
     * Forwards the log message to all configured loggers if the log level meets the minimum threshold.
     *
     * @param logLevel - The severity level of the log message
     * @param message - The message to log
     * @param args - Additional arguments to include in the log output
     * @throws {Error} When a configured logger is not found in LOGGER_DEFINITIONS
     */
    private log;
    /**
     * Formats a log message with log level, module name, timestamp, and additional arguments.
     *
     * @param logLevel - The severity level of the log message
     * @param message - The base message to format
     * @returns The formatted log message string
     */
    private getFormattedMessage;
    private loadConfiguration;
}