クラッシュレポーターモジュール

インストール

Maven（推奨）または手動でクラッシュレポーターモジュールをインストールします。

Maven

Mavenを使用してモジュールをインストールするには：

1. プロジェクトのトップレベルの build.gradle ファイルに、次のMavenリポジトリを追加します：

   maven {
         url "https://maven.tealiumiq.com/android/releases/"
   }
   

2. プロジェクトモジュールの build.gradle ファイルに、TealiumライブラリとクラッシュレポーターのMaven依存関係を追加します：

   dependencies {
         implementation 'com.tealium:kotlin-core:1.5.5'
         implementation 'com.tealium:kotlin-crash-reporter:1.1.1'
   }
   

手動

クラッシュレポーターを手動でインストールするには：

1. Tealiumのクラッシュレポーターモジュールをダウンロードします。

2. ファイル tealium-kotlin.crashreporter-1.1.1.aar をプロジェクトの <PROJECT_ROOT>/<MODULE>/libs ディレクトリにコピーします。

3. プロジェクトモジュールの build.gradle ファイルにTealiumライブラリの依存関係を追加します：

   dependencies {
         implementation(name:'tealium-kotlin.crashreporter-1.1.1', ext:'aar')
   }
   

初期化

次の例に示すように、クラッシュレポーターモジュールを初期化します：

val config = TealiumConfig(application,
              "ACCOUNT",
              "PROFILE",
              ENVIRONMENT,
              modules = mutableSetOf(Modules.CrashReporter), // Crash Reporter module
              dispatchers = mutableSetOf(Dispatchers.Collect,
              Dispatchers.TagManagement,
              Dispatchers.RemoteCommands)
)

クラッシュレポーターのスタックトレースを切り捨てるには、構成オプション truncateCrashReporterStackTraces を true に構成します（デフォルトは false）。

config.truncateCrashReporterStackTraces = true

トラッキングされるイベント

初期化されると、クラッシュレポーターモジュールは自動的にクラッシュデータをキャプチャします。スレッドが突然終了すると、.uncaughtExceptionHandler()が呼び出され、クラッシュ情報がディスクに保存されます。次回の起動時に、保存されたクラッシュ情報が他のイベントと一緒にディスパッチされます。

クラッシュイベントは tealium_event="crash" としてトラッキングされます。

クラッシュレポーターはシングルトンインスタンスの呼び出しです。現在、ハンドラのチェーン化はサポートされていません。

データレイヤー

クラッシュレポーターモジュールは、イベント内で以下のクラッシュ属性を送信します：

例：

{
  "tealium_event" : "crash",
  "crash_cause"   : "java.lang.RuntimeException",
  "crash_count"   : "1",
  "crash_name"    : "Connection refused by server",
  "crash_threads" : [
    "{ \"crashed\": \"true\", \"state\": \"RUNNABLE\", \"threadNumber\": \"1\", \"threadId\": \"main\", \"priority\": \"5\", \"stack\":  [ { \"fileName\": \"MainActivity.java\", \"className\": \"com.tealium.libraryproject.MainActivity$1\", \"methodName\": \"onClick\", \"lineNumber\": \"38\" }] }"
  ],
  "crash_uuid"    : "3c91d707-949e-445f-8ad1-4d6e200bfd6f"
}