Skip to content

feat(android): Add raw tombstone attachment option #17888

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
romtsn merged 2 commits into from
May 27, 2026
+32 −0
Merged

feat(android): Add raw tombstone attachment option #17888

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
0129b76
docs(android): Add raw tombstone attachment option
romtsn May 26, 2026
37e3453
docs(android): Add protobuf decoder note for raw tombstone attachment
romtsn May 27, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
32 changes: 32 additions & 0 deletions docs/platforms/android/configuration/tombstones.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -100,6 +100,38 @@ It can also make sense if you get recurring reports of native crashes early duri

Other than that, the SDK will always pick up the latest Tombstone from the historical exit reasons list on the next app restart, and there won’t be any historical Tombstones to report. Also keep in mind that historical Tombstones will receive only minimal updates, as the available data is likely out of sync.

#### Attaching Raw Tombstone

<Alert level="info">

Available in Android SDK version `8.42.0` or above.

</Alert>

The SDK can send the raw tombstone data from [ApplicationExitInfo#getTraceInputStream](<https://developer.android.com/reference/android/app/ApplicationExitInfo#getTraceInputStream()>) as an attachment. This is useful for performing deeper investigations using all available information from the OS, in addition to the SDK parsing the tombstone into threads with stack traces.

The raw data is a binary protobuf file. To interpret it, you'll need a protobuf decoder and [Android's tombstone schema](https://android.googlesource.com/platform/system/core/+/refs/heads/main/debuggerd/proto/tombstone.proto).

To enable raw tombstone attachments:

Comment thread
romtsn marked this conversation as resolved.
```xml {filename:AndroidManifest.xml}
<application>
<meta-data android:name="io.sentry.tombstone.attach-raw" android:value="true" />
</application>
```

```kotlin
SentryAndroid.init(context) { options ->
options.isAttachRawTombstone = true
}
```

```java
SentryAndroid.init(context, options -> {
options.setAttachRawTombstone(true);
});
```

#### Interaction with other Options

Similar to ANR, for Tombstone derived events the options `attachThreads` and `attachStacktrace` are currently without effect.
Loading