getsentry/sentry-flutter-sdk

sentry-flutter-sdk은(는) 무엇을 하나요?

Flutter 및 Dart를 위한 완전한 Sentry SDK 설정 가이드입니다. 'Flutter에 Sentry 추가', 'sentry_flutter 설치', 'Dart에서 Sentry 설정' 또는 Flutter 애플리케이션의 오류 모니터링, 트레이싱, 프로파일링, 세션 리플레이, 로깅 구성을 요청할 때 사용하세요. Android, iOS, macOS, Linux, Windows 및 Web을 지원합니다.

주요 단계

1. 의존성 추가: sentry_flutter 패키지를 프로젝트에 추가합니다.

   flutter pub add sentry_flutter
   

   또는 Dart 전용 프로젝트인 경우:

   dart pub add sentry_dart
   

2. Sentry 초기화: main 함수에서 앱 실행 전에 Sentry를 초기화합니다.

   import 'package:flutter/widgets.dart';
   import 'package:sentry_flutter/sentry_flutter.dart';
   
   Future<void> main() async {
     WidgetsFlutterBinding.ensureInitialized();
     
     await SentryFlutter.init(
       (options) {
         options.dsn = 'https://[email protected]/0';
         options.tracesSampleRate = 1.0; // 프로덕션 환경에서는 적절히 조정하세요
       },
       // 앱 위젯을 전달합니다
       appRunner: () => runApp(const MyApp()),
     );
   }
   

3. 환경 변수 사용 (선택 사항): SENTRY_DSN 환경 변수를 설정하여 DSN을 안전하게 관리할 수 있습니다.

   export SENTRY_DSN="https://[email protected]/0"
   

   코드에서는 다음과 같이 참조합니다:

   options.dsn = 'SENTRY_DSN';
   

추가 구성 옵션

• 성능 트레이싱: options.tracesSampleRate를 설정하여 트랜잭션 샘플링 비율을 조정합니다.
• 프로파일링: options.profilesSampleRate를 설정하여 프로파일링을 활성화합니다.
• 세션 리플레이: sentry_flutter 패키지에서 기본 제공되는 세션 리플레이 기능을 사용할 수 있습니다.
• 네이티브 크래시 처리: Android 및 iOS의 네이티브 크래시를 자동으로 캡처합니다.

지원 플랫폼

• Android
• iOS
• macOS
• Linux
• Windows
• Web

참고 자료

• Sentry Flutter 문서
• sentry_flutter 패키지
• sentry_dart 패키지