Features:

• Add custom attributes API for logs. When logs_with_attributes is set to true, treats the first varg passed into sentry_logs_X(message,...) as a sentry_value_t object of attributes. (#1435)
• Add runtime API to query user consent requirement. (#1443)
• Add logs flush on sentry_flush(). (#1434)
• Add global attributes API. These are added to all sentry_log_X calls. (#1450)

Fixes:

• PS5/Switch compilation regression (sentry__process_spawn signature change) (#1436)

Breaking changes:

• If you use a narrow string path interface (for instance, sentry_options_set_database_path()) on Windows rather than one of the wide string variants (sentry_options_set_database_pathw()), then the expected encoding is now UTF-8. (#1413)

Features:

• Add an option to use the stack pointer as an upper limit for the stack capture range in crashpad on Windows. This is useful for targets like Proton/Wine, where one can't rely on the TEB-derived upper bound being correctly maintained by the system, leading to overly large stack captures per thread. (#1427, crashpad#137)

Fixes:

• Add logs flush on crash. This is not available for macOS with the crashpad backend. (#1404)
• Make narrow UTF-8 the canonical path encoding on Windows. (#1413)
• Re-add setting thread name for Windows transport. (#1424)
• Fix AOT interop with managed .NET runtimes. (#1392)

Internal:

• Add SENTRY_SDK_VERSION CMake cache variable to allow downstream SDKs to override the SDK version at configuration time. (#1417)
• Updated crashpad to 2025-10-22. (#1426, crashpad#136, mini_chromium#4).
• CI: bump Python to 3.12. (#1413)
• Remove any MAX_PATH dependencies in crashpad and breakpad. (#1413, breakpad#43, crashpad#135)

Features:

• Add support for outgoing W3C traceparent header propagation with the propagate_traceparent option. (#1394)
• Add sentry_options_set_external_crash_reporter_path to allow specifying an external crash reporter. (#1303)

Fixes:

• Use proper SDK name determination for structured logs sdk.name attribute. (#1399)
• Serialize uint64 values as numerical instead of string. (#1408)

Fixes:

• Windows: Make symbolication and the modulefinder independent of the system ANSI code page. (#1389)

Features:

• Add support for structured logs. It is currently experimental, and one can enable it by setting sentry_options_set_enable_logs. When enabled, you can capture a log using sentry_log_info() (or another log level). Logs can be filtered by setting the before_send_log hook. (#1271)

Breaking changes:

• Add user_data parameter to traces_sampler. (#1346)

Fixes:

• Include stddef.h explicitly in crashpad since future libc++ revisions will stop providing this include transitively. (#1375, crashpad#132)
• Fall back on JWASM in the MinGW crashpad build only if no CMAKE_ASM_MASM_COMPILER has been defined. (#1375, crashpad#133)
• Prevent crashpad from leaking Objective-C ARC compile options into any parent target linkage. (#1375, crashpad#134)
• Fixed a TOCTOU race between session init/shutdown and event capture. (#1377)
• Make the Windows resource generation aware of config-specific output paths for multi-config generators. (#1383)
• Remove the ASM language from the top-level CMake project, as this triggered CMake policy CMP194 which isn't applicable to the top-level. (#1384)

Features:

• Add a configuration to disable logging after a crash has been detected - sentry_options_set_logger_enabled_when_crashed(). (#1371)

Internal:

• Support downstream Xbox SDK specifying networking initialization mechanism. (#1359)
• Added crashpad support infrastructure for the external crash reporter feature. (#1375, crashpad#131)

Docs:

• Document the CMake 4 requirement on macOS SDKROOT due to its empty default for CMAKE_OSX_SYSROOT in the README. (#1368)

Thank you:

• JanFellner

Internal:

• Correctly apply dynamic mutex initialization in unit-tests (fixes running unit-tests in downstream console SDKs) (#1337)

Breaking changes:

• By using transactions as automatic trace boundaries, transactions will, by default, no longer be part of the same singular trace. This is not the case when setting trace boundaries explicitly (sentry_regenerate_trace() or sentry_set_trace()), which turns off the automatic management of trace boundaries. (#1270)
• Change transaction sampling to be trace-based. This does not affect you when transactions are used for automatic trace boundaries (as described above), since every transaction is part of a new trace. However, if you manage trace boundaries manually (using sentry_regenerate_trace()) or run the Native SDK inside a downstream SDK like the Unity SDK, where these SDKs will manage the trace boundaries, for a given traces_sample_rate, either all transactions in a trace get sampled or none do with probability equal to that sample rate. (#1254)
• Moved Xbox toolchains to an Xbox-specific repository sentry-xbox. You can request access to the repository by following the instructions in Xbox documentation. (#1329)

Features:

• Add sentry_clear_attachments() to allow clearing all previously added attachments in the global scope. (#1290)
• Automatically set trace boundaries with every transaction. (#1270)
• Provide sentry_regenerate_trace() to allow users to set manual trace boundaries. (#1293)
• Add Dynamic Sampling Context (DSC) to events. (#1254)
• Add sentry_value_new_feedback and sentry_capture_feedback to allow capturing User Feedback. (#1304)
  • Deprecate sentry_value_new_user_feedback and sentry_capture_user_feedback in favor of the new API.
• Add sentry_envelope_read_from_file, sentry_envelope_get_header, and sentry_capture_envelope. (#1320)
• Add (u)int64 sentry_value_t type. (#1326)

Meta:

• Marked deprecated functions with SENTRY_DEPRECATED(msg). (#1308)

Internal:

• Crash events from Crashpad now have event_id defined similarly to other backends. This makes it possible to associate feedback at the time of crash. (#1319)

Features:

• The sentry_attach_file/bytes, sentry_scope_attach_file/bytes (and their wide-string variants), and sentry_remove_attachment have been added to modify the list of attachments that are sent along with sentry events after a call to sentry_init. (#1266, #1275)
  • NOTE: When using the crashpad backend on macOS, the list of attachments that will be added at the time of a hard crash will be frozen at the time of sentry_init, and later modifications will not be reflected.
• Add sentry_attachment_set_content_type to allow specifying the content type of attachments. (#1276)
• Add sentry_attachment_set_filename to allow specifying the filename of attachments displayed in the Sentry WebUI. (#1285)

Meta:

• Identify Xbox as a separate SDK name sentry.native.xbox. (#1287)

Internal:

• Updated breakpad to 2025-06-13. (#1277, breakpad#41)