Repository navigation
Releases
1.0.0-beta.1
Breaking / Important behavior changes:
- The
nativebackend is now the default on Linux, macOS, and Windows. (#2186) - macOS/Linux: shared libraries now use ABI-versioned filenames, such as
libsentry.1.dyliborlibsentry.so.1for 1.x. Windows, Android, and static libraries remain unchanged. (#2103)- NOTE: Applications must package the real versioned library and its symlinks, including
libsentry.1.dyliborlibsentry.so.1, because they link to and load the ABI-versioned name.
- NOTE: Applications must package the real versioned library and its symlinks, including
- 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: usesentry_transport_newandsentry_transport_set_state. The send callback now receives a mutable envelope, takes ownership of it, and must free it withsentry_envelope_free.sentry_event_value_add_stacktrace: create a thread withsentry_value_new_thread, set its stack withsentry_value_set_stacktrace, and add it to the event withsentry_event_add_thread.sentry_shutdown: usesentry_close.sentry_sdk_nameandsentry_sdk_user_agent: usesentry_options_get_sdk_nameandsentry_options_get_user_agent, orSENTRY_SDK_NAMEandSENTRY_SDK_USER_AGENTfor build-time values.sentry_options_set_http_proxyandsentry_options_set_http_proxy_n: usesentry_options_set_proxyandsentry_options_set_proxy_n.sentry_value_new_user_feedbackandsentry_value_new_user_feedback_n: usesentry_value_new_feedbackandsentry_value_new_feedback_n. The constructor arguments are now message, contact email, name, and associated event ID, with lengths following each string in the_nvariant.sentry_capture_user_feedback: usesentry_capture_feedback.sentry_options_add_view_hierarchy,sentry_options_add_view_hierarchy_n,sentry_options_add_view_hierarchyw, andsentry_options_add_view_hierarchyw_n: create an attachment withsentry_attachment_from_fileor its_n/wide-string variants, set its type toSENTRY_ATTACHMENT_TYPE_VIEW_HIERARCHYwithsentry_attachment_set_type, and add it withsentry_add_attachment. For startup configuration, usesentry_scope_add_attachmentin asentry_options_set_initial_scopecallback.sentry_capture_event_with_scope(event, scope): usesentry_scope_capture_event(scope, event, NULL).sentry_clear_crashed_last_run: remove the call.sentry_initclears the crash marker automatically.sentry_regenerate_trace: usesentry_start_new_trace.
Features:
- Add
sentry_scope_begin_read/sentry_scope_end_readandsentry_scope_begin_write/sentry_scope_end_writefor consistent reads of multiple scope properties and applying multiple scope changes with a single scope flush. (#2107) - Add
sentry_scope_acquireandsentry_scope_releaseto access the isolation scope. (#2160) - Native: Provide exception metadata, registers, and a basic crashing-thread stack to
on_crashfor 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-releaseinside Steam Runtime and Flatpak containers, and report SteamOS and Bazzite as the OS name. (#2241) - Add
sentry_scope_set_tracefor per-scope traces. (#2236) - Add
sentry_continue_traceto continue incoming traces without a transaction. (#2237) - Add
sentry_iter_trace_propagation_headersto 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_COMPRESSIONis enabled. (#2222) - Native: allow crash uploads up to 10 seconds by default in async crash upload mode, unless
shutdown_timeoutis set. (#2278) - Native: add Android support. (#1725)
Fixes:
- Native/Inproc: provide
debug_meta.imagesin events passed toon_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.imagesentries that overlapped other libraries when a file was mapped more than once. (#2228) - Fix const-correctness of
sentry_options_get_*,sentry_span_iter_headers, andsentry_transaction_iter_headers. (#2277) - Native/Linux: back the crash context with a memfd to prevent
SIGBUSduringsentry_initwhen/dev/shmis full. (#1725) - Native/Unix: capture complete memory regions in
SENTRY_MINIDUMP_MODE_FULLinstead of truncating each region to 4 MB. (#2281) - Native: upload large minidumps separately if
sentry_options_set_enable_large_attachmentsis enabled. (#2281)
0.17.6
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_crashhook, are no longer dropped bysample_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
Fixes:
- Rate limits in an
X-Sentry-Rate-Limitsheader 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 as60:errorconsumed 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
Features:
- Add the
attach_stacktraceoption, 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_funchook, 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_closewhenhttp_retryis enabled. (#2199) - Native: Retry failed daemon uploads on the next SDK start when
http_retryis enabled. (#2199) - Native: Respect
symbolize_stacktracesfor 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
Fixes:
- The persisted installation ID is no longer required to be a UUID, so a platform integration can supply any ID that
user.idaccepts. (#2177) - The
org_idparsed from a DSN host now has to be all digits, so a host likeo123abc.example.comno longer produces a malformedorg_idin thebaggageheader 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:
- Add small, focused examples demonstrating common SDK operations. The old
example.chas moved totests/fixtures/integration.c. (#2125, #2173)
Thank you:
0.17.2
Features:
- Add
SENTRY_SDK_VERSION_MAJOR,SENTRY_SDK_VERSION_MINOR,SENTRY_SDK_VERSION_PATCH, andSENTRY_SDK_VERSION_AT_LEASTfor compile-time version checks. (#2136) - Let downstream platform integrations supply the installation ID. (#2150)
- Native/Crashpad/Linux: Add
max_stack_capture_sizeoption to limit non-crashing thread stack capture size. (#2137, crashpad#172) - Add
sentry_value_from_json,sentry_value_from_msgpack, andsentry_value_from_msgpack_streamalongside 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.idwhen removing the global user withsentry_remove_user. (#2151) - Unbind a finished span from the scope even when the span is dropped. (#2158)
- Native: fix
sentry_reinstall_backendto 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
Fixes:
- Fix crash context missing from PlayStation crash reports when an
on_crashcallback is set. (#2133)
0.17.0
Breaking / Important behavior changes:
- Attachment APIs now use
sentry_value_tandsentry_uuid_tinstead ofsentry_attachment_t *handles. Most attachment APIs, function names and arguments, are otherwise unchanged. (#1974) sentry_init()now consumes<db>/last_crashafter caching its value, aligning crashed-last-run behavior with other Sentry SDKs. (#2023)- Change the
hintparameter ofbefore_sendcallbacks (sentry_event_function_t) fromvoid *tosentry_hint_t *. Update callbacks registered withsentry_options_set_before_sendto use the new parameter type. (#2099) - Add a
sentry_hint_t *hintargument toon_crashcallbacks. (#2112) - Add a
sentry_hint_t *hintargument tosentry_scope_capture_event. PassNULLif no hint is needed. (#2099) - Remove
sentry_options_get/set_enable_logsandsentry_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 in0.16.We recognize that this change may inconvenience applications that rely on the opt-out. Use
sentry_options_set_before_send_logorsentry_options_set_before_send_metricto 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, andsentry_hint_add_attachmentfor 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_eventto pass event-specific attachments. The hint is also passed tobefore_sendandon_crash, which can modify attachments before the event is sent. (#2099, #2112) - Add
sentry_hint_get_attachments,sentry_hint_remove_attachment, andsentry_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:
0.16.8
Features:
- Add
sentry_options_set_initial_scopefor 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
⚠️ 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_tandsentry_uuid_tinstead ofsentry_attachment_t *handles. Most attachment APIs, function names and arguments, are otherwise unchanged. (#1974) sentry_init()now consumes<db>/last_crashafter caching its value, aligning crashed-last-run behavior with other Sentry SDKs. (#2023)- Remove
sentry_options_get/set_enable_logsandsentry_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 in0.16.We recognize that this change may inconvenience applications that rely on the opt-out. Use
sentry_options_set_before_send_logorsentry_options_set_before_send_metricto 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_scopefor 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, andsentry_hint_add_attachmentfor 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()becausesentry_init()now consumes the marker automatically. (#2023) - Deprecate
sentry_regenerate_trace()in favor ofsentry_start_new_trace(). (#2095)
Thank you: