getLogger( )

function getLogger(namespace: string, options?: LoggerOptions): Logger;

Parameters

Name	Type	Required?	Description
namespace	`string`	✓	Logger namespace (used for identification and filtering)
options	`LoggerOptions`	✗	Optional logger configuration. When omitted, the logger is cached by namespace. When provided, a new logger is always created.

Field	Type	Required?	Description
level	`"error" \| "warn" \| "info" \| "debug" \| "trace"`	✗	Log level
namespace	`string`	✗	Override namespace
transports	`LogTransport[]`	✗	Custom log transports
enableConsole	`boolean`	✗	Whether to output logs to console

type LogTransport = (
  level: LogLevel,
  namespace: string,
  message: string,
) => void | Promise<void>;

A callback function invoked for each log entry. LogLevel is "error" | "warn" | "info" | "debug" | "trace".

Logger — A logger instance.

Method	Signature	Description
error	`(...args: unknown[]) => void`	Log at error level
warn	`(...args: unknown[]) => void`	Log at warn level
info	`(...args: unknown[]) => void`	Log at info level
debug	`(...args: unknown[]) => void`	Log at debug level
trace	`(...args: unknown[]) => void`	Log at trace level
setLevel	`(level) => void`	Change the log level
getLevel	`() => LogLevel`	Get the current log level
addTransport	`(transport:` `LogTransport) => void`	Add a custom transport
setConsoleOutput	`(enabled: boolean) => void`	Enable or disable console output