getsentry/sentry-android-sdk

sentry-android-sdk は何をしますか？

Android向けSentry SDKの完全なセットアップ。エラーモニタリング、トレーシング、プロファイリング、セッションリプレイ、ログ記録をAndroidアプリケーションに構成するために、「SentryをAndroidに追加」「sentry-androidをインストール」「AndroidでSentryを設定」などと指示された場合に使用します。KotlinとJavaのコードベースをサポートします。

セットアップ手順

1. 依存関係の追加

   build.gradle（モジュールレベル）に以下の依存関係を追加します：

   implementation 'io.sentry:sentry-android:7.x.x'
   

   バージョンは最新の安定版を使用してください。

2. ProGuard/R8ルールの設定（オプション）

   難読化を使用する場合、proguard-rules.pro に以下のルールを追加します：

   -keep class io.sentry.** { *; }
   

3. Sentryの初期化

   AndroidManifest.xml にメタデータを追加するか、コードで初期化します。

   方法A: AndroidManifest.xml に追加

   <meta-data
       android:name="io.sentry.dsn"
       android:value="https://[email protected]/0" />
   

   方法B: コードで初期化（Applicationクラス内）

   import io.sentry.android.core.SentryAndroid
   
   class MyApplication : Application() {
       override fun onCreate() {
           super.onCreate()
           SentryAndroid.init(this) { options ->
               options.dsn = "https://[email protected]/0"
               options.tracesSampleRate = 1.0
               options.profilesSampleRate = 1.0
               options.sessionReplay.sessionSampleRate = 0.1
               options.sessionReplay.onErrorSampleRate = 1.0
           }
       }
   }
   

   Javaの場合：

   import io.sentry.android.core.SentryAndroid;
   
   public class MyApplication extends Application {
       @Override
       public void onCreate() {
           super.onCreate();
           SentryAndroid.init(this, options -> {
               options.setDsn("https://[email protected]/0");
               options.setTracesSampleRate(1.0);
               options.setProfilesSampleRate(1.0);
               options.getSessionReplay().setSessionSampleRate(0.1);
               options.getSessionReplay().setOnErrorSampleRate(1.0);
               return Unit.INSTANCE;
           });
       }
   }
   

機能

• エラーモニタリング: 未処理の例外を自動キャプチャ
• トレーシング: パフォーマンストランザクションの計測
• プロファイリング: コード実行のパフォーマンスプロファイルを収集
• セッションリプレイ: ユーザー操作のリプレイ
• ログ記録: 構造化ログをSentryに送信

環境変数

• SENTRY_DSN – Sentry DSNを指定（推奨）
• SENTRY_ENVIRONMENT – 環境名（例: production, staging）
• SENTRY_RELEASE – リリースバージョン

注意事項

• 最新バージョンの確認には Sentry Android SDK リリースノート を参照
• DSNは環境変数またはコードに直接設定できますが、環境変数が推奨されます