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

インストール

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

Maven

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

プロジェクトのトップレベルの build.gradle ファイルに、次のMavenリポジトリを追加します：
```
maven {
      url "https://maven.tealiumiq.com/android/releases/"
}
```
プロジェクトモジュールの build.gradle ファイルに、TealiumライブラリとクラッシュレポーターのMaven依存関係を追加します：
```
dependencies {
      implementation 'com.tealium:kotlin-core:1.6.0'
      implementation 'com.tealium:kotlin-crash-reporter:1.1.1'
}
```

手動

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

Tealiumのクラッシュレポーターモジュールをダウンロードします。
ファイル tealium-kotlin.crashreporter-1.1.1.aar をプロジェクトの <PROJECT_ROOT>/<MODULE>/libs ディレクトリにコピーします。
プロジェクトモジュールの 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" としてトラッキングされます。

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

データレイヤー

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

変数	タイプ	説明
`crash_cause`	String	例外のタイプ
`crash_count`	Number	インストール以降の各クラッシュに対するインクリメントカウンター
`crash_name`	String	例外メッセージ
`crash_threads`	Array of Strings	クラッシュしたスレッドのデータを含むJSON文字列の配列、スレッドIDとスタックトレースを含む
`crash_uuid`	String	各クラッシュイベントに対する16文字の一意のID

例：

{
  "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"
}