Skip to content

Commit b5f07b1

Browse files
feat(native): add Crashpad retry mechanism (#12980)
* add crashpad retry mechanism to list of reasons * update
1 parent 105fdee commit b5f07b1

File tree

1 file changed

+3
-2
lines changed
  • docs/platforms/native/advanced-usage/backend-tradeoffs

1 file changed

+3
-2
lines changed

docs/platforms/native/advanced-usage/backend-tradeoffs/index.mdx

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -18,6 +18,7 @@ Currently, `crashpad` is the default on all desktop platforms because it
1818
* is the primary target for Sentry-developed extensions to the upstream implementation of backend handlers (most of which aren't a particular upside vs. the other backends, but changes to reach parity), including
1919
* client-side stack traces (this is currently not available on `breakpad`)
2020
* attachment handling
21+
* retry mechanism for failed report uploads
2122
* HTTP proxy support
2223
* GCC and MinGW support
2324
* `FirstChanceHandler` on Windows and extension of its synchronization to support Sentry hooks
@@ -39,7 +40,7 @@ In the above cases, if you cannot loosen the requirements of your environment, y
3940

4041
### How do I decide between `breakpad` or `inproc`?
4142

42-
Both backends are comparable in how they differ from `crashpad`. However, there are also considerable differences between the two:
43+
Both backends are comparable in how they differ from `crashpad`. However, there are also considerable differences between the two:
4344

4445
* `inproc` only provides the backtrace of the crashing thread. `breakpad` records all threads in the minidump.
4546
* similar to `crashpad`, `breakpad` uses the lowest level error handling mechanism on each platform (macOS: mach exception ports, Windows: `UnhandledExceptionFilter`, Linux: signal handlers), it does cover a smaller range of errors, though as mentioned above.
@@ -63,7 +64,7 @@ Both backends are comparable in how they differ from `crashpad`. However, there
6364

6465
If you dive into the details, you will find many trade-offs in the selection of backends. The above merely provides a first overview. Further, the above is only a snapshot of the current capabilities, where some trade-offs are incidental and do not follow a particular strategy or technological necessity. The primary reason for providing multiple backends is to cover as many user scenarios as possible, which requires a bit of insight if you decide to deviate from the defaults.
6566

66-
Sentry suggests the following sequence for your backend evaluations:
67+
Sentry suggests the following sequence for your backend evaluations:
6768

6869
* `crashpad` (default)
6970
* `breakpad`

0 commit comments

Comments
 (0)