Skip to content

docs(godot): Document Android ANR detection options #18294

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

Draft
limbonaut wants to merge 3 commits into
base: master
Choose a base branch
from
+31 −1
Draft

docs(godot): Document Android ANR detection options #18294

Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
5898db8
docs(godot): Document Android ANR detection options
limbonaut Jun 8, 2026
df70796
Merge branch 'master' into docs/godot-android-anr-detection-options
limbonaut Jun 8, 2026
d66d6ab
Move section further
limbonaut Jun 8, 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: 31 additions & 1 deletion docs/platforms/godot/configuration/options.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -134,7 +134,7 @@ If `true`, enables automatic detection and reporting of application hangs. The S

<Alert title="Note">

This feature is only supported on Android, iOS, and macOS platforms.
This feature applies to iOS and macOS only. On Android, ANR (Application Not Responding) detection is configured separately — see [`android.enable_anr_detection`](#android.enable_anr_detection).

</Alert>

Expand Down Expand Up @@ -267,6 +267,36 @@ This option contains multiple properties that govern the behavior of throttling.

</SdkOption>

## Android Options

These options configure Android-specific behavior, such as ANR (Application Not Responding) detection. Set them programmatically through `options.android`, or in the **Project Settings** under **Sentry > Android > Application Not Responding**.

<SdkOption name="android.enable_anr_detection" type="bool" defaultValue="true">

If `true`, detects and reports ANR (Application Not Responding) errors. The SDK monitors the main thread for unresponsiveness and reports an event when an ANR occurs.

Android 11 and later use the system-based V2 implementation, while earlier versions use the watchdog-based V1 implementation. See `android.anr_timeout_interval_ms` and `android.attach_anr_thread_dump` for the options specific to each implementation. On Apple platforms, `app_hang_tracking` configures the equivalent app hang detection.

To learn more, see the [Application Not Responding documentation](/platforms/android/configuration/app-not-respond/).

</SdkOption>

<SdkOption name="android.anr_timeout_interval_ms" type="int" defaultValue="5000">

Specifies how long, in milliseconds, the main thread must stay blocked before the SDK reports an ANR.

Applies only when `android.enable_anr_detection` is enabled, and only to the V1 implementation used on Android versions before 11. On Android 11 and later, the operating system determines when the application stops responding, so this value has no effect.

</SdkOption>

<SdkOption name="android.attach_anr_thread_dump" type="bool" defaultValue="false">

If `true`, attaches the operating system's thread dump to the ANR event as a plain-text attachment, adding detail for investigating where the application became unresponsive.

Applies only when `android.enable_anr_detection` is enabled, and only to the V2 implementation used on Android 11 and later.

</SdkOption>

## Hooks

These options can be used to hook the SDK in various ways to customize the reporting of events.
Expand Down
Loading