From e84c524cc8a85bce8b181275712f15a1a9992c4f Mon Sep 17 00:00:00 2001 From: Sean Date: Thu, 6 Jun 2024 09:16:02 +1200 Subject: [PATCH 1/4] v11.0 Changelog --- CHANGE-LOG.md | 13 +++++++++++++ 1 file changed, 13 insertions(+) diff --git a/CHANGE-LOG.md b/CHANGE-LOG.md index c0dba517..5e770b0e 100644 --- a/CHANGE-LOG.md +++ b/CHANGE-LOG.md @@ -1,5 +1,18 @@ # Full Change Log for Raygun4Net.* packages +### v11.0.0 +- Add support for PDB Debug Information in stack traces + - This enables Raygun to leverage Portable PDB's to symbolicate .NET stack traces when PDB's are not included in the build output + - This introduces a dependency on `System.Reflection.Metadata@6.0.1` for `netstandard` + - See: https://github.com/MindscapeHQ/raygun4net/pull/528 +- Add support for storing crash reports offline + - There is a new `OfflineStore` property on `RaygunSettings`, when this is set, it will enable the offline storage + - Crashes are stored offline when there was a connectivity issue, or the Raygun remote server return a 5xx response + - By default, there is a maximum of 50 offline crashes stored + - See: https://github.com/MindscapeHQ/raygun4net/pull/530 +- Removed marking an unhandled exception in Android as handled, preventing app crash + - See: https://github.com/MindscapeHQ/raygun4net/pull/531 + ### v10.1.2 - Fix issue where uncaught exceptions could sometimes not be reported to Raygun - See: https://github.com/MindscapeHQ/raygun4net/pull/529 From 5368589de59c4312f545e3145d16eb42f8b20777 Mon Sep 17 00:00:00 2001 From: Sean Date: Thu, 6 Jun 2024 10:07:39 +1200 Subject: [PATCH 2/4] Add info around the timer --- CHANGE-LOG.md | 1 + 1 file changed, 1 insertion(+) diff --git a/CHANGE-LOG.md b/CHANGE-LOG.md index 5e770b0e..a0a67431 100644 --- a/CHANGE-LOG.md +++ b/CHANGE-LOG.md @@ -8,6 +8,7 @@ - Add support for storing crash reports offline - There is a new `OfflineStore` property on `RaygunSettings`, when this is set, it will enable the offline storage - Crashes are stored offline when there was a connectivity issue, or the Raygun remote server return a 5xx response + - There is a `IBackgroundSendStrategy`, which controls when to attempt to resend offline crash reports. It defaults to every 30 seconds - By default, there is a maximum of 50 offline crashes stored - See: https://github.com/MindscapeHQ/raygun4net/pull/530 - Removed marking an unhandled exception in Android as handled, preventing app crash From 857a6d0e44049cb2af7b50d19d9fe4e135901ba4 Mon Sep 17 00:00:00 2001 From: Sean Date: Fri, 7 Jun 2024 14:42:19 +1200 Subject: [PATCH 3/4] Add offline storage docs installation readme --- Mindscape.Raygun4Net.NetCore/README.md | 29 ++++++++++++++++++++++++++ 1 file changed, 29 insertions(+) diff --git a/Mindscape.Raygun4Net.NetCore/README.md b/Mindscape.Raygun4Net.NetCore/README.md index f0bb339e..bfda15b7 100644 --- a/Mindscape.Raygun4Net.NetCore/README.md +++ b/Mindscape.Raygun4Net.NetCore/README.md @@ -99,6 +99,35 @@ Version numbering You can provide an application version value by setting the ApplicationVersion property of the RaygunClient (in the format x.x.x.x where x is a positive integer). +Offline storage +----------------- + +You can optionally specify an Offline Store for crash reports when creating your `RaygunClient`. + +When an offline store is specified, if there are any issues sending an exception to the Raygun API, a copy of the exception may be stored locally to be retried at a later date. + +An exception is stored offline when one of the following conditions are met: +- There was a network connectivity issue, e.g. no active internet connection on a mobile device +- The Raygun API responded with an HTTP 5xx, indicating an unexpected server error + +```csharp +// Attempt to send any offline crash reports every 30 seconds +var sendStrategy = new TimerBasedSendStrategy(TimeSpan.FromSeconds(30)); + +// Store crash reports in Local AppData +var offlineStore = new LocalApplicationDataCrashReportStore(sendStrategy); + +var raygunClient = new RaygunClient(new RaygunSettings() +{ + ApiKey = "paste_your_api_key_here", + + // Optionally store + OfflineStore = offlineStore +}); +``` + +You may extend and create your own custom implementations of `OfflineStoreBase` and `IBackgroundSendStrategy` to further customize where errors are stored, and when they are sent. + Tags and custom data -------------------- From a06b529a83c1eee91489ca51b6257515e91e374d Mon Sep 17 00:00:00 2001 From: Sean Date: Fri, 7 Jun 2024 15:25:06 +1200 Subject: [PATCH 4/4] Fix my english --- CHANGE-LOG.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/CHANGE-LOG.md b/CHANGE-LOG.md index a0a67431..935e40b7 100644 --- a/CHANGE-LOG.md +++ b/CHANGE-LOG.md @@ -2,16 +2,16 @@ ### v11.0.0 - Add support for PDB Debug Information in stack traces - - This enables Raygun to leverage Portable PDB's to symbolicate .NET stack traces when PDB's are not included in the build output + - This enables Raygun to leverage Portable PDBs to symbolicate .NET stack traces when PDBs are not included in the build output - This introduces a dependency on `System.Reflection.Metadata@6.0.1` for `netstandard` - See: https://github.com/MindscapeHQ/raygun4net/pull/528 - Add support for storing crash reports offline - There is a new `OfflineStore` property on `RaygunSettings`, when this is set, it will enable the offline storage - - Crashes are stored offline when there was a connectivity issue, or the Raygun remote server return a 5xx response + - Crashes are stored offline when there is a connectivity issue, or when the Raygun remote server returns a 5xx response - There is a `IBackgroundSendStrategy`, which controls when to attempt to resend offline crash reports. It defaults to every 30 seconds - By default, there is a maximum of 50 offline crashes stored - See: https://github.com/MindscapeHQ/raygun4net/pull/530 -- Removed marking an unhandled exception in Android as handled, preventing app crash +- Removed marking an unhandled exception in Android as handled, preventing the app from crashing - See: https://github.com/MindscapeHQ/raygun4net/pull/531 ### v10.1.2