Skip to content

Releases

1.0.0-beta.1

1.0.0-beta.1 Pre-release
Pre-release

Choose a tag to compare

@sentry-release-bot sentry-release-bot released this 09 Nov 20:56

Breaking / Important behavior changes:

  • The native backend is now the default on Linux, macOS, and Windows. (#2186)
  • macOS/Linux: shared libraries now use ABI-versioned filenames, such as libsentry.1.dylib or libsentry.so.1 for 1.x. Windows, Android, and static libraries remain unchanged. (#2103)
    • NOTE: Applications must package the real versioned library and its symlinks, including libsentry.1.dylib or libsentry.so.1, because they link to and load the ABI-versioned name.
  • Release archives now include the SDK version in the filename, such as sentry-native-1.0.0.zip. (#2105)
  • Remove deprecated APIs. Migrate to the following alternatives: (#2230)
    • sentry_new_function_transport: use sentry_transport_new and sentry_transport_set_state. The send callback now receives a mutable envelope, takes ownership of it, and must free it with sentry_envelope_free.
    • sentry_event_value_add_stacktrace: create a thread with sentry_value_new_thread, set its stack with sentry_value_set_stacktrace, and add it to the event with sentry_event_add_thread.
    • sentry_shutdown: use sentry_close.
    • sentry_sdk_name and sentry_sdk_user_agent: use sentry_options_get_sdk_name and sentry_options_get_user_agent, or SENTRY_SDK_NAME and SENTRY_SDK_USER_AGENT for build-time values.
    • sentry_options_set_http_proxy and sentry_options_set_http_proxy_n: use sentry_options_set_proxy and sentry_options_set_proxy_n.
    • sentry_value_new_user_feedback and sentry_value_new_user_feedback_n: use sentry_value_new_feedback and sentry_value_new_feedback_n. The constructor arguments are now message, contact email, name, and associated event ID, with lengths following each string in the _n variant.
    • sentry_capture_user_feedback: use sentry_capture_feedback.
    • sentry_options_add_view_hierarchy, sentry_options_add_view_hierarchy_n, sentry_options_add_view_hierarchyw, and sentry_options_add_view_hierarchyw_n: create an attachment with sentry_attachment_from_file or its _n/wide-string variants, set its type to SENTRY_ATTACHMENT_TYPE_VIEW_HIERARCHY with sentry_attachment_set_type, and add it with sentry_add_attachment. For startup configuration, use sentry_scope_add_attachment in a sentry_options_set_initial_scope callback.
    • sentry_capture_event_with_scope(event, scope): use sentry_scope_capture_event(scope, event, NULL).
    • sentry_clear_crashed_last_run: remove the call. sentry_init clears the crash marker automatically.
    • sentry_regenerate_trace: use sentry_start_new_trace.

Features:

  • Add sentry_scope_begin_read/sentry_scope_end_read and sentry_scope_begin_write/sentry_scope_end_write for consistent reads of multiple scope properties and applying multiple scope changes with a single scope flush. (#2107)
  • Add sentry_scope_acquire and sentry_scope_release to access the isolation scope. (#2160)
  • Native: Provide exception metadata, registers, and a basic crashing-thread stack to on_crash for crash identification. (#2174)
  • Native: reduce disk I/O on scope changes by sending incremental updates to the crash daemon over IPC. (#2155, #2157)
  • Add pkg-config support for shared builds. (#1411)
  • Native: install handlers for the daemon's own fatal signals and unhandled exceptions, allowing best-effort recovery actions such as dumping pending envelopes before termination. (#2220)
  • Linux: add RISC-V 64 support. (#2232)
  • Report the host OS in the OS context under Wine and Proton, instead of the Windows version that Wine emulates. On Linux, prefer the host os-release inside Steam Runtime and Flatpak containers, and report SteamOS and Bazzite as the OS name. (#2241)
  • Add sentry_scope_set_trace for per-scope traces. (#2236)
  • Add sentry_continue_trace to continue incoming traces without a transaction. (#2237)
  • Add sentry_iter_trace_propagation_headers to propagate traces without a span. (#2240)
  • Resume interrupted TUS attachment uploads from the server-provided upload offset. (#2058)
  • Compress TUS attachment uploads when SENTRY_TRANSPORT_COMPRESSION is enabled. (#2222)
  • Native: allow crash uploads up to 10 seconds by default in async crash upload mode, unless shutdown_timeout is set. (#2278)
  • Native: add Android support. (#1725)

Fixes:

  • Native/Inproc: provide debug_meta.images in events passed to on_crash. (#2184)
  • Native/Linux: reduce daemon stack usage during minidump creation to avoid stack overflows in environments with limited stack space. (#2211)
  • Native/Linux: reduce stack usage when unwinding the crashed thread. (#2212)
  • Native/Unix: Preserve existing alternate signal stacks to prevent ASan aborts when the initializing thread exits before SDK shutdown. (#2219)
  • Native/Linux: fix oversized debug_meta.images entries that overlapped other libraries when a file was mapped more than once. (#2228)
  • Fix const-correctness of sentry_options_get_*, sentry_span_iter_headers, and sentry_transaction_iter_headers. (#2277)
  • Native/Linux: back the crash context with a memfd to prevent SIGBUS during sentry_init when /dev/shm is full. (#1725)
  • Native/Unix: capture complete memory regions in SENTRY_MINIDUMP_MODE_FULL instead of truncating each region to 4 MB. (#2281)
  • Native: upload large minidumps separately if sentry_options_set_enable_large_attachments is enabled. (#2281)

0.17.6

Choose a tag to compare

@sentry-release-bot sentry-release-bot released this 04 Nov 16:30

Features:

  • Add an opt-in memory reserve that is released when a crash is handled, so crashes are still captured after running out of memory. (#2274)

Fixes:

  • Events captured while a crash is being handled, such as from the on_crash hook, are no longer dropped by sample_rate, matching the crash itself. (#2269)
  • Android: fix image addresses of libraries loaded from the APK. (#2262)
  • Android: unwind past PAC-signed return addresses on ARM64. (#2263, libunwindstack-ndk#10)
  • Reject TUS upload locations with non-HTTP schemes to prevent attachment uploads to local files. (#2276)

0.17.5

Choose a tag to compare

@sentry-release-bot sentry-release-bot released this 28 Oct 13:27

Fixes:

  • Rate limits in an X-Sentry-Rate-Limits header are no longer dropped when a limit leaves out the optional scope field. Each limit is now split at the comma before its fields are read; previously a limit such as 60:error consumed the one after it, so only the last limit in the header applied. (#2245)
  • An empty proxy (sentry_options_set_proxy(options, "")) now means a direct connection with every transport and backend. Before, the WinHTTP transport, the Windows and macOS crashpad handlers and the native backend's daemon fell back to the proxy environment variables or the system proxy settings. (#2218, crashpad#175)
  • Inproc/Android: keep the original crash when the unwinder fails to allocate memory in the crash handler. (#2239)
  • Inproc: fix a deadlock when a crash occurs during sentry_close(), such as when re-initializing the SDK. (#2252)
  • Session starts are now sent immediately, instead of with the first event or the end of the session. With require_user_consent, the initial update waits for the consent to be given. (#2242)

Thank you:

0.17.4

Choose a tag to compare

@sentry-release-bot sentry-release-bot released this 16 Oct 13:11

Features:

  • Add the attach_stacktrace option, which attaches the stack trace of the capturing thread to events that carry none, so messages group by call site instead of by message text. (#2195)
  • Let custom backends track the current session through a new session_changed_func hook, invoked when a session starts, is first sent, syncs its user or ends. (#2200)

Fixes:

  • Fix a race that could drop a failed upload during sentry_close when http_retry is enabled. (#2199)
  • Native: Retry failed daemon uploads on the next SDK start when http_retry is enabled. (#2199)
  • Native: Respect symbolize_stacktraces for crash capture and enable it by default. (#2205)
  • Native/Xbox: fix capture of fast-fail crashes via Windows Error Reporting (WER). (#2207)

Thank you:

0.17.3

Choose a tag to compare

@sentry-release-bot sentry-release-bot released this 12 Oct 19:32

Fixes:

  • The persisted installation ID is no longer required to be a UUID, so a platform integration can supply any ID that user.id accepts. (#2177)
  • The org_id parsed from a DSN host now has to be all digits, so a host like o123abc.example.com no longer produces a malformed org_id in the baggage header and in trace continuation. (#2188)
  • Parsing a timestamp with a malformed fractional-second part no longer writes a leftover debug line to stdout. (#2187)
  • Crashpad/Windows: Breadcrumb and scope IPC updates are no longer blocked by earlier disk writes keeping the handler's pipe instances busy. (#2190, crashpad#174)

Other changes:

Thank you:

0.17.2

Choose a tag to compare

@sentry-release-bot sentry-release-bot released this 06 Oct 12:59

Features:

  • Add SENTRY_SDK_VERSION_MAJOR, SENTRY_SDK_VERSION_MINOR, SENTRY_SDK_VERSION_PATCH, and SENTRY_SDK_VERSION_AT_LEAST for compile-time version checks. (#2136)
  • Let downstream platform integrations supply the installation ID. (#2150)
  • Native/Crashpad/Linux: Add max_stack_capture_size option to limit non-crashing thread stack capture size. (#2137, crashpad#172)
  • Add sentry_value_from_json, sentry_value_from_msgpack, and sentry_value_from_msgpack_stream alongside the existing JSON and MessagePack serialization APIs to provide public bidirectional APIs for serializing and deserializing sentry values as JSON and MessagePack. (#2153)

Fixes:

  • Crashpad: avoid logging expected report lock contention (crashpad#171, #2138)
  • Start telemetry pool and batcher threads on demand, avoiding unnecessary worker threads for applications that do not send logs or metrics. (#2144, #2145)
  • Discard log and metric batches when the serialization pool is full instead of blocking the batcher threads with synchronous serialization. (#2148)
  • Restore the installation ID as the default user.id when removing the global user with sentry_remove_user. (#2151)
  • Unbind a finished span from the scope even when the span is dropped. (#2158)
  • Native: fix sentry_reinstall_backend to reinstall crash handlers without restarting the backend. (#2159)
  • Validate attachment reference paths before TUS upload and cleanup to prevent path traversal and unintended file uploads or deletions. (#2165)

Thank you:

0.17.1

Choose a tag to compare

@sentry-release-bot sentry-release-bot released this 24 Sep 07:04
620f6af

Fixes:

  • Fix crash context missing from PlayStation crash reports when an on_crash callback is set. (#2133)

0.17.0

Choose a tag to compare

@sentry-release-bot sentry-release-bot released this 22 Sep 15:44

Breaking / Important behavior changes:

  • Attachment APIs now use sentry_value_t and sentry_uuid_t instead of sentry_attachment_t * handles. Most attachment APIs, function names and arguments, are otherwise unchanged. (#1974)
  • sentry_init() now consumes <db>/last_crash after caching its value, aligning crashed-last-run behavior with other Sentry SDKs. (#2023)
  • Change the hint parameter of before_send callbacks (sentry_event_function_t) from void * to sentry_hint_t *. Update callbacks registered with sentry_options_set_before_send to use the new parameter type. (#2099)
  • Add a sentry_hint_t *hint argument to on_crash callbacks. (#2112)
  • Add a sentry_hint_t *hint argument to sentry_scope_capture_event. Pass NULL if no hint is needed. (#2099)
  • Remove sentry_options_get/set_enable_logs and sentry_options_get/set_enable_metrics. (#1980)

    Structured logs and metrics have been enabled by default since 0.13, and the options were deprecated and made no-ops in 0.16.

    We recognize that this change may inconvenience applications that rely on the opt-out. Use sentry_options_set_before_send_log or sentry_options_set_before_send_metric to filter logs or metrics. We made this tradeoff deliberately because consistent behavior across SDK integrations will help most users successfully adopt these features.

Features:

  • Add sentry_attachment_from_file/bytes (and their wide-string variants) for creating attachment values that can be fully configured before they are added. (#2079)
  • Add sentry_add_attachment, sentry_scope_add_attachment, and sentry_hint_add_attachment for adding configured attachments to the global scope, a specific scope, or a hint. These functions consume and freeze the attachment value. (#2079, #1974)
  • Add sentry_start_new_trace() as a clearer name for starting a new trace. (#2095)
  • Add hint support to sentry_scope_capture_event to pass event-specific attachments. The hint is also passed to before_send and on_crash, which can modify attachments before the event is sent. (#2099, #2112)
  • Add sentry_hint_get_attachments, sentry_hint_remove_attachment, and sentry_hint_clear_attachments. (#2099)

Fixes:

  • Reduce lock contention for multi-threaded log and metric capture by allowing concurrent reads of scope data, and reusing a single options reference throughout each capture. (#2091, #2094)

Other changes:

  • Promote structured logs and metrics APIs to stable. (#2101)

Deprecations:

  • Deprecate sentry_clear_crashed_last_run() because sentry_init() now consumes the marker automatically. (#2023)
  • Deprecate sentry_regenerate_trace() in favor of sentry_start_new_trace(). (#2095)

0.16.8

Choose a tag to compare

@sentry-release-bot sentry-release-bot released this 19 Sep 05:21

Features:

  • Add sentry_options_set_initial_scope for configuring scope data before the crash backend is started, including out-of-process crash handlers. (#2087)

Fixes:

  • Respect independent rate limits for feedback, logs, metrics, and attachments instead of dropping them during error backoff. (#2109)

Thank you:

0.16.7

Choose a tag to compare

@sentry-release-bot sentry-release-bot released this 19 Sep 01:16

⚠️ this release accidentally included breaking changes from master intended for 0.17.0 ⚠️ please skip this version and use sentry-native <=0.16.6 or >=0.16.8 instead

Breaking / Important behavior changes:

  • Attachment APIs now use sentry_value_t and sentry_uuid_t instead of sentry_attachment_t * handles. Most attachment APIs, function names and arguments, are otherwise unchanged. (#1974)
  • sentry_init() now consumes <db>/last_crash after caching its value, aligning crashed-last-run behavior with other Sentry SDKs. (#2023)
  • Remove sentry_options_get/set_enable_logs and sentry_options_get/set_enable_metrics. (#1980)

    Structured logs and metrics have been enabled by default since 0.13, and the options were deprecated and made no-ops in 0.16.

    We recognize that this change may inconvenience applications that rely on the opt-out. Use sentry_options_set_before_send_log or sentry_options_set_before_send_metric to filter logs or metrics. We made this tradeoff deliberately because consistent behavior across SDK integrations will help most users successfully adopt these features.

Features:

  • Add sentry_options_set_initial_scope for configuring scope data before the crash backend is started, including out-of-process crash handlers. (#2087)
  • Add sentry_attachment_from_file/bytes (and their wide-string variants) for creating attachment values that can be fully configured before they are added. (#2079)
  • Add sentry_add_attachment, sentry_scope_add_attachment, and sentry_hint_add_attachment for adding configured attachments to the global scope, a specific scope, or a hint. These functions consume and freeze the attachment value. (#2079, #1974)
  • Add sentry_start_new_trace() as a clearer name for starting a new trace. (#2095)

Fixes:

  • Reduce lock contention for multi-threaded log and metric capture by reusing a single options reference throughout each capture. (#2094)
  • Respect independent rate limits for feedback, logs, metrics, and attachments instead of dropping them during error backoff. (#2109)

Other changes:

  • Promote structured logs and metrics APIs to stable. (#2101)

Deprecations:

  • Deprecate sentry_clear_crashed_last_run() because sentry_init() now consumes the marker automatically. (#2023)
  • Deprecate sentry_regenerate_trace() in favor of sentry_start_new_trace(). (#2095)

Thank you: