- Custom redact modifier for SwiftUI (#4362, #4392)
- Remove the deprecated experimental Metrics API (#4406): Learn more
- Edge case for swizzleClassNameExclude (#4405): Skip creating transactions for UIViewControllers ignored for swizzling
via the option
swizzleClassNameExclude
. - Add TTID/TTFD spans when loadView gets skipped (#4415)
- Swizzling RootUIViewController if ignored by
swizzleClassNameExclude
(#4407)
- Serializing profile on a BG Thread (#4377) to avoid potentially slightly blocking the main thread.
- Added breadcrumb.origin private field (#4358)
- Custom redact modifier for SwiftUI (#4362)
- AppHangV2 detection (#4379) Add a new algorithm for detecting app hangs that differentiates between fully blocking and non-fully blocking app hangs. Read more in-depth in our docs.
- Add support for arm64e (#3398)
- Add mergeable libraries support to dynamic libraries (#4381)
- Speed up HTTP tracking for multiple requests in parallel (#4366)
- Slightly speed up SentryInAppLogic (#4370)
- Rename session replay
redact
options and APIs tomask
(#4373) - Stop canceling timer for manual transactions (#4380)
- Fix the versioning to support app release with Beta versions (#4368)
- Linking ongoing trace to crash event (#4393)
- Edge case for swizzleClassNameExclude (#4405): Skip creating transactions for UIViewControllers ignored for swizzling
via the option
swizzleClassNameExclude
.
- Added
thermal_state
to device context (#4305) - Send envelopes that cannot be cached to disk (#4294)
- Moved session replay API to
SentrySDK.replay
(#4326) - Changed default session replay quality to
medium
(#4326)
- Resumes replay when the app becomes active (#4303)
- Session replay redact view with transformation (#4308)
- Correct redact UIView with higher zPosition (#4309)
- Don't redact clipped views (#4325)
- Session replay for crash not created because of a race condition (#4314)
- Double-quoted include, expected angle-bracketed instead (#4298)
- Discontinue use of NSApplicationSupportDirectory in favor of NSCachesDirectory (#4335)
- Safe guard
strncpy
usage (#4336) - Stop using
redactAllText
as an indicator tha redact is enabled (#4327)
- Avoid extra work when storing invalid envelopes (#4337)
- Added
thermal_state
to device context (#4305) - Send envelopes that cannot be cached to disk (#4294)
- Moved session replay API to
SentrySDK.replay
(#4326) - Changed default session replay quality to
medium
(#4326)
- Resumes replay when the app becomes active (#4303)
- Session replay redact view with transformation (#4308)
- Correct redact UIView with higher zPosition (#4309)
- Don't redact clipped views (#4325)
- Session replay for crash not created because of a race condition (#4314)
- Double-quoted include, expected angle-bracketed instead (#4298)
- Discontinue use of NSApplicationSupportDirectory in favor of NSCachesDirectory (#4335)
- Safe guard
strncpy
usage (#4336) - Stop using
redactAllText
as an indicator tha redact is enabled (#4327)
- Avoid extra work when storing invalid envelopes (#4337)
- Continuous mode profiling (see
SentrySDK.startProfiler
andSentryOptions.profilesSampleRate
) (#4010)
- Proper redact SR during animation (#4289)
- Crash when reading corrupted envelope (#4297)
- Expose span baggage API (#4207)
- Fix
SIGABRT
when modifying scope user (#4274) - Crash during SDK initialization due to corrupted envelope (#4291)
- Reverts #4219 as potential fix
- Pause replay in session mode when offline (#4264)
- Add replay quality option for Objective-C (#4267)
- Session replay not redacting buttons and other non UILabel texts (#4277)
- Rarely reporting too long frame delays (#4278) by fixing a race condition in the frames tracking logic.
- Crash deserializing empty envelope length>0 (#4281]
- Guard dereferencing of stack frame pointer in SentryBacktrace (#4268)
Note: Due to a bug (#4280) introduced in this release, we recommend upgrading to 8.35.0 or newer.
This release fixes a bug (#4230) that we introduced with a refactoring (#4101) released in 8.30.1. This bug caused unhandled/crash events to have the unhandled property and mach info missing, which is required for release health to show events in the unhandled tab. It's essential to mention that this bug doesn't impact release health statistics, such as crash-free session or user rates.
- Support orientation change for session replay (#4194)
- Replay for crashes (#4171)
- Redact web view from replay (#4203)
- Add beforeCaptureViewHierarchy callback (#4210)
- Rename session replay
errorSampleRate
property toonErrorSampleRate
(#4218) - Add options to redact or ignore view for Replay (#4228)
- Skip UI crumbs when target or sender is nil (#4211)
- Guard FramesTracker start and stop (#4224)
- Long-lasting TTID/TTFD spans (#4225). Avoid long TTID spans when the FrameTracker isn't running, which is the case when the app is in the background.
- Missing mach info for crash reports (#4230)
- Crash reports not generated on visionOS (#4229)
- Don’t force cast to
NSComparisonPredicate
in TERNARY operator (#4232) - Fix accessing UI API on bg thread in enrichScope (#4245)
- EXC_BAD_ACCESS in SentryMetricProfiler (#4242)
- Missing '#include <sys/_types/_ucontext64.h>' (#4244)
- Rare flush timeout when called in tight loop (#4257)
- Reduce memory usage of storing envelopes (#4219)
- Skip enriching scope when nil (#4243)
- Add
reportAccessibilityIdentifier
option (#4183) - Record dropped spans (#4172)
- Session replay crash when writing the replay (#4186)
- Collect only unique UIWindow references (#4159)
- options.enableTracing was deprecated. Use options.tracesSampleRate or options.tracesSampler instead. (#4182)
- Session replay video duration from seconds to milliseconds (#4163)
- Include the screen names in the session replay (#4126)
- Properly handle invalid value for
NSUnderlyingErrorKey
(#4144) - Session replay in buffer mode not working (#4160)
- UIKitless configurations now produce a module with a different name (#4140)
- Sentry Replay Serialized Breadcrumbs include level name (#4141)
- Restart replay session with mobile session (#4085)
- Add pause and resume AppHangTracking API (#4077). You can now pause and resume app hang tracking with
SentrySDK.pauseAppHangTracking()
andSentrySDK.resumeAppHangTracking()
. - Add
beforeSendSpan
callback (#4095)
storeEnvelope
ends session for unhandled errors (#4073)- Deprecate
SentryUser.segment
(#4092). Please remove usages of this property. We will remove it in the next major. - Double-quoted include in framework header (#4115)
- Sentry Replay Network details should be available without Tracing (#4091)
- Fix potential deadlock in app hang detection (#4063)
- Swizzling of view controllers
loadView
that don't implementloadView
(#4071)
- Add a touch tracker for replay (#4041)
- Add enableMetricKitRawPayload (#4044)
- Resume session replay when app enters foreground (#4053)
SentryCrashMonitor_CPPException.cpp
compilation using Xcode 16b1 (#4051)
- Add replay quality option (#4035)
- Add breadcrumbs to session replay (#4002)
- Add start time to network request breadcrumbs (#4008)
- Add C++ exception support for
__cxa_rethrow
(#3996) - Add beforeCaptureScreenshot callback (#4016)
- Disable SIGTERM reporting by default (#4025). We added support
for SIGTERM reporting in the last release and enabled it by default.
For some users, SIGTERM events were verbose and not actionable.
Therefore, we disable it per default in this release. If you'd like
to receive SIGTERM events, set the option
enableSigtermReporting = true
.
- Stop FramesTracker when app is in background (#3979)
- Speed up adding breadcrumbs (#4029, #4034)
- Skip evaluating log messages when not logged (#4028)
- Fix retrieving GraphQL operation names crashing (#3973)
- Fix SentryCrashExceptionApplication subclass problem (#3993)
- Fix wrong value for
In Foreground
flag on UIKit applications (#4005) - Fix a crash in baggageEncodedDictionary (#4017)
- Session replay wrong video size (#4018)
- Add SIGTERM support (#3895)
- Fix data race when calling reportFullyDisplayed from a background thread (#3926)
- Ensure flushing envelopes directly after capturing them (#3915)
- Unable to find class: SentryCrashExceptionApplication (#3957)
- Clang error for Xcode 15.4 (#3958)
- Potential deadlock when starting the SDK (#3970)
- Send Cocoa SDK features (#3948)
The following two features, disabled by default, were mistakenly added to the release. We usually only add features in minor releases.
- Add option to use own NSURLSession for transport (#3811)
- Support sending GraphQL operation names in HTTP breadcrumbs (#3931)
- 'SentryFileManager+Test.h' file not found (#3950)
- Ignore SentryFramesTracker thread sanitizer data races (#3922)
- Handle no releaseName in WatchDogTerminationLogic (#3919)
- Stop SessionReplay when closing SDK (#3941)
- Remove not needed lock for logging (#3934)
- Session replay Improvements (#3877)
- Use image average color and text font color to redact session replay
- Removed iOS 16 restriction from session replay
- Performance improvement
- Add Session Replay, which is still experimental. (#3625)
- Access is limited to early access orgs on Sentry. If you're interested, sign up for the waitlist
- Crash due to a background call to -[UIApplication applicationState] (#3855)
- Save framework without UIKit/AppKit as Github Asset for releases (#3858)
- Fix crash associated with runtime collision in global C function names (#3862)
- Remove wrong error log in SentryCoreDataTracker (#3894)
- Don't transmit device boot time in envelopes enriched with crash data (#3912, #3916)
- Capture transactions on a background thread (#3892)
- Add Session Replay, which is still experimental. (#3625)
- Access is limited to early access orgs on Sentry. If you're interested, sign up for the waitlist
- Crash due to a background call to -[UIApplication applicationState] (#3855)
- Save framework without UIKit/AppKit as Github Asset for releases (#3858)
- Fix crash associated with runtime collision in global C function names (#3862)
- Remove wrong error log in SentryCoreDataTracker (#3894)
- Add timing API for Metrics (#3812):
- Add rate limiting for Metrics (#3838)
- Data normalization for Metrics (#3843)
- Add Metrics API (#3791, #3799): Read our docs to learn more about how to use the Metrics API.
- Pre-main profiling data is now attached to the app start transaction (#3736)
- Release framework without UIKit/AppKit (#3793)
- Add the option swizzleClassNameExcludes (#3813)
- Don't run onCrashedLastSession for nil Events (#3785)
- Redistributable static libraries should never be built with module debugging enabled (#3800)
- Fixed certain views getting loaded twice when adding a child view controller (#3753)
- Fixed broken imports in SentrySwiftUI Carthage build (#3817)
- Fix NSInvalidArgumentException for
NSError sentryErrorWithDomain
(#3819) - Again fix runtime error when including Sentry as a static lib (#3820)
- Fix crash in hasUnfinishedChildSpansToWaitFor (#3821)
- CFBundleShortVersionString in the Info.plist file is invalid (#3787)
- Sentry.framework does not support the minimum OS Version specified in the Info.plist (#3774)
- Add reference to Swift classes for hybrid SDKs (#3771)
- Sentry.framework does not support the minimum OS Version specified in the Info.plist (#3774)
- Add reference to Swift classes for hybrid SDKs (#3771)
- Fix runtime error when including Sentry as a static lib (#3764)
- Fix Mac Catalyst support for the prebuilt XCFramework used by SPM and Carthage (#3767)
- Checksum error when resolving the SDK via SPM (#3760)
Warning: this version is not working with SPM
- SPM uses a prebuilt XCFramework and remove SentryPrivate (#3623): We now provide a prebuilt XCFramework for SPM, which speeds up your build and allows us to write more code in Swift. To make this happen, we had to remove the SentryPrivate target for SPM and CocoaPods, which you shouldn't have included directly.
- Write NSException reason for crash report (#3705)
- Add context to event with CrashIntegration disabled (#3699)
- Add support for Sentry Spotlight (#3642), which is basically Sentry for development. Read our blog post to find out more.
- Add field
SentrySDK.detectedStartUpCrash
(#3644) - Automatically profile app launches (#3529)
- Use CocoaPods resource_bundles for PrivacyInfo (#3651)
- Make tags of SentryScope public (#3650)
- Cache installationID async to avoid file IO on the main thread when starting the SDK (#3601)
- Add reason for NSPrivacyAccessedAPICategoryFileTimestamp (#3626)
- Finish TTID span when transaction finishes (#3610)
- Don't take screenshot and view hierarchy for app hanging (#3620)
- Remove
free_storage
andstorage_size
from the device context (#3627), because Apple forbids sending information retrieved viaNSFileSystemFreeSize
andNSFileSystemSize
off a device; see Apple docs. - Make SentryFramesTracker available for HybridSDKs (#3683)
- Make SentrySwizzle available for HybridSDKs (#3684)
- Move headers reference out of "extern C" (#3690)
- Add support for Sentry Spotlight (#3642), which is basically Sentry for development. Read our blog post to find out more.
- Add field
SentrySDK.detectedStartUpCrash
(#3644) - Automatically profile app launches (#3529)
- Use CocoaPods resource_bundles for PrivacyInfo (#3651)
- Make tags of SentryScope public (#3650)
- Cache installationID async to avoid file IO on the main thread when starting the SDK (#3601)
- Add reason for NSPrivacyAccessedAPICategoryFileTimestamp (#3626)
- Finish TTID span when transaction finishes (#3610)
- Don't take screenshot and view hierarchy for app hanging (#3620)
- Remove
free_storage
andstorage_size
from the device context (#3627), because Apple forbids sending information retrieved viaNSFileSystemFreeSize
andNSFileSystemSize
off a device; see Apple docs.
- Add visionOS as device family (#3548)
- Add VisionOS Support for Carthage (#3565)
- Move header reference out of "extern C" (#3538)
- Clarify FramesTracker log message (#3570)
- Fix rare battery breadcrumbs crash (#3582)
- Fix synchronization issue in FramesTracker (#3571)
- Fix SentryFileManager logs warning for .DS_Files (#3584)
- Fix FileManager logs info instead of error when a path doesn't exist (#3594)
- Send debug meta for app start transactions (#3543)
- Fix typo in BUILD_LIBRARY_FOR_DISTRIBUTION variable in Makefile (#3488)
- Remove dispatch queue metadata collection to fix crash (#3522)
- Make SentryScope.useSpan non-blocking (#3568)
- Don't override
sentry-trace
andbaggage
headers (#3540)
- Add frames delay to transactions and spans (#3487, #3496)
- Add slow and frozen frames to spans (#3450, #3478)
- Split up UIKit and App Init App Start Span (#3534)
- Prewarmed App Start Tracing is stable (#3536)
- TTFD waits for next drawn frame (#3505)
- Fix TTID/TTFD for app start transactions (#3512): TTID/TTFD spans and measurements for app start transaction now include the app start duration.
- Crash when adding a crumb for a timezone change (#3524)
- Fix a race condition in SentryTracer (#3523)
- App start ends when first frame is drawn when performanceV2 is enabled (#3530)
- Use correct rendered frames timestamp for TTID/TTFD and app start (#3531)
- Missing transactions when not calling
reportFullyDisplayed
(#3477)
- Fix marking manual sessions as crashed (#3501): When turning off autoSessionTracking and manually starting and ending sessions, the SDK didn't mark sessions as crashed when sending a crash event to Sentry. This is fixed now.
- Crash when UINavigationController doesn't have rootViewController (#3455)
- Crash when synchronizing invalid JSON breadcrumbs to SentryWatchdogTermination (#3458)
- Check for NULL in binary image cache (#3469)
- Threading issues in binary image cache (#3468)
- Finish transaction for external view controllers (#3440)
- SwiftUI support is no longer in Beta (#3441)
- Fix inaccurate number of frames for transactions (#3439)
- Add screen name to app context (#3346)
- Add cache directory option (#3369)
- Infinite loop when parsing MetricKit data (#3395)
- Fix incorrect implementation in #3398 to work around a profiling crash (#3405)
- Fix crash in SentryFramesTracker (#3424)
- Build XCFramework with Xcode 15 (#3415)
The XCFramework attached to GitHub releases is now built with Xcode 15.
- Crash when logging from certain profiling contexts (#3390)
- Crash when initializing SentryHub manually (#3374)
- Enrich error events with any underlying NSErrors reported by Cocoa APIs (#3230)
- Add experimental visionOS support (#3328)
- Improve OOM detection by ignoring system reboot (#3352)
- Add thread id and name to span data (#3359)
- Reporting app hangs from background (#3298)
- Thread sanitizer data race warnings in ANR tracker, network tracker and span finish (#3303)
- Stop sending empty thread names (#3361)
- Work around edge case with a thread info kernel call sometimes returning invalid data, leading to a crash (#3364)
- Crashes when trace ID is externally modified or profiler fails to initialize (#3365)
- Missing
mechanism.handled
is not considered crash (#3353)
- SPM build failure involving "unsafe settings" (#3348)
-
Sentry can now be used without linking UIKit; this is helpful for using the SDK in certain app extension contexts (#3175) Note: this is an experimental feature not yet available for with SPM. Warning: this breaks some SPM integrations. Use 8.14.1 if you integrate using SPM.
-
GA of MetricKit integration (#3340)
Once enabled, this feature subscribes to MetricKit's MXDiagnosticPayload data, converts it to events, and sends it to Sentry. The MetricKit integration subscribes to MXHangDiagnostic, MXDiskWriteExceptionDiagnostic, and MXCPUExceptionDiagnostic.
- Always start SDK on the main thread (#3291)
- App hang with race condition for tick counter (#3290)
- Remove "duplicate library" warning (#3312)
- Fix multiple issues in Reachability (#3338)
- Remove unnecessary build settings (#3325)
- Crash in SentryTracer when cancelling timer (#3333)
- Remove sync call to main thread from SentryUIDeviceWrapper (#3295)
- Record changes to network connectivity in breadcrumbs (#3232)
- Add Sampling Decision to Trace Envelope Header (#3286)
- Remove warning about non-portable path to file "SentryDsn.h" (#3270)
- Privacy manifest collection purposes type (#3276)
- Fix how profiles were identified in the backend for grouping and issue correlation purposes (#3282)
- Ensure GPU frame data is always sent with profiles even if
enableAutoPerformanceTracing
isNO
(#3273) - Gather metric readings fully covering the duration of a profile (#3272)
- Remove spammy logs (#3284)
- Rename "http.method" to "http.request.method" for network Spans (#3268)
- Distributed tracing without performance (#3196)
- Report database backing store information for Core Data (#3231)
- Add "data use" in privacy manifests (#3259)
- Add required reason API (#3206)
- Report correct units (nanojoules) for profiling energy metrics (#3262)
- Record energy usage estimates for profiling (#3217)
- Remove a noisy NSLog (#3227)
- WatchOS build for Xcode 15 (#3204)
- Fix CPU usage collection for upcoming visualization in profiling flamecharts (#3214)
- Allow profiling from hybrid SDKs (#3194)
- Remove linker settings from Package.swift (#3188)
- Free memory returned by backtrace_symbols() in debug builds (#3202)
- Reclaim memory used by profiler when transactions are discarded (#3154)
- Crashed session not being reported as crashed (#3183)
Do not use this version if you use Release Health. It introduces a bug where crashed Sessions would not be reported correctly. This has been fixed in version 8.9.3
.
- Reduced macOS SDK footprint by 2% (#3157) with similar changes for tvOS and watchOS (#3158, #3159, #3161)
- Fix a crash in SentryCoreDataTracker for nil error params (#3152)
- Fix potential unbounded memory growth when starting profiled transactions from non-main contexts (#3135)
- Symbolicate locally only when debug is enabled (#3079)
This change considerably speeds up retrieving stacktraces, which the SDK uses for captureMessage, captureError and also for reporting file IO or DB operation on the main thread.
- Sanitize HTTP info from breadcrumbs, spans and events (#3094)
- Renamed
enableTimeToFullDisplay
toenableTimeToFullDisplayTracing
(#3106)- This is an experimental feature and may change at any time without a major revision.
- Symbolicate locally only when debug is enabled (#3079)
- Sanitize HTTP info from breadcrumbs, spans and events (#3094)
- Experimental support for Swift Async stacktraces (#3051)
- Cache binary images to be used for crashes (#2939)
- Fix a data race for
SentryId.empty
(#3072) - Duplicated HTTP breadcrumbs (#3058)
- Expose SentryPrivate and SentrySwiftUI schemes for cartahge clients that have
--no-use-binaries
option (#3071) - Convert last remaining
sprintf
call tosnprintf
(#3077) - Fix a crash when serializing profiling data (#3092)
- Changed
Trace
serialized value ofsampled
from string to boolean (#3067)
- Removed
nameForSentrySampleDecision
which shouldn't have been public (#3067)
- Convert one of the two remaining usages of
sprintf
tosnprintf
(#2866) - Fix use-after-free ASAN warning (#3042)
- Fix memory leaks in the profiler (#3055, #3061)
- Fix crashes in profiling serialization race condition (#3018, #3035)
- Fix a crash for user interaction transactions (#3036)
- Add
sent_at
to envelope header (#2859) - Fix import of
User
&Breadcrumb
(#3017)
- Allow starting the SDK with an initial scope (#2982)
- Swift Error Names (#2960)
enum LoginError: Error {
case wrongUser(id: String)
case wrongPassword
}
SentrySDK.capture(error: LoginError.wrongUser("12345678"))
For the Swift error above Sentry displays:
sentry-cocoa SDK | Title | Description |
---|---|---|
Since 8.7.0 | LoginError |
wrongUser(id: "12345678") (Code: 1) |
Before 8.7.0 | LoginError |
Code: 1 |
Customized error descriptions have precedence over this feature. This change has no impact on grouping of the issues in Sentry.
- Propagate span when copying scope (#2952)
- Remove "/" from crash report file name (#3005)
- Send trace origin (#2957)
Trace origin indicates what created a trace or a span. Not all transactions and spans contain enough information to tell whether the user or what precisely in the SDK created it. Origin solves this problem. The SDK now sends origin for transactions and spans.
- Create User and Breadcrumb from map (#2820)
- Improved performance serializing profiling data (#2863)
- Possible crash in Core Data tracking (#2865)
- Ensure the current GPU frame rate is always reported for concurrent transaction profiling metrics (#2929)
- Move profiler metric collection to a background queue (#2956)
- Remove experimental
stitchAsyncCode
from SentryOptions (#2973)
The stitchAsyncCode
experimental option has been removed from SentryOptions
as its behavior was unpredictable and sometimes resulted in unexpected errors. We plan to add it back once we fix it, but we don't have an ETA for it.
- feat: Core data operation in the main thread (#2879)
- Crash when serializing invalid objects (#2858)
- Don't send screenshots with either width or height of 0 (#2876)
- GPU frame alignment with stack traces in profiles (#2856)
- Time to initial and full display (#2724)
- Add time-to-initial-display and time-to-full-display measurements to ViewController transactions (#2843)
- Add
name
andgeo
to User (#2710)
- Correctly track and send GPU frame render data in profiles (#2823)
- Xcode 14.3 compiling issue regarding functions declaration with no prototype (#2852)
- View hierarchy not sent for crashes (#2781)
- Crash in Tracer for idle timeout (#2834)
- Add CPU core count in device context (#2814)
- Updating AppHang state on main thread (#2793)
- App Hang report crashes with too many threads (#2811)
- Remove not needed locks in SentryUser (#2809)
- Stop using UIScreen.main (#2762)
- Profile timestamp alignment with transactions (#2771) and app start spans (#2772)
- Fix crash when compiling profiling data during transaction serialization (#2786)
This release can cause crashes when Profiling is enabled (#2779). Please update to 8.3.1
.
- Crash in AppHangs when no threads (#2725)
- MetricKit stack traces (#2723)
- InApp for MetricKit stack traces (#2739)
- Mutating while enumerating crash in Tracer (#2744)
- Normalize profiling timestamps relative to transaction start (#2729)
- Add enableTracing option (#2693)
- Add isMain thread to SentryThread (#2692)
- Add
in_foreground
to App Context (#2692) - Combine UIKit and SwiftUI transactions (#2681)
- Cleanup AppHangTracking properly when closing SDK (#2671)
- Add EXC_BAD_ACCESS subtypes to events (#2667)
- Keep status of auto transactions when finishing (#2684)
- Fix atomic import error for profiling (#2683)
- Don't create breadcrumb for UITextField editingChanged event (#2686)
- Fix EXC_BAD_ACCESS in SentryTracer (#2697)
- Serialization of nullable booleans (#2706)
- Change debug image type to macho (#2701)
This change might mark 3rd party library frames as in-app, which the SDK previously marked as system frames.
- Add thread information to File I/O spans (#2573)
- AttachScreenshots is GA (#2623)
- Gather profiling timeseries metrics for CPU usage and memory footprint (#2493)
- Change SentryTracedView
transactionName
toviewName
(#2630)
- Support uint64 in crash reports (#2631, #2642, #2663)
- Always fetch view hierarchy on the main thread (#2629)
- Carthage Xcode 14 compatibility issue (#2636)
- Crash in CppException Monitor (#2639)
- fix: Disable watchdog when disabling crash handler (#2621)
- MachException Improvements (#2662)
This version adds a dependency on Swift.
We renamed the default branch from master
to main
. We are going to keep the master
branch for backwards compatibility for package managers pointing to the master
branch.
- Properly demangle Swift class name (#2162)
- Change view hierarchy attachment format to JSON (#2491)
- Experimental SwiftUI performance tracking (#2271)
- Enable File I/O Tracking by default (#2497)
- Enable AppHang Tracking by default (#2600)
- Enable Core Data Tracing by default (#2598)
- User Interaction Tracing is stable and enabled by default(#2503)
- Add synthetic for mechanism (#2501)
- Enable CaptureFailedRequests by default (#2507)
- Support the
SENTRY_DSN
environment variable on macOS (#2534) - Experimental MetricKit integration (#2519) for
- Add a timeout for auto-generated transactions (#2535)
- Errors shortly after
SentrySDK.init
now affect the session (#2430) - Use the same default environment for events and sessions (#2447)
- Increase
SentryCrashMAX_STRINGBUFFERSIZE
to reduce the instances where we're dropping a crash due to size limit (#2465) SentryAppStateManager
correctly unsubscribes fromNSNotificationCenter
when closing the SDK (#2460)- The SDK no longer reports an OOM when a crash happens after closing the SDK (#2468)
- Don't capture zero size screenshots (#2459)
- Use the preexisting app release version format for profiles (#2470)
- Don't add out of date context for crashes (#2523)
- Fix ARC issue for FileManager (#2525)
- Remove delay for deleting old envelopes (#2541)
- Fix strong reference cycle for HttpTransport (#2552)
- Deleting old envelopes for empty DSN (#2562)
- Remove
SentrySystemEventBreadcrumbs
observers with the most specific detail possible (#2489)
- Rename
- [SentrySDK startWithOptionsObject:]
to- [SentrySDK startWithOptions:]
(#2404) - Make
SpanProtocol.data
non nullable (#2409) - Mark
- [SpanProtocol setExtraValue:forKey:]
as deprecated (#2413) - Make SpanContext immutable (#2408)
- Remove tags from SpanContext
- Remove context property from SentrySpan
- Bump minimum supported OS versions to macOS 10.13, iOS 11, tvOS 11, and watchOS 4 (#2414)
- Make public APIs Swift friendly
- Rename
SentrySDK.addBreadcrumb(crumb:)
toSentrySDK.addBreadcrumb(_ crumb:)
(#2416) - Rename
SentryScope.add(_ crumb:)
toSentryScope.addBreadcrumb(_ crumb:)
(#2416) - Rename
SentryScope.add(_ attachment:)
toSentryScope.addAttachment(_ attachment:)
(#2416) - Rename
Client
toSentryClient
(#2403)
- Rename
- Remove public APIs
- Remove
SentryScope.apply(to:)
(#2416) - Remove
SentryScope.apply(to:maxBreadcrumb:)
(#2416) - Remove
- [SentryOptions initWithDict:didFailWithError:]
(#2404) - Remove
- [SentryOptions sdkInfo]
(#2404) - Make SentrySession and SentrySDKInfo internal (#2451)
- Remove
- Marks App hang's event stacktrace snapshot as true (#2441)
- Enable user interaction tracing by default (#2442)
- Remove default attachment content type (#2443)
- Rename APM tracking feature flags to tracing (#2450)
- Rename
SentryOptions.enableAutoPerformanceTracking
toenableAutoPerformanceTracing
- Rename
SentryOptions.enableUIViewControllerTracking
toenableUIViewControllerTracing
- Rename
SentryOptions.enablePreWarmedAppStartTracking
toenablePreWarmedAppStartTracing
- Rename
SentryOptions.enableFileIOTracking
toenableFileIOTracing
- Rename
SentryOptions.enableCoreDataTracking
toenableCoreDataTracing
- Rename
- SentrySDK.close calls flush, which is a blocking call (#2453)
- Bump minimum Xcode version to 13 (#2483)
- Rename
SentryOptions.enableOutOfMemoryTracking
toSentryOptions.enableWatchdogTerminationTracking
(#2499) - Remove the automatic
viewAppearing
span for UIViewController APM (#2511) - Remove the permission context for events (#2529)
- Remove captureEnvelope from Hub and Client (#2580)
- Remove confusing transaction tag (#2574)
- Crash in SentryOutOfMemoryScopeObserver (#2557)
- Screenshot crashes when application delegate has no window (#2538)
- Reporting crashes when restarting the SDK (#2440)
- Core data span status with error (#2439)
- Crash in Client when reading integrations (#2398)
- Don't update session for dropped events (#2374)
- Set the correct OOM event timestamp (#2394)
- Store breadcrumbs to disk for OOM events (#2347)
- Report pre-warmed app starts (#1969)
- Too long flush duration (#2370)
- Do not delete the app state when OOM tracking is disabled. The app state is needed to determine the app start type on the next app start. (#2382)
- Call UIDevice methods on the main thread (#2369)
- Avoid sending profiles with 0 samples or incorrectly deduplicated backtrace elements (#2375)
- Fix issue with invalid profiles uploading (#2358 and #2359)
- Profile concurrent transactions (#2227)
- HTTP Client errors (#2308)
- Disable bitcode for Carthage distribution (#2341)
- Stop profiler when app moves to background (#2331)
- Clean up old envelopes (#2322)
- Crash when starting a profile from a non-main thread (#2345)
- SentryCrash writing nan for invalid number (#2348)
- Offline caching improvements (#2263)
- Report usage of stitchAsyncCode (#2281)
- Enable bitcode (#2307)
- Fix moving app state to previous app state (#2321)
- Use CoreData entity names instead of "NSManagedObject" (#2329)
- Custom measurements API (#2268)
- Device info details for profiling (#2205)
- Use double-checked lock for flush (#2290)
- Add app start measurement to first finished transaction (#2252)
- Return SentryNoOpSpan when starting a child on a finished transaction (#2239)
- Fix profiling timestamps for slow/frozen frames (#2226)
- Report start up crashes (#2220)
- Add segment property to user (#2234)
- Support tracePropagationTargets (#2217)
- Correctly attribute enterprise builds (#2235)
- Core Data Tracking is stable (#2213)
- File I/O Tracking is stable (#2212)
- Add flush (#2140)
- Add more device context (#2190)
- Sentry-trace header incorrectly assigned to http requests (#2167)
- Use the
component
name source for SentryPerformanceTracker (#2168) - Add support for arm64 architecture to the device context (#2185)
- Align core data span operations (#2222)
- Prewarmed app start detection (#2151)
- Users can customize the error description shown in the Sentry UI by providing an NSDebugDescriptionErrorKey value in the error user info dictionary. (#2120)
- Add support for dynamic library (#1726)
- Can't find app image when swizzling (#2124)
- Crash with screenshot is reported twice (#2134)
- Setting SDK name through
options[sdk][name]
shouldn't clear version (#2139)
- Remove Media Library Permission check from permission observer (#2123)
- App permissions are now also included when running from an app extension (#2106)
- Report App Memory Usage (#2027)
- Include app permissions with event (#1984)
- Add culture context to event (#2036)
- Attach view hierarchy to events (#2044)
- Clean up SentryOptions: added
enableCrashHandler
and deprecatedintegrations
(#2049) - Integrations send the transaction name source (#2076)
- Added extra logs when creating automatic transactions and spans (#2087)
- Fix Swift 5.5 compatibility (#2060)
- Add span finish flag (#2059)
- SentryUser.userId should be nullable (#2071)
- Send time zone name, not abbreviation (#2091)
- Use a prime number for the profiler's sampling rate to reduce the potential for lock-step issues (#2055).
- Improve App Hangs detection (#2100)
- Send
environment
set fromSentryOptions
orconfigureScope
with profiling data (#2095)
- Report App Memory Usage (#2027)
- Include app permissions with event (#1984)
- Add culture context to event (#2036)
- Attach view hierarchy to events (#2044)
- Clean up SentryOptions: added
enableCrashHandler
and deprecatedintegrations
(#2049) - Integrations send the transaction name source (#2076)
- Added extra logs when creating automatic transactions and spans (#2087)
- Fix Swift 5.5 compatibility (#2060)
- Add span finish flag (#2059)
- SentryUser.userId should be nullable (#2071)
- Send time zone name, not abbreviation (#2091)
- Use a prime number for the profiler's sampling rate to reduce the potential for lock-step issues (#2055).
- Improve App Hangs detection (#2100)
- Send
environment
set fromSentryOptions
orconfigureScope
with profiling data (#2095)
- Add sampling configuration for profiling (#2004)
- Add transaction to baggage and trace headers (#1992)
- Log empty samples instead of collecting stacks for idle threads (#2013)
- Remove logging that could occur while a thread is suspended (#2014)
- Handle failure to read thread priority gracefully (#2015)
- Fix address sanitizer compilation error (#1996)
- Read free_memory when the event is captured, not only at SDK startup (#1962)
- Provide private access to SentryOptions for hybrid SDKs (#1991)
- Remove Sentry keys from cached HTTP request headers (#1975)
- Collect samples for idle threads in iOS profiler (#1978)
- Fix removeNonSdkFrames working incorrectly for os users named sentry(#2002)
- Don't override already-set timestamp when finishing Span (#1993)
- Respect existing baggage header instead of overwriting it (#1995)
- Enhance the UIViewController breadcrumbs with more data (#1945)
- feat: Add extra app start span (#1952)
- Add enableAutoBreadcrumbTracking option (#1958)
- Automatic nest spans with the UI life cycle (#1959)
- Upload frame rendering timestamps to correlate to sampled backtraces (#1910)
- Remove PII from auto-generated core data spans (#1982)
- Don't track OOMs for simulators (#1970)
- Properly sanitize the event context and SDK information (#1943)
- Don't send error 429 as
network_error
(#1957) - Sanitize Span data (#1963)
- Deprecate not needed option
sdkInfo
(#1960) - Crash in profiling logger (#1964)
- Add screenshot at crash (#1920)
- Track timezone changes as breadcrumbs (#1930)
- Add sample rate in the baggage header, remove Userid and Transaction (#1936)
- Add main thread ID to profiling payload (#1918)
- Add App Hangs tracking (#1906)
- Remove WebKit optimization check (#1921)
- Detect prewarmed starts with env variable (#1927)
- Fix high percentage of slow frames (#1915)
- Replace tracestate header with baggage (#1867)
- Discard long-lasting auto-generated transactions (#1903)
- Unset scope span when finishing idle transaction (#1902)
- Set max app start duration to 60s (#1899)
- Screenshot wrongly attached in crash events (#1901)
- Implement description for SentryBreadcrumb (#1880)
- Propagate configured SDK info from options to events (#1853)
- Stop reporting pre warmed app starts (#1896)
- Fix reporting wrong OOM when starting SDK twice (#1878)
- Fix JSON conversion error message (#1856)
- Transaction tag and data serialization (#1826)
- UI event transactions for clicks (#1784)
- Collect queue label information for profiles (#1828)
- Use the macho format for debug information in Profiling (#1830)
- Allow partial SDK info override (#1816)
- Hub uses its scope (#1821)
- Add profile data category for rate limiting (#1799)
- Allow setting SDK info with Options initWithDict (#1793)
- Remove ViewController name match for swizzling (#1802)
- Apply patch for SentryCrashCachedData (#1790)
- Fix getting class data mask in SentryCrash (#1788)
- Use pod_target_xcconfig for Podspec #1792
- Case sensitive header import error (#1794)
- Parsing of output from backtrace_symbols() (#1782)
- fix: User feedback crash (#1766)
- feat: Attach screenshots for errors (#1751)
- fix: Remove authenticated pointer stripping for iOS backtraces (#1757)
- perf: Filter binary images on Sentry Crash (#1767)
- fix: NSURL warning during SDK initialization (#1764)
If you are using self-hosted Sentry, this version requires Sentry version >= 21.9.0
to work or you have to manually disable sending client reports via the sendClientReports
option.
- feat: Add Client Reports (#1733)
- fix: enableProfiling option via initWithDict (#1743)
This release contains a fix for the sampling of transactions. The SDK applied both sample rates for events and transactions when capturing transactions. Previously, when setting sampleRate to 0.0, the SDK would discard all transactions. This is fixed now by ignoring the sampleRate for transactions. If you use custom values for sampleRate and traceSampleRate or traceSampler, this change will have an impact on you.
If you are using profiling and self-hosted Sentry, this version requires Sentry version >= 22.3.0.
- fix: Avoid race condition in SentryCrash (#1735)
- fix: Possible endless loop for onCrashedLastRun (#1734)
- fix: Wrongly sampling transactions (#1716)
- feat: Add flag for UIViewControllerTracking (#1711)
- feat: Add more info to touch event breadcrumbs (#1724)
- feat: Add support for profiling on iOS (#1652) by @armcknight
- feat: Add support for profiling on iOS (#1652) by @armcknight
- feat: Add CoreData performance tracking (#1682)
- fix: Detecting ANRs as false OOMs (#1695)
- fix: Crash in UIViewControllerSwizzling (#1692)
- fix: Swizzling UIViewControllers crash (#1670)
- feat: Expose Installation ID for Hybrid SDKs (#1680)
- fix: SentryNSURLSessionTaskSearch using invalid nil parameter with NSURLSession (#1669)
- fix: Always tracks App start for Hybrid SDKs (#1662)
- feat: Send SDK integrations (#1647)
- fix: Don't track OOMs for unit tests (#1651)
- fix: Add verification for vendor UUID in OOM logic (#1648)
- fix crash in dirContentsCount() when dir == NULL (#1658)
- fix: Crash in SentrySubClassFinder (#1635)
- fix: Set timestamp in init of event (#1629)
- fix: Load invalid CrashState json (#1625)
- feat: Auto I/O spans for NSData (#1557)
- feat: Support for fatalError, assert, precondition (#1596)
- feat: Include unfinished spans in transactions (#1592)
- build: Disable NSAssertions for Release Builds (#1545)
- feat: Send Locale with Events (#1539)
- fix: iOS13-Swift build (#1522)
- fix: Check task support on setState: (#1523)
- fix: Create span for loadView (#1495)
- feat: Add flag to control network requests breadcrumbs (#1505)
- feat: Support for ignored signals with SIGN_IGN (#1489)
- fix: Sending OOM when SDK is closed (#1487)
- fix: Use swizzling instead of KVO for network tracking (#1452)
- fix: AppStart Transaction for Apps Using UIScenes (#1427) by @brustolin
- fix: SentryOptions initWithDict type errors (#1443)
- fix: Transaction default status should be OK (#1439)
- fix: AppStart Transaction for Apps Using UIScenes (#1427)
- feat: Add one flag to disable all swizzling (#1430)
- fix: Dispatch Queue ARC Warning for RN (#1424)
- fix: Dictionary Key cannot be nil, in SentryPerformanceTracer (#1434)
- fix: Crash when objc_getClassList returns different values (#1420)
- fix: Only enable APM when traceRate set (#1417)
- fix: Crash in Span when Tracer nil (#1416)
- fix: Instrumenting multiple UIViewControllers (#1409)
- fix: Clear unfinished transaction in UIViewController APM (#1408)
- fix: Crash when Getting Subclasses (#1396)
- fix: Remove Check for Original Method Call When Swizzling (#1383)
- fix: Init for Span, Tracer, Transaction (#1385)
- fix: Crash for Call Should be on Main Thread (#1371)
- fix: Crash for Custom ViewController init on iOS 15 (#1361)
- fix: Crash When Observing Span Finished (#1360)
- fix: HTTP instrumentation KVO crash (#1354)
- feat: Add enableNetworkTracking flag (#1349)
- fix: Memory Leak for Span (#1352)
- fix: Trying to swizzle a class without a library name (#1332)
-
fix: maxBreadcrumb zero crashes when adding (#1326)
-
feat: Add tracestate HTTP header support (#1291)
- No documented changes.
- Nothing
- fix: SpanProtocol add setData for Swift (#1305)
- fix: SentryHub not checking spanContext sampled value (#1318)
- fix: Remove Trace Headers below iOS 14.0 (#1309)
- fix: XCFramework output not preserving symlinks for macOS (#1281)
- fix: Add Trace Headers below iOS 14.0 (#1302)
- fix: Swizzling crash on iOS 13 (#1297)
- fix: Sentry HTTP Trace Header Breaking Requests (#1295)
- fix: Apps crash when using a URLSessionTask subclass with currentRequest unavailable (#1294)
- fix: Build failure for SPM (#1284)
- fix: Set app state on main thread when terminating (#1272)
- fix: Crash when swizzling Nib UIViewController (#1277)
This release fixes a crucial issue for auto performance instrumentation that caused crashes when using nested ViewControllers.
- fix: Callback issue for auto performance (#1275)
This release contains support for auto performance instrumentation for ViewControllers, HTTP requests, app start and slow and frozen frames.
- feat: Auto UI Performance Instrumentation (#1105, #1150, #1136, #1139, #1042, #1264, #1164, #1202, #1231, #1242)
- feat: Measure slow and frozen frames (#1123)
- feat: Measure app start time (#1111, #1228)
- feat: Add automatic HTTP request performance monitoring (#1178, #1237, #1250, #1255)
- feat: Add tags to Sentry Span (#1243)
- feat: Sub-millis precision for spans and events (#1234)
- feat: Add Sentry Trace HTTP Header (#1213)
- feat: Add flag stichAsyncCode (#1172)
- feat: Support XCFramework for Carthage (#1175)
- feat: Add isEnabled property in SentrySDK (#1265)
- feat: Add breadcrumbs for HTTP requests (#1258)
- feat: Add clearAttachments to Scope (#1195)
- feat: Expose tracked screen frames (#1262)
- feat: Expose AppStartMeasurement for Hybrid SDKs (#1251)
- fix: Remove invalid excludes from
Package.swift
(#1169) - fix: Compile failure with C99 (#1224)
- fix: Race on session task (#1233)
- fix: Remove tags and data if empty for Span (#1246)
- perf: Scope sync to SentryCrash (#1193)
- feat: Expose tracked screen frames (#1262)
- feat: Expose AppStartMeasurement for Hybrid SDKs (#1251)
- fix: Span serialization HTTP data in wrong place. (#1255)
- feat: Add tags to Sentry Span (#1243)
- fix: Remove tags and data if empty for Span (#1246)
- fix: Race Conditions in NetworkTracker (#1250)
- fix: Don't create transactions for HTTP Requests. (#1237)
- fix: Swizzle only inApp ViewControllers (#1242)
- feat: Add Sentry Trace HTTP Header (#1213)
- feat: Sub-millis precision for spans and events (#1234)
- fix: Race on session task (#1233)
- fix: ViewController swizzling before iOS 13 (#1231)
- fix: AppStartMeasurement didFinishLaunching is nil (#1228)
- perf: Scope sync to SentryCrash (#1193)
- fix: Compile failure with C99 (#1224)
- fix: Add viewAppearing to UIViewController spans (#1202)
- feat: Add automatic http request performance monitoring (#1178)
- feat: Add clearAttachments to Scope (#1195)
- feat: Add flag stichAsyncCode (#1172)
- feat: Support XCFramework for Carthage (#1175)
- fix: Remove invalid excludes from
Package.swift
(#1169)
- feat: Measure slow and frozen frames (#1123)
- fix: Operation names for auto instrumentation (#1164)
- feat: Measure app start time (#1111)
- feat: Auto UI Performance Instrumentation (#1105, #1150, #1136, #1139, #1042)
- fix: Compile failure with C99 (#1224)
- feat: Add PrivateSentrySDKOnly (#1131)
- fix: Serialization of span description (#1128)
- No documented changes. This is the same as 7.1.0. Ignore this release and please use 7.1.2 instead.
- fix: Remove SentryUnsignedLongLongValue (#1118)
- feat: Expose SentryDebugImageProvider (#1094)
- docs: Improve code doc on start and endSession (#1098)
- fix: Add SentryMechanismMeta to Sentry.h (#1102)
- No documented changes. This is the same as 7.0.1. Ignore this release and please use 7.0.3 instead.
ref: Prefix TracesSampler with Sentry (#1091)
This is a major bump with the Performance Monitoring API and Out of Memory Tracking, many improvements and a few breaking changes. For a detailed explanation how to upgrade please checkout the migration guide.
- ref: Add SentryMechanismMeta (#1048)
- ref: Align SentryException with unified API (#1026)
- ref: Remove deprecated SentryHub.getScope (#1025)
- ref: Make closeCachedSessionWithTimestamp private (#1022)
- ref: Improve envelope API for Hybrid SDKs (#1020)
- ref: Remove currentHub from SentrySDK (#1019)
- feat: Add maxCacheItems (#1017)
- ref: SentryEvent.timestamp changed to nullable.
- ref: Add read-only scope property to Hub (#975)
- ref: Remove SentryException.userReported (#974)
- ref: Replace SentryLogLevel with SentryLevel (#979)
- fix: Mark frames as inApp (#956)
- feat: Performance Monitoring API (#909, #977, #961, #932, #919, #992, #1065, #1042, #1079, #1061, #1069, #1066, #1040, #1084)
- feat: Out Of Memory Tracking (#1001, #1015)
- feat: Add close method to SDK (#1046)
- feat: Add start and endSession to SentrySDK (#1021)
- feat: Add urlSessionDelegate option to SentryOptions (#965)
- ref: Set sample rates to default if out of range (#1074): When setting a value
SentryOptions.sampleRate
that is not >= 0.0 and <= 1.0 the SDK sets it to the default of 1.0. - fix: Release builds in CI (#1076)
- perf: Avoid allocating dict in BreadcrumbTracker (#1027)
- fix: Crash when passing garbage to maxBreadcrumbs (#1018)
- fix: macOS version for Mac Catalyst (#1011)
- ref: Set sample rates to default if out of range (#1074): When setting a value
SentryOptions.sampleRate
that is not >= 0.0 and <= 1.0 the SDK sets it to the default of 1.0. - feat: Add trace information from scope to event capture (#1065)
- fix: SentryOptions.tracesSampleRate default value (#1069)
- ref: Discard unfinished spans when capturing transaction (#1066)
- ref: Make calls to customSamplingContext nonnull (#1061)
- ref: Mark async call chains explicitly as such (#1071)
- fix: fix: performance headers (#1079)
- fix: performance headers (#1079)
- fix: Release builds in CI (#1076)
- feat: Add close method to SDK #1046
- ref: Add SentryMechanismMeta #1048: Replaced dict
SentryMechanism.meta
with new classSentryMechanismMeta
. MovedSenryNSError
toSentryMechanismMeta
.
- feat: Async callstacks are being tracked by wrapping the
dispatch_async
and related APIs. #998 - feat: Add transaction to the scope #992
- fix: Pass SentryTracer to span child #1040
- feat: Add span to SentrySDK #1042
- feat: Add urlSessionDelegate option to SentryOptions #965
- ref: Align SentryException with unified API #1026: Replaced
SentryException.thread
withSentryException.threadId
andSentryException.stacktrace
. - ref: Remove deprecated SentryHub.getScope #1025: Use
SentryHub.scope
instead. - ref: Make closeCachedSessionWithTimestamp private #1022
- ref: Improve envelope API for Hybrid SDKs #1020: We removed
SentryClient.storeEnvelope
, which is reserved for Hybrid SDKs. - ref: Remove currentHub from SentrySDK #1019: We removed
SentrySDK.currentHub
andSentrySDK.setCurrentHub
. In case you need this methods, please open up an issue. - feat: Add maxCacheItems #1017: This changes the maximum number of cached envelopes from 100 to 30. You can configure this number with
SentryOptions.maxCacheItems
.
- perf: Avoid allocating dict in BreadcrumbTracker #1027
- feat: Add start and endSession to SentrySDK #1021
- fix: Crash when passing garbage to maxBreadcrumbs #1018
- fix: OutOfMemory exception type #1015
- fix: macOS version for Mac Catalyst #1011
- feat: Out Of Memory Tracking #1001
- feat: Performance Monitoring API (#909, #977, #961, #932, #919)
- SentryEvent.timestamp changed to nullable.
Features and fixes:
- ref: Add read-only scope property to Hub #975
- ref: Add read-only scope property to Hub #975
- ref: Remove SentryException.userReported #974
- ref: Replace SentryLogLevel with SentryLevel #978
Breaking Change: This version introduces a change to the grouping of issues. The SDK now sets the inApp
flag for frames originating from only the main executable using CFBundleExecutable.
In previous versions, all frames originating from the application bundle were marked as inApp
. This had the
downside of marking frames of private frameworks inside the bundle as inApp
. This problem is fixed now.
Applications using static frameworks shouldn't be affected by this change.
For more information on marking frames as inApp docs.
- fix: Mark frames as inApp #956
- fix: Redundant x29 GP register on arm64 and UBSan crash #964
With this version, Sentry groups errors by domain and code. MyDomain 1 and MyDomain 2 are going to be two separate issues in Sentry. If you are using self-hosted Sentry, it requires Sentry version >= v21.2.0 to work. Staying on Sentry < v21.2.0 and upgrading to this version of the SDK won't do any damage. Sentry will group like in previous versions, but you will see a new group because we slightly changed the wording. If you are using sentry.io no action is needed. In case you are not satisfied with this change, you can take a look at SDK fingerprinting to group by domain only.
- fix: Use mechanism meta for error grouping #946
- fix: Sanitize SentryMechanism.data on serialize #947
- feat: Add error to SentryEvent #944
- fix: Mark SentryEvent.message as Nullable #943
- fix: Stacktrace inApp marking on Simulators #942
- feat: Group NSError by domain and code #941
- fix: Discard Sessions when JSON is faulty #939
- feat: Add sendDefaultPii to SentryOptions #923
- fix: Sessions for Hybrid SDKs #913
- fix: Capture envelope updates session state #906
- fix: Clash with KSCrash functions #905
- fix: Duplicate symbol clash with KSCrash #902
- perf: Improve locks in SentryScope #888
- fix: Change maxAttachmentSize from MiB to bytes #891
- feat: Add maxAttachmentSize to SentryOptions #887
- ref: Remove SentryAttachment.isEqual and hash #885
- ref: Remove SentryScope.isEqual and hash #884
- feat: Add basic support for attachments #875
- fix: Crash in SentrySession.serialize #870
- perf: Drop global dispatch queue (#869)
- fix: Increase precision of iso8601 date formatter #860
- feat: Add onCrashedLastRun #808
- feat: Add SentrySdkInfo to SentryOptions #859
- fix: Serialization of SentryScope #841
- fix: Recrash parsing in SentryCrash #850
- fix: Not crash during crash reporting #849
- feat: Add storeEnvelope on SentryClient #836
- perf: Async synching of scope on to SentryCrash #832
- fix: Drop Sessions without release name #826
- feat: Bring back SentryOptions.enabled #818
- fix: Remove enum specifier for SentryLevel #822
- feat: Send environment 'production' if nothing was set #825
- fix: Typo for Swift name: UserFeedback #829
- fix: Call beforeBreadcrumb for Breadcrumb Tracker #815
- fix: Add eventId to user feedback envelope header #809
- feat: Manually capturing User Feedback #804
- fix: Sanitize UserInfo of NSError and NSException #770
- fix: Xcode 12 warnings for Cocoapods #791
- fix: Making SentrySdkInfo Public #788
- fix: iOS 13.4 Runtime Crash #786
- fix: Using wrong SDK name #782
- feat: Expose
captureEnvelope
on the client #784 - fix: Remove initWithJSON from SentryEvent #781
- fix: Carthage for Xcode 12 #780
- fix: Add missing SentrySdkInfo.h to umbrella header #779
- ref: Remove event.json field #768
- fix: Warning Duplicate build file in Copy Headers #761
- fix: Warning when integrating SDK via Carthage #760
- feat: Set installationId to userId if no user is set #757
This is a major bump with lots of internal improvements and a few breaking changes. For a detailed explanation how to updgrade please checkout the migration guide.
Breaking changes:
- fix: Make SentryMessage formatted required #756
- feat: Add SentryMessage #752
- feat: Replace passing nullable Scope with overloads #743
- feat: Remove SentryOptions.enabled #736
- fix: Public Headers #735
- feat: Attach stacktraces to all events by default #705
- feat: Replace NSNumber with BOOL in SentryOptions #719
- feat: Enable auto session tracking per default #689
- feat: Remove deprecated SDK inits #673
- feat: Bump minimum iOS version to 9.0 #669
- fix: Umbrella header #671
- feat: Replace NSString for eventId with SentryId #668
- feat: Use envelopes for sending events #650
Features and fixes:
- fix: Make public isEqual _Nullable #751
- feat: Use error domain and code for event message #750
- feat: Remove SDK frames when attaching stacktrace #739
- fix: captureException crates a event type=error #746
- fix: Setting environment for Sessions #734
- feat: Crash event and session in same envelope #731
- feat: Allow nil in setExtraValue on SentryScope to remove key #703
- fix: Header Imports for the Swift Package Manager #721
- fix: Async storing of envelope to disk #714
- feat: Migrate session init for stored envelopes #693
- fix: Remove redundant sdk options enable check in SentryHttpTransport #698
- fix: Sending envelopes multiple times #687
- fix: Rate limiting for cached envelope items #685
- feat: Errors and sessions in the same envelope #686
- feat: Implement NSCopying for SentrySession #683
- fix: Crash when SentryClient is nil in SentryHub #681
- feat: Send cached envelopes first #676
Breaking changes:
- feat: Remove SentryOptions.enabled #736
- fix: Public Headers #735
Fix:
- fix: Setting environment for Sessions #734
This release also enables by default the option attackStacktrace
which includes
the stacktrace in all events, including captureMessage
by default.
Breaking Changes:
- feat: Attach stacktraces to all events by default #705
Features and fixes:
- feat: Crash event and session in same envelope #731
- feat: Allow nil in setExtraValue on SentryScope to remove key #703
Breaking changes:
- feat: Replace NSNumber with BOOL in SentryOptions #719
Features and fixes:
- fix: Header Imports for the Swift Package Manager #721
- fix: Async storing of envelope to disk #714
- feat: Migrate session init for stored envelopes #693
- fix: Remove redundant sdk options enable check in SentryHttpTransport #698
Breaking Change: This version uses the envelope endpoint.
If you are using an on-premise installation it requires Sentry version
>= v20.6.0
to work. If you are using sentry.io nothing will change and
no action is needed. Furthermore, with this version
auto session tracking
is enabled per default.
This feature
is collecting and sending health data about the usage of your
application.
We are going to add the official migration guide in one of the next beta releases.
Here is an overview of all the breaking changes:
- feat: Enable auto session tracking per default #689
- feat: Remove deprecated SDK inits #673
- feat: Bump minimum iOS version to 9.0 #669
- fix: Umbrella header #671
- feat: Replace NSString for eventId with SentryId #668
- feat: Use envelopes for sending events #650
Other new features and fixes:
- fix: Sending envelopes multiple times #687
- fix: Rate limiting for cached envelope items #685
- feat: Errors and sessions in the same envelope #686
- feat: Implement NSCopying for SentrySession #683
- fix: Crash when SentryClient is nil in SentryHub #681
- feat: Send cached envelopes first #676
- feat: Add crashedLastRun to SentrySDK #688
- fix: Add IP address to user serialization #665
- fix: Crash in SentryEnvelope.initWithEvent #643
- fix: Build failure for Apple Silicon Macs #588
- feat: capture userinfo from NSError and NSException #679
- fix: nxgetlocalarch app store #651
- fix: Crash when converting Recrash Report #627
- feat: Add SdkInfo to Envelope Header #626
- fix: Deserialize envelope with header and item #620
- fix: Set LogLevel in startWithConfigureOptions #613
- fix: Abnormal sessions #607
- fix: beforeSend callback in SentryClient #608
- fix: Cocoapods build
- fix: Overwriting stack trace for crashes #605
- fix: Deployment target warning for Swift Package Manager for Xcode 12 #586
- feat: Simplified SDK start #580
- fix: Custom release name for crash reports #590
- feat: Attach the stacktrace to custom events #583
- fix: SentryCrashJSON encodeObject crash #576
- feat: Added automatic breadcrumbs for system events #559
- fix: Increase max report length #569
- fix: Remove weak ref file contents #571
- fix: UUID for SentryCrashReport is null #566
- feat: Attach stacktrace of current thread to events #561
- fix: Prefix categories methods with sentry #555
- feat: Attach DebugMeta to Events #545
- fix: Duplicate symbol for SentryMeta #549
- feat: Set SUPPORTS_MACCATALYST to YES explicitly #547
- fix: Make properties of Session readonly #541
- fix: Remove MemoryWarningIntegration #537
- fix: Avoid Implicit conversion in SentrySession #540
- fix: Change SentryScope setTagValue to NSString #524
- feat: Add remove methods for SentryScope #529
- fix: Failing MacOS build #530
- ref: Session values are unsigned #527
- fix: End file at the right place with #ifdef #521
- fix: Exit session with timestamp #518
- feat: Add sentry_sanitize for NSArray #509
- fix: Keep maximum rate limit #498
- fix: Ignore unknown rate limit categories #497
- fix: On app exit, close session as healthy #500
- fix: Flakey concurrent test for RateLimits #493
- fix: missing breadcrumbs data on hardcrash #492
- GA of major version 5
- feat: Add support for mac catalyst #479
- fix: RateLimitCategories #482
- fix: RetryAfter treated like all categories #481
- feat: RateLimiting for cached events and envelopes #480
- fix: EnvelopeRateLimit init envelope with header #478
- feat: RateLimit for non cached Envelopes #476
- fix: Use RateLimitCategoryError for events #470
- feat: Store SentryEnvelopes in extra path #468
- feat: Adds setUser to SentrySDK and SentryHub #467
- feat: Add auto session starting for macOS #463
- fix: Take release name from options #462
- feat: Use new envelope endpoint #475
- feat: App lifecycle events as breadcrumbs #474
- feat: RateLimit for sendAllStoredEvents #458
- fix: Use maxBreadcrumbs from options #451
- fix: Send vmaddr if available for apple crash reports #459
- fix: Limit number of breadcrumbs #450
- feat: Add Sentry initialization function 'start' #441
- fix: Crashed sessions are marked as such #448
- fix: Persisting Scope with CrashReport
- fix: Frame in app detection #438
- fix: Session ending as Crashed #439
- fix: The order of how integrations are initialized (fixes not sending crashes on startup)
- fix: Add missing header files to umbrella header
- feat: Added Session Feature
- feat: New option
enableAutoSessionTracking
set totrue
if you want sessions to be enabled - feat: Add
_crashOnException:
to handle exceptions for AppKit apps on macOS
- feat: Added internal
captureEnvelope
method
BREAKING: This is the first public release of our new 5.0.0
#339 version of the SDK.
The majority of the public API of the SDK changed, now it's more streamlined with other Sentry SDKs and prepared for future updates.
Please read the migration guide how to use the new SDK MIGRATION.MD
- fix: Mac Catalyst detection
- fix: Add null checks in crash reporter
- fix: Check type of key before use it as NSString (#383)
- fix: Use rawKey to get object from dictionary (#392)
- fix: Change instantiating SentryMechanism of unknown exception type (#385)
- feat: Swift Package Manager support #352
- fix: travis lane lint #345
- feat: Prefer snprintf over sprintf #342
- feat: Add support for custom context and event types
- feat: Helper property on event to send raw payload
- fix: #305
- fix: 64 int conversion #296
- fix: Extracting reason of NSException
- fix: [SentryThread serialize] will crash when threadId is nil #292
- ref: Make
event_id
all lowercase - feat: Emit log error in case no shared client is set and crash handler was started
- ref: Renamed
Container+DeepSearch
toContainer+SentryDeepSearch
- ref: Renamed
NSData+Compression
toNSData+SentryCompression
- ref: Renamed
NSDate+Extras
toNSDate+SentryExtras
- ref: Renamed
NSDictionary+Sanitize
toNSDictionary+SentrySanitize
- feat: Added
initWithOptions
function, it takes an Dictionary of key value. Possible values aredsn
,enabled
,environment
,release
,dist
- feat: Added
enabled
on theClient
- feat: Added
environment
on theClient
- feat: Added
release
on theClient
- feat: Added
dist
on theClient
- ref: Renamed
NSError+SimpleConstructor.h
toNSError+SentrySimpleConstructor.h
- fix: Add environment to Event in JavaScriptHelper
- feat: Add
Client.shared?.trackMemoryPressureAsEvent()
to emit an event if application receives memory pressure notification - feat:
Client.shared?.enableAutomaticBreadcrumbTracking()
now adds a breadcrumb in case of memory pressure notification
- Fix: WatchOS build
- fix(react-native): Correctly label fingerprints for JS bridge. (#279)
- Fix error for empty array creation (#278)
- Fix NSInvalidArgumentException in SentryBreadcrumbStore (#272)
- Add fingerprint support to JavaScript bridge
- Fix internal variable naming conflict with KSCrash
- Introduce
maxEvents
maxBreadcrumbs
to increase the max count of offline stored assets
- Fixes CocoaPods build to include C++ as a library #252
- Moved KSCrash into Codebase while renaming it to SentryCrash.
Removed KSCrash dep in Podspec.
Still if you do not call
startCrashHandlerWithError
crash handlers will not be installed.
This should be safe to upgrade from 3.x.x, there are no code changes what so ever. If you are using CocoaPods or Carthage an update should take care of everything, if you were using the source code directly, make sure to remove KSCrash if you were using it.
We recommend updating if you experience any KSCrash related crashes since we fixed bunch of stuff directly in our codebase now.
- Updated KSCrash project to SKIP_INSTALL
- Update docs to use public DSN
- Don't emit nslog if loglevel is none
- Send new mechanism
- Add transaction of current uiviewcontroller
- Fixed a bug for empty timestamp if created from JavaScript
- Fixed #239
- Synchronize storing of breadcrumbs and events
- Fixed and error in javascript helper for new exception structure
- Fixed #235
- Fixed #236
- Fixed #231
- Greatly improved handling for rate limiting see: #230
- Added
shouldQueueEvent
- There is a hardlimit for offline stored events of 10 and 200 for breadcrumbs
- This update will create a subfolder for each instance of SentryClient depending on the DSN. This also fixes a bug where under rare circumstances on MacOS for not sandboxed apps got sent with the wrong SentryClient. We recommend updating to this version if you are running a un-sandboxed macOS app
- Fixes #216
- Fixed #213
- Added JavaScriptBridgeHelper for react-native, cordova SDK
- Send breadcrumbs in the order in which they got created
- Tick allow-app-extension-API-only box for Carthage builds
- Fixed an issue where a crash and the actual event diverge in release version/ dist #218
- Fixed #217
- Fixed #214
- Fixed failing test
- Make KSCrash default CocoaPod subspec
- macOS: Call super exception handler when crash happens
- Added
sampleRate
parameter to configure the likelihood of sending an event [0.0-1.0]
- Fixes a bug where stack trace is nil when snapshotting stacktrace
- Bump KSCrash to
1.15.12
- Add
SentryCrashExceptionApplication
for macOS uncaught exception handling
- Add
storeEvent
function, mainly used forreact-native
- Fixed a bug in crash Thread detection which caused the Sentry web interface to sometimes show the wrong culprit
- Fixed getsentry#200 Make userId optional of
SentryUser
- Fixed getsentry#198
- Initialize extra and tags in private instead of setter in Client init
- Fixed #196
Fixed messed up Travis build.
Expose sdk
property for SentryEvent
to allow users to set specific SDK information. -> mainly used in react-native
Remove stripping of __sentry extra because it breaks if the event is serialized more than once.
Fix integrations
for sdk
context.
Pretty print json request when verbose logging is active.
Change the way extra
tags
and user
is stored.
- Fixed #190
- Fixed #191
- Add
appendStacktraceToEvent
function in addition tosnapshotStacktrace
to add stacktraces reliably.
- Bump KSCrash to
1.15.11
- Add support for SDK integrations
- Prefix internal category function
- Added new callback
shouldSendEvent
to make it possible to prevent the event from being sent. - Fixes #178
- Fix
snapshotStacktrace
to also includedebug_meta
to fix grouping
- Sanitize all extra's array before serialization (Convert NSDate -> NSString)
- Change internal locking mechanism for swizzling
- Use
KSCrash
1.15.9
Core
subspec which only uses bare minimum for Crash reporting - Fixes #174
- Fix system name
- Fix
NSNumber
properties in DebugMeta
- Rename
RSSwizzle
toSentrySwizzle
- Fix empty frames on specific crash
- Fix carthage builds
Bundled KSCrash into Sentry. Note that this is just for Carthage, CocoaPods knows how to link 2 dynamic frameworks together.
- Fix Sentry dynamic framework
- Fix carthage build
This release is a rewrite of the existing codebase, sentry-cocoa
now uses Objective-C instead of Swift.
Please make sure to check out the docs since this update introduced many breaking changes.
https://docs.sentry.io/clients/cocoa/
KSCrash
is now optional, you can use Sentry without it, we still recommend using KSCrash by default otherwise Sentry will not catch any crashes.
- Fix swift 3 async operation -> Operation never got removed from queue due using private vars instead of setter
- Fixed release naming to
bundleIdentifier
-shortVersion
- Add support for distributions in sentry
- Make
eventID
var
instead oflet
- Update KSCrash
-
Fix duplicate symbols in crash report
1884.42s user 368.70s system 171% cpu 21:55.70 total
- Add additional Info about device
("app_identifier", bundleID)
("app_name", bundleName)
("app_build", bundleVersion)
("app_version", bundleShortVersion)
- Only switflint in Xcode builds, do not while building with CARTHAGE
- No longer automatically clear breadcrumbs when an event is sent
- Set
ALWAYS_EMBED_SWIFT_STANDARD_LIBRARIES
back toNO
since it prevents upload to iTunes Connect
- Prefix react-native frames with
app://
- Update swiftlint to whitelist rules
- Add app context
- Added
addTag
addExtra
function toSentryClient
andEvent
e.g.:
SentryClient.shared?.addExtra("key", value: "value")
event.addTag("key", value: "value")
- Fixed a bug where 64bit uInt got converted to 32bit
- Added compatiblity for incomplete Crashreports from KSCrash
- Added internal support for upcoming react-native support
- Exposed
maxCrumbs
so the maximum amount of breadcrumbs can be adjusted
- Fixed a bug with not sending
release
with event - Changed the way how swizzling works, there should not be a problem with e.g.: New Relic anymore
-
We decided to rename
SentrySwift
to justSentry
Version
2.0.0
has the same features as1.4.5
. The name of the Framework has been changed from:import SentrySwift
toimport Sentry
Also in thePodfile
you have to change topod Sentry
instead ofpod SentrySwift
. Everything else stayed the same.
- Now sending
registers
with stacktrace for better symbolication results - Added
verbose
logging option which outputs raw events and crash reports - Add
relevant_address
to stacktrace - Extended
mechanism
- Add
build
torelease
e.g.:1.0 (1337)
- Added
objcBeforeSendEventBlock
as equivalent to swiftsbeforeSendEventBlock
- Removed
SentryClient.shared?.enableThreadNames
because KSCrash changed the mechanism on how threadnames are fetched. They will show up in sentry if available. - Now sending build number with every event.
- Fixed an issue where properties of an event will be overwritten before sending
- Added
SentryClient.shared?.enableThreadNames
variable which can be set to true in order to retrieve the thread names when a crash happens. Enable this on you own risk this could deadlock you app therefore its not yet officially documented.
- Fixed Xcode 7 support
- enable
searchThreadNames
to display thread names in sentry
- Update KSCrash to 1.13.x
Warning
- Added namespace for Objc
e.g.:
User
->SentryUser
but Xcode should suggest the new class names ... Swift code does not change
- Store events now in
Library/Caches
instead ofDocuments
folder
- Add
RequestManager
for improved handling on many requests
- Reuse
URLSession
when sending events - Optimize
BreadcrumbStore
- Default log level
.Error
- Don't strip filepath from frames
- Add
reportReactNativeFatalCrash
- Moved
docs/
to this repo - You can now take a snapshot of the stacktrace and send it with your event ... see https://docs.sentry.io/clients/cocoa/advanced/#adding-stacktrace-to-message for more information
- Added
beforeSendEventBlock
to change a event before sending it https://docs.sentry.io/clients/cocoa/advanced/#change-event-before-sending-it
- Reverse frames in stacktrace
- Remove in_app from stacktrace
- Added
SentryClient.shared?.enableAutomaticBreadcrumbTracking()
for iOS which sends all actions and viewDidAppear as breadcrumbs to the server - Fixed podspec for all target
- Improved UserFeedback controller
- Updated KSCrash to 1.11.2
- Refactored a lot of internal classes
- Added
UserFeedback
feature to iOS - Added basic support for watchOS
- Remove appleCrashReport from request
- Add mechanism to request
- Switch version/build to make iOS version in sentry more understandable
- Use
diagnosis
from KSCrash for crash reasons
Fixed for breadcrumbs not always sending on fatal
- Support for Swift 2.3 and Swift 3.0
- Fixes issue in where capturing
NSError
was not sending up to API
- Release was not getting sent up on crashes
- Contexts was getting sent up on wrong key
- Defaulting release to main bundle version
- Added support for crashing reporting for Mac apps
- Requests are now gzip before going off to Sentry API
- Fixed breadcrumbs for updated spec
- Removed all references of "raven"
- Fixed #13
- Changed merging behaviour in EventProperties
- Event takes priority over client
- Added tvOS support
- Fixes with KSCrash that will build KSCrash for all platforms
First pre-release that is ready for testers