From c16c01bd5936173ec3c8465e3791cf50d5a78318 Mon Sep 17 00:00:00 2001 From: Philipp Hofmann Date: Thu, 16 Oct 2025 11:33:03 +0200 Subject: [PATCH 1/3] feat(apple): Add FAQ for watchdog terminations Add a FAQ section at the bottom of watchdog terminations. --- .../common/configuration/watchdog-terminations.mdx | 14 ++++++++++++++ 1 file changed, 14 insertions(+) diff --git a/docs/platforms/apple/common/configuration/watchdog-terminations.mdx b/docs/platforms/apple/common/configuration/watchdog-terminations.mdx index 170391918ef2f7..636e7e2feab3bd 100644 --- a/docs/platforms/apple/common/configuration/watchdog-terminations.mdx +++ b/docs/platforms/apple/common/configuration/watchdog-terminations.mdx @@ -60,3 +60,17 @@ SentrySDK.start { options in ``` If you disable the `enableCrashHandler` option, the SDK will disable watchdog termination tracking. This will prevent false positive watchdog termination reporting for every crash. + +#### FAQ + +**Do watchdog terminations include terminations due to high memory pressure?** + +Yes, if the watchdog terminates your app because of too high memory pressure, the Apple SDK can't detect this as an app crash but reports a watchdog termination event instead, the next time your application launches. + +**Do watchdog terminations include force terminations from the user?** + +No, watchdog terminations don't include force terminations from the user, because when the user force kills your app, your app goes through the normal termination process, via the [applicationWillTerminate](https://developer.apple.com/documentation/uikit/uiapplicationdelegate/applicationwillterminate(_:)) delegate method that the Apple SDK also subscribes to. If the user force kills your app while it's hanging, the SDK will report this as a fatal app hang if you have enabled App Hangs V2. + +**Do watchdog terminations include fatal app hangs?** + +No, watchdog terminations don't include fatal app hangs. From 0c0fbe912cd715262f02f1309c7763fbf6b4a1ad Mon Sep 17 00:00:00 2001 From: Philipp Hofmann Date: Tue, 21 Oct 2025 13:59:23 +0200 Subject: [PATCH 2/3] Update docs/platforms/apple/common/configuration/watchdog-terminations.mdx Co-authored-by: Alex Krawiec --- .../apple/common/configuration/watchdog-terminations.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/platforms/apple/common/configuration/watchdog-terminations.mdx b/docs/platforms/apple/common/configuration/watchdog-terminations.mdx index 636e7e2feab3bd..e537247e3206dc 100644 --- a/docs/platforms/apple/common/configuration/watchdog-terminations.mdx +++ b/docs/platforms/apple/common/configuration/watchdog-terminations.mdx @@ -63,7 +63,7 @@ If you disable the `enableCrashHandler` option, the SDK will disable watchdog te #### FAQ -**Do watchdog terminations include terminations due to high memory pressure?** +**Do watchdog terminations include those due to high memory pressure?** Yes, if the watchdog terminates your app because of too high memory pressure, the Apple SDK can't detect this as an app crash but reports a watchdog termination event instead, the next time your application launches. From ec10ef010d607183c250b747f339821fa3efdb81 Mon Sep 17 00:00:00 2001 From: Philipp Hofmann Date: Tue, 21 Oct 2025 13:59:38 +0200 Subject: [PATCH 3/3] Update docs/platforms/apple/common/configuration/watchdog-terminations.mdx Co-authored-by: Alex Krawiec --- .../apple/common/configuration/watchdog-terminations.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/platforms/apple/common/configuration/watchdog-terminations.mdx b/docs/platforms/apple/common/configuration/watchdog-terminations.mdx index e537247e3206dc..7e236c5f528914 100644 --- a/docs/platforms/apple/common/configuration/watchdog-terminations.mdx +++ b/docs/platforms/apple/common/configuration/watchdog-terminations.mdx @@ -65,7 +65,7 @@ If you disable the `enableCrashHandler` option, the SDK will disable watchdog te **Do watchdog terminations include those due to high memory pressure?** -Yes, if the watchdog terminates your app because of too high memory pressure, the Apple SDK can't detect this as an app crash but reports a watchdog termination event instead, the next time your application launches. +Yes. If the watchdog ends your app due to excessive memory usage, the Apple SDK won’t register it as a crash. Instead, it reports a watchdog termination event the next time your app launches. **Do watchdog terminations include force terminations from the user?**