Add LoggingIntegration support for SentryLog (#3050)

* Add `LoggingIntegration` support for `SenryLog`

* add cl entry

* format

* ignore override

* don’t add error/stacktrace attributes

* fix cl

* Map finer and finest to trace

* change min log level to info

* Update docs

* update ctor docs

* handle custom levels

* fix cl

* combile defined and custom value checks

* fix cl

* Update CHANGELOG.md

---------

Co-authored-by: Giancarlo Buenaflor <[email protected]>
Co-authored-by: Giancarlo Buenaflor <[email protected]>

Author: denrase

CHANGELOG.md

@@ -1,12 +1,13 @@
 # Changelog
 
-# Unreleased
+## Unreleased
 
 ### Features
 
 - Report Flutter framework feature flags ([#2991](https://github.com/getsentry/sentry-dart/pull/2991))
   - Search for feature flags that are prefixed with `flutter:*`
   - This works on Flutter builds that include [this PR](https://github.com/flutter/flutter/pull/171545)
+- Add `LoggingIntegration` support for `SentryLog` ([#3050](https://github.com/getsentry/sentry-dart/pull/3050))
 
 ### Dependencies
 

logging/lib/src/logging_integration.dart

@@ -11,24 +11,48 @@ import 'version.dart';
 class LoggingIntegration implements Integration<SentryOptions> {
   /// Creates the [LoggingIntegration].
   ///
-  /// All log events equal or higher than [minBreadcrumbLevel] are recorded as a
+  /// - All log events equal or higher than [minBreadcrumbLevel] are recorded as a
   /// [Breadcrumb].
-  /// All log events equal or higher than [minEventLevel] are recorded as a
+  /// - All log events equal or higher than [minEventLevel] are recorded as a
   /// [SentryEvent].
+  /// - All log events equal or higher than [minSentryLogLevel] are logged to
+  /// Sentry, if [SentryOptions.enableLogs] is true.
+  ///
+  /// Log levels are mapped to the following Sentry log levels methods:
+  ///
+  /// | Dart Log Level        | Sentry Log Level |
+  /// |-----------------------|------------------|
+  /// | SHOUT, SEVERE         | error            |
+  /// | WARNING               | warn             |
+  /// | INFO                  | info             |
+  /// | CONFIG, FINE, ALL     | debug            |
+  /// | FINER, FINEST         | trace            |
+  ///
+  /// Custom log levels are mapped based on their numeric values:
+  /// - >= 1000 → error
+  /// - >= 900 → warn
+  /// - >= 800 → info
+  /// - >= 700 || 500 || 0 → debug
+  /// - < 700 → trace
   LoggingIntegration({
     Level minBreadcrumbLevel = Level.INFO,
     Level minEventLevel = Level.SEVERE,
+    Level minSentryLogLevel = Level.INFO,
   })  : _minBreadcrumbLevel = minBreadcrumbLevel,
-        _minEventLevel = minEventLevel;
+        _minEventLevel = minEventLevel,
+        _minSentryLogLevel = minSentryLogLevel;
 
   final Level _minBreadcrumbLevel;
   final Level _minEventLevel;
+  final Level _minSentryLogLevel;
   late StreamSubscription<LogRecord> _subscription;
   late Hub _hub;
+  late SentryOptions _options;
 
   @override
   void call(Hub hub, SentryOptions options) {
     _hub = hub;
+    _options = options;
     _subscription = Logger.root.onRecord.listen(
       _onLog,
       onError: (Object error, StackTrace stackTrace) async {
@@ -68,5 +92,34 @@ class LoggingIntegration implements Integration<SentryOptions> {
         hint: Hint.withMap({TypeCheckHint.record: record}),
       );
     }
+
+    if (_options.enableLogs && _isLoggable(record.level, _minSentryLogLevel)) {
+      final attributes = {
+        'loggerName': SentryLogAttribute.string(record.loggerName),
+        'sequenceNumber': SentryLogAttribute.int(record.sequenceNumber),
+        'time': SentryLogAttribute.int(record.time.millisecondsSinceEpoch),
+      };
+
+      // Map log levels based on value ranges
+      final levelValue = record.level.value;
+      if (levelValue >= Level.SEVERE.value) {
+        // >= 1000 → error
+        await _options.logger.error(record.message, attributes: attributes);
+      } else if (levelValue >= Level.WARNING.value) {
+        // >= 900 → warn
+        await _options.logger.warn(record.message, attributes: attributes);
+      } else if (levelValue >= Level.INFO.value) {
+        // >= 800 → info
+        await _options.logger.info(record.message, attributes: attributes);
+      } else if (levelValue >= Level.CONFIG.value ||
+          levelValue == Level.FINE.value ||
+          levelValue == Level.ALL.value) {
+        // >= 700 || 500 || 0 → debug
+        await _options.logger.debug(record.message, attributes: attributes);
+      } else {
+        // < 700 → trace
+        await _options.logger.trace(record.message, attributes: attributes);
+      }
+    }
   }
 }