Logger class

Logger main class — collects Transport instances and fans out log events.

Create one logger per application or service boundary, add the transports you need, then use the level-specific methods to emit log events.

final logger = Logger();
logger.addTransport(ConsoleTransport());
logger.addTransport(FileTransport('/var/log/app.log'));

await logger.info('Server started on port 8080');
await logger.error('Unhandled exception', error: e, stackTrace: st);

Constructors

Logger([List<Transport>? transports])
Creates a logger, optionally pre-populating transports.

Properties

hashCode → int
The hash code for this object.
no setterinherited
runtimeType → Type
A representation of the runtime type of the object.
no setterinherited
transports → List<Transport>
The list of registered transports.
final

Methods

addTransport(Transport transport) → void
Registers transport to receive future log events.
debug(Object message, {Object? error, StackTrace? stackTrace, String? context}) → Future<void>
Emits a LogLevel.debug event. Use for detailed debugging information.
error(Object message, {Object? error, StackTrace? stackTrace, String? context}) → Future<void>
Emits a LogLevel.error event. Use for recoverable error conditions.
fatal(Object message, {Object? error, StackTrace? stackTrace, String? context}) → Future<void>
Emits a LogLevel.fatal event. Use for unrecoverable failures.
info(Object message, {Object? error, StackTrace? stackTrace, String? context}) → Future<void>
Emits a LogLevel.info event. Use for normal operational milestones.
log(LogLevel level, Object message, {Object? error, StackTrace? stackTrace, String? context}) → Future<void>
Emits a log event at level and fans it out to all registered transports.
noSuchMethod(Invocation invocation) → dynamic
Invoked when a nonexistent method or property is accessed.
inherited
toString() → String
A string representation of this object.
inherited
trace(Object message, {Object? error, StackTrace? stackTrace, String? context}) → Future<void>
Emits a LogLevel.trace event. Use for fine-grained diagnostic output.
warn(Object message, {Object? error, StackTrace? stackTrace, String? context}) → Future<void>
Emits a LogLevel.warn event. Use for potentially harmful situations.

Operators

operator ==(Object other) → bool
The equality operator.
inherited