flex_logger_sentry #

Send FlexLogger logs to Sentry as breadcrumbs and events for error tracking and crash analytics in Flutter apps.

Contents #

• Features
• Installation
• Setup
• Usage
• Log Level Mapping
• Configuration Options
• License

Features #

• Error tracking – Exceptions/errors in logs trigger Sentry.captureException via observer's onException/onError
• Level mapping – FlexLogLevel.toSentryLevel() extension (success → info, critical → fatal)
• Breadcrumbs – All logs that pass the filter are added as breadcrumbs; warning/error/critical also create events (issues)
• Filtering – Default MinLevelFilter(FlexLogLevel.error); override with any LogFilter
• Sentry options – Optional optionsConfiguration callback for SentryFlutterOptions

Installation #

Add this to your package's pubspec.yaml file:

dependencies:
  flex_logger: ^1.0.0
  flex_logger_sentry: ^1.0.0

Then run:

flutter pub get

Setup #

1. Get Sentry DSN #

First, create a project in Sentry and get your DSN.

2. Basic Setup #

import 'package:flex_logger/flex_logger.dart';
import 'package:flex_logger_sentry/flex_logger_sentry.dart';

void main() async {
  FlexLogger.instance.configure(
    providers: [
      SentryLoggerProvider(
        dsn: 'YOUR_SENTRY_DSN_HERE',
        filter: const MinLevelFilter(FlexLogLevel.warning),
        optionsConfiguration: (options) {
          options.environment = 'production';
          options.release = '1.0.0';
        },
      ),
    ],
  );
  await FlexLogger.instance.initialize();

  runApp(MyApp());
}

3. Using Different Filters #

// Type-based filtering - only specific log types
SentryLoggerProvider(
  dsn: 'YOUR_SENTRY_DSN_HERE',
  filter: CompositeLogFilter.or([TypeFilter<ErrorLog>(), TypeFilter<CriticalLog>()]),
)

// Composite filtering - combine multiple conditions
SentryLoggerProvider(
  dsn: 'YOUR_SENTRY_DSN_HERE',
  filter: CompositeLogFilter.and([
    MinLevelFilter(FlexLogLevel.warning),
    DevelopmentOnlyFilter(), // Only in development
  ]),
)

Usage #

Once configured, logs that pass the provider's filter are sent to Sentry (breadcrumbs and/or events). Use FlexLogger as usual:

import 'package:flex_logger/flex_logger.dart';

void doSomething() {
  try {
    FlexLogger.instance.info('Operation completed successfully');
  } catch (error, stackTrace) {
    FlexLogger.instance.error('Operation failed', error, stackTrace);
  }
}

Exceptions and errors in logs are captured by the Sentry observer via onException / onError and sent with Sentry.captureException.

Log Level Mapping #

All logs that pass the filter are added as breadcrumbs. warning, error, and critical additionally create events (issues) in Sentry. Logs with exceptions use captureException instead of captureMessage.

Configuration Options #

SentryLoggerProvider Parameters #

Available Filters #

For all available Sentry options see SentryFlutterOptions.

License #

This project is licensed under the MIT License - see the LICENSE file for details.