Skip to main content

mars_logging 1.0.0-dev.5 copy "mars_logging: ^1.0.0-dev.5" to clipboard
mars_logging: ^1.0.0-dev.5 copied to clipboard

An integration which records logs from the logging package into mars.

mars_logging #

pub package

An integration which records logs from the logging package into mars.

Status: Experimental #

NOTE: This package is published as a development prerelease (1.0.0-dev.5) to solicit feedback. The API surface is expected to change — potentially in breaking ways — before the stable 1.0.0 release.

Usage #

Add both mars and mars_logging as dependencies. This package does not re-export the Mars API, so import package:mars alongside it to configure the logger; attach the integration once, typically at startup:

import 'package:logging/logging.dart';
import 'package:mars/mars.dart';
import 'package:mars_logging/mars_logging.dart';

void main() {
  xlog.open(
    logsDir: '/path/to/logs',
    cacheDir: '/path/to/logs/cache',
  );
  Logger.root.onRecord.listen(xlog.onRecord);

  Logger('MyApp').info('hello');
  Logger('MyApp').severe('something failed', error, stackTrace);

  xlog.close();
}

Level mapping #

package:logging levels map to Mars log levels as:

package:logging Mars XLog
ALL / FINEST / FINER / FINE verbose
CONFIG debug
INFO info
WARNING warn
SEVERE error
SHOUT fatal

A record's loggerName becomes the xlog tag; error and stackTrace, when present, are appended to the message.

See the mars package README for XLog configuration (compression, encryption, rotation), flushing, and offline decoding. A complete runnable example is available in example/mars_logging_example.dart.

Bugs and feedback #

Please file issues in the bug tracker.

0
likes
150
points
110
downloads

Documentation

API reference

Publisher

verified publisherinvictus-dart.dev

Weekly Downloads

An integration which records logs from the logging package into mars.

Topics

#mars #logging

License

MIT (license)

Dependencies

logging, mars

More

Packages that depend on mars_logging