Mindscape.Raygun4Net.AspNetCore
11.0.4-pre-2
See the version list below for details.
dotnet add package Mindscape.Raygun4Net.AspNetCore --version 11.0.4-pre-2
NuGet\Install-Package Mindscape.Raygun4Net.AspNetCore -Version 11.0.4-pre-2
<PackageReference Include="Mindscape.Raygun4Net.AspNetCore" Version="11.0.4-pre-2" />
paket add Mindscape.Raygun4Net.AspNetCore --version 11.0.4-pre-2
#r "nuget: Mindscape.Raygun4Net.AspNetCore, 11.0.4-pre-2"
// Install Mindscape.Raygun4Net.AspNetCore as a Cake Addin #addin nuget:?package=Mindscape.Raygun4Net.AspNetCore&version=11.0.4-pre-2&prerelease // Install Mindscape.Raygun4Net.AspNetCore as a Cake Tool #tool nuget:?package=Mindscape.Raygun4Net.AspNetCore&version=11.0.4-pre-2&prerelease
Raygun4Net.AspNetCore - Raygun Provider for ASP.NET Core projects
Where is my app API key?
When you create a new application on your Raygun dashboard, your app API key is displayed at the top of the instructions page. You can also find the API key by clicking the "Application Settings" button in the side bar of the Raygun dashboard.
Namespace
The main classes can be found in the Mindscape.Raygun4Net namespace.
Setup & Usage
In your ASP.NET Core project, add the Raygun4Net.AspNetCore package to your project:
dotnet add package Mindscape.Raygun4Net.AspNetCore
Add Raygun to your services:
public void ConfigureServices(IServiceCollection services)
{
// Assumes you're configuring Raygun in appsettings.json
services.AddRaygun(Configuration);
// Or if you're configuring Raygun in code
services.AddRaygun(settings =>
{
settings.ApiKey = "YOUR_APP_API_KEY";
...
});
}
Add Raygun to your middleware:
public void Configure(IApplicationBuilder app, IHostingEnvironment env)
{
// This should be registered early in the pipeline to catch all exceptions
app.UseRaygun();
}
If you're configuring using appsettings.json, add the following to your appsettings.json file:
{
"RaygunSettings": {
"ApiKey": "YOUR_APP_API_KEY"
}
}
Manually sending exceptions
After using services.AddRaygun(...)
, you can inject RaygunClient
into your controllers and use it to send exceptions manually.
public class MyController : Controller
{
private readonly RaygunClient _raygunClient;
public MyController(RaygunClient raygunClient)
{
_raygunClient = raygunClient;
}
public async Task<IActionResult> TestManualError()
{
try
{
throw new Exception("Test from .NET Core MVC app");
}
catch (Exception ex)
{
await _raygunClient.SendInBackground(ex);
}
return View();
}
}
Custom User Provider
By default, Raygun4Net ships with a DefaultRaygunUserProvider
which will attempt to get the user information from
the HttpContext.User
object. This is Opt-In which can be added by calling services.AddRaygunUserProvider()
If you want to provide your own implementation of the IRaygunUserProvider
you
can do so by creating a class that implements the interface and then adding it to the services during configuration
using services.AddRaygunUserProvider<MyCustomUserProvider>()
.
public class ExampleUserProvider : IRaygunUserProvider
{
private readonly IHttpContextAccessor _contextAccessor;
public ExampleUserProvider(IHttpContextAccessor httpContextAccessor)
{
_contextAccessor = contextAccessor;
}
public RaygunIdentifierMessage? GetUser()
{
var ctx = _contextAccessor.HttpContext;
if (ctx == null)
{
return null;
}
var identity = ctx.User.Identity as ClaimsIdentity;
if (identity?.IsAuthenticated == true)
{
return new RaygunIdentifierMessage(identity.Name)
{
IsAnonymous = false
};
return null;
}
}
This can be registered in the services during configuration like so:
services.AddRaygunUserProvider<ExampleUserProvider>();
Make sure to abide by any privacy policies that your company follows when using this feature.
Additional configuration options and features
The following features can be configured in the appsettings.json file or in code.
For example, in the appsettings.json file:
{
"RaygunSettings": {
"ApiKey": "YOUR_APP_API_KEY",
"ExcludeErrorsFromLocal": true
}
}
The equivalent in code:
services.AddRaygun(settings =>
{
settings.ApiKey = "YOUR_APP_API_KEY";
settings.ExcludeErrorsFromLocal = true;
});
Examples below are shown in appsettings.json format.
Replace unseekable request streams
Raygun will try to send the raw request payload with each exception report where applicable, but this is only possible with request streams that are seekable. If you are not seeing any raw request payloads in your exception reports where you'd expect to see them, then you can set the ReplaceUnseekableRequestStreams setting to true in your appsettings.json. This will attempt to replace any unseekable streams with a seekable copy on the request object so that Raygun can later read the raw request payload.
"RaygunSettings": {
"ApiKey": "YOUR_APP_API_KEY",
"ReplaceUnseekableRequestStreams": true
}
This setting is false by default to avoid breaking changes or any unforseen issues with its initial deployment.
Raygun will not attempt to send raw request payloads for GET requests, "x-www-form-urlencoded" requests or "text/html" requests.
Exclude errors by HTTP status code
You can exclude errors by their HTTP status code by providing an array of status codes to ignore in the configuration. For example if you wanted to exclude errors that return the "I'm a teapot" response code (http://tools.ietf.org/html/rfc2324), you could use the configuration below.
"RaygunSettings": {
"ApiKey": "YOUR_APP_API_KEY",
"ExcludedStatusCodes": [418]
}
Exclude errors that originate from a local origin
Toggle this boolean and Raygun will not send errors if the request originated from a local origin. i.e. A way to prevent local debug/development from notifying Raygun without having to resort to Web.config transforms.
"RaygunSettings": {
"ApiKey": "YOUR_APP_API_KEY",
"ExcludeErrorsFromLocal": true
}
Modify or cancel message
On a RaygunClient instance, attach an event handler to the SendingMessage event. This event handler will be called just before the RaygunClient sends an exception - either automatically or manually. The event arguments provide the RaygunMessage object that is about to be sent. One use for this event handler is to add or modify any information on the RaygunMessage. Another use for this method is to identify exceptions that you never want to send to raygun, and if so, set e.Cancel = true to cancel the send.
Strip wrapper exceptions
If you have common outer exceptions that wrap a valuable inner exception which you'd prefer to group by, you can specify these by using the multi-parameter method:
_raygunClient.AddWrapperExceptions(typeof(TargetInvocationException));
In this case, if a TargetInvocationException occurs, it will be removed and replaced with the actual InnerException that was the cause. Note that TargetInvocationException is already added to the wrapper exception list; you do not have to add this manually. This method is useful if you have your own custom wrapper exceptions, or a framework is throwing exceptions using its own wrapper.
Version numbering
By default, Raygun4Net will attempt to set ApplicationVersion
from the entry assembly. It is possible to override this by providing a version through RaygunSettings
:
"RaygunSettings": {
"ApplicationVersion": "1.0.0.0"
}
Or
services.AddRaygun(settings =>
{
settings.ApplicationVersion = "1.0.0.0";
});
Tags and custom data
When sending exceptions manually, you can also send an arbitrary list of tags (an array of strings), and a collection of custom data (a dictionary of any objects). This can be done using the various SendAsync and SendInBackground method overloads.
Example:
await _raygunClient.SendAsync(ex, new List<string> { "Tag1", "Tag2" }, new Dictionary<string, string> { { "customKey", "value" } });
Remove sensitive request data
If you have sensitive data in an HTTP request that you wish to prevent being transmitted to Raygun, you can provide lists of possible keys (names) to remove.
Keys to ignore can be specified on the RaygunSettings
in appsettings.json
, or on the RaygunSettings
when you create the RaygunClient
or call services.AddRaygun(settings => {...});
The available options are:
IgnoreSensitiveFieldNames
IgnoreQueryParameterNames
IgnoreFormFieldNames
IgnoreHeaderNames
IgnoreCookieNames
IgnoreServerVariableNames
These can be set to an array of keys to ignore. Setting an option as *
will indicate that all the keys will not be sent to Raygun.
Placing *
before, after or at both ends of a key will perform an ends-with, starts-with or contains operation respectively.
For example, IgnoreFormFieldNames: ["*password*"]
will cause Raygun to ignore all form fields that contain "password" anywhere in the name.
These options are not case sensitive.
Note: The IgnoreSensitiveFieldNames
will be applied to ALL fields in the RaygunRequestMessage
.
We provide extra options for removing sensitive data from the request raw data. This comes in the form of filters as implemented by the IRaygunDataFilter
interface.
These filters read the raw data and strip values whose keys match those found in the RaygunSettings.IgnoreSensitiveFieldNames
property.
We currently provide two implementations with this provider:
- RaygunKeyValuePairDataFilter e.g. filtering "user=raygun&password=pewpew"
- RaygunXmlDataFilter e.g. filtering "<password>pewpew</password>"
These filters are initially disabled and can be enbled through the RaygunSettings
class.
services.AddRaygun(settings =>
{
settings.UseXmlRawDataFilter = true;
settings.UseKeyValuePairRawDataFilter = true;
settings.IsRawDataIgnoredWhenFilteringFailed = true;
settings.RawDataFilters.Add(new RaygunJsonDataFilter()); // Example below
});
You may also provide your own implementation of the IRaygunDataFilter
and pass this to the RaygunClient
to use when filtering raw data.
Example JSON Data Filter
using System;
using System.Linq;
using System.Collections.Generic;
using Newtonsoft.Json;
using Newtonsoft.Json.Linq;
using Mindscape.Raygun4Net.Filters;
public class RaygunJsonDataFilter : IRaygunDataFilter
{
private const string FILTERED_VALUE = "[FILTERED]";
public bool CanParse(string data)
{
if (!string.IsNullOrEmpty(data))
{
int index = data.TakeWhile(c => char.IsWhiteSpace(c)).Count();
if (index < data.Length)
{
if (data.ElementAt(index).Equals('{'))
{
return true;
}
}
}
return false;
}
public string Filter(string data, IList<string> ignoredKeys)
{
try
{
JObject jObject = JObject.Parse(data);
FilterTokensRecursive(jObject.Children(), ignoredKeys);
return jObject.ToString(Formatting.None, null);
}
catch
{
return null;
}
}
private void FilterTokensRecursive(IEnumerable<JToken> tokens, IList<string> ignoredKeys)
{
foreach (JToken token in tokens)
{
if (token is JProperty)
{
var property = token as JProperty;
if (ShouldIgnore(property, ignoredKeys))
{
property.Value = FILTERED_VALUE;
}
else if (property.Value.Type == JTokenType.Object)
{
FilterTokensRecursive(property.Value.Children(), ignoredKeys);
}
}
}
}
private bool ShouldIgnore(JProperty property, IList<string> ignoredKeys)
{
bool hasValue = property.Value.Type != JTokenType.Null;
if (property.Value.Type == JTokenType.String)
{
hasValue = !string.IsNullOrEmpty(property.Value.ToString());
}
return hasValue && !string.IsNullOrEmpty(property.Name) && ignoredKeys.Any(f => f.Equals(property.Name, StringComparison.OrdinalIgnoreCase));
}
}
Product | Versions Compatible and additional computed target framework versions. |
---|---|
.NET | net5.0 was computed. net5.0-windows was computed. net6.0 is compatible. net6.0-android was computed. net6.0-ios was computed. net6.0-maccatalyst was computed. net6.0-macos was computed. net6.0-tvos was computed. net6.0-windows was computed. net7.0 was computed. net7.0-android was computed. net7.0-ios was computed. net7.0-maccatalyst was computed. net7.0-macos was computed. net7.0-tvos was computed. net7.0-windows was computed. net8.0 was computed. net8.0-android was computed. net8.0-browser was computed. net8.0-ios was computed. net8.0-maccatalyst was computed. net8.0-macos was computed. net8.0-tvos was computed. net8.0-windows was computed. |
.NET Core | netcoreapp2.0 was computed. netcoreapp2.1 was computed. netcoreapp2.2 was computed. netcoreapp3.0 was computed. netcoreapp3.1 was computed. |
.NET Standard | netstandard2.0 is compatible. netstandard2.1 is compatible. |
.NET Framework | net461 was computed. net462 was computed. net463 was computed. net47 was computed. net471 was computed. net472 was computed. net48 was computed. net481 was computed. |
MonoAndroid | monoandroid was computed. |
MonoMac | monomac was computed. |
MonoTouch | monotouch was computed. |
Tizen | tizen40 was computed. tizen60 was computed. |
Xamarin.iOS | xamarinios was computed. |
Xamarin.Mac | xamarinmac was computed. |
Xamarin.TVOS | xamarintvos was computed. |
Xamarin.WatchOS | xamarinwatchos was computed. |
-
.NETStandard 2.0
- Microsoft.AspNetCore.Http (>= 2.2.2)
- Microsoft.AspNetCore.Http.Extensions (>= 2.2.0)
- Microsoft.Extensions.Logging.Abstractions (>= 6.0.0)
- Microsoft.Extensions.Options.ConfigurationExtensions (>= 1.1.2)
- Mindscape.Raygun4Net.NetCore.Common (>= 11.0.4-pre-2)
-
.NETStandard 2.1
- Microsoft.AspNetCore.Http (>= 2.2.2)
- Microsoft.AspNetCore.Http.Extensions (>= 2.2.0)
- Microsoft.Extensions.Logging.Abstractions (>= 6.0.0)
- Microsoft.Extensions.Options.ConfigurationExtensions (>= 1.1.2)
- Mindscape.Raygun4Net.NetCore.Common (>= 11.0.4-pre-2)
-
net6.0
- Mindscape.Raygun4Net.NetCore.Common (>= 11.0.4-pre-2)
NuGet packages (7)
Showing the top 5 NuGet packages that depend on Mindscape.Raygun4Net.AspNetCore:
Package | Downloads |
---|---|
Hochfrequenz.sharedAzureHelper
Helper classes to interact with Hochfrequenzes azure services |
|
NLog.Raygun
A custom NLog target that will push exceptions to Raygun |
|
LoggingAbstractor.Raygun
Logging Abstractor is a library for .NET that allows you to swap out logging providers with ease. |
|
Serilog.Sinks.Raygun.AspNetCore
A Serilog sink that writes events to Raygun using the MindscapeHQ AspNetCore library |
|
Xamariners.Functions.Core
Xamariners.Functions.Core is a library of common classes and helpers for Azure functions. |
GitHub repositories
This package is not used by any popular GitHub repositories.
Version | Downloads | Last updated | |
---|---|---|---|
11.2.1 | 2,044 | 12/11/2024 | |
11.2.0 | 483 | 12/10/2024 | |
11.2.0-pre-1 | 91 | 12/8/2024 | |
11.1.2 | 16,384 | 11/12/2024 | |
11.1.2-pre-2 | 80 | 11/12/2024 | |
11.1.2-pre-1 | 285 | 9/17/2024 | |
11.1.1 | 45,597 | 9/12/2024 | |
11.1.0 | 12,916 | 8/25/2024 | |
11.0.4-pre-5 | 123 | 8/23/2024 | |
11.0.4-pre-4 | 118 | 8/22/2024 | |
11.0.4-pre-2 | 139 | 8/15/2024 | |
11.0.4-pre-1 | 125 | 8/13/2024 | |
11.0.3 | 24,527 | 7/25/2024 | |
11.0.3-pre-1 | 112 | 7/22/2024 | |
11.0.2 | 24,461 | 6/20/2024 | |
11.0.0 | 7,219 | 6/9/2024 | |
11.0.0-rc1 | 124 | 6/7/2024 | |
11.0.0-pre3 | 103 | 5/30/2024 | |
11.0.0-pre2 | 122 | 5/24/2024 | |
11.0.0-pre1 | 118 | 5/23/2024 | |
10.1.2 | 18,787 | 5/9/2024 | |
10.1.2-pre-1 | 134 | 5/9/2024 | |
10.1.1 | 28,115 | 3/27/2024 | |
10.1.1-pre-1 | 149 | 3/20/2024 | |
10.1.0 | 2,890 | 3/18/2024 | |
10.1.0-pre-2 | 134 | 3/18/2024 | |
10.1.0-pre-1 | 154 | 3/15/2024 | |
10.0.0 | 2,070 | 3/13/2024 | |
10.0.0-pre-6 | 145 | 3/12/2024 | |
10.0.0-pre-5 | 147 | 3/12/2024 | |
10.0.0-pre-4 | 4,764 | 2/23/2024 | |
10.0.0-pre-2 | 189 | 2/23/2024 | |
10.0.0-pre-1 | 199 | 2/22/2024 | |
9.0.4 | 27,053 | 3/3/2024 | |
9.0.4-pre-1 | 2,747 | 2/29/2024 | |
9.0.3 | 15,285 | 2/27/2024 | |
9.0.2 | 7,503 | 2/22/2024 | |
9.0.2-pre-1 | 183 | 2/19/2024 | |
9.0.1 | 8,045 | 2/8/2024 | |
9.0.0-pre3 | 224 | 2/7/2024 | |
9.0.0-pre-1 | 187 | 2/2/2024 | |
8.3.0-pre1 | 4,743 | 1/26/2024 | |
8.1.0-pre3 | 199 | 1/9/2024 | |
8.0.1 | 29,173 | 11/28/2023 | |
8.0.1-pre-1 | 222 | 11/27/2023 | |
8.0.0 | 8,278 | 11/14/2023 | |
8.0.0-pre-1 | 279 | 11/9/2023 | |
7.1.0 | 20,255 | 10/9/2023 | |
7.1.0-pre-1 | 222 | 9/22/2023 | |
7.0.0 | 37,889 | 9/12/2023 | |
6.7.2 | 47,795 | 9/6/2023 | |
6.7.1 | 1,039 | 9/6/2023 | |
6.7.0-pre2 | 209 | 8/21/2023 | |
6.6.6 | 893,246 | 4/8/2022 | |
6.6.5 | 300,435 | 3/2/2022 | |
6.6.4 | 2,955 | 2/28/2022 | |
6.6.3 | 2,464 | 2/23/2022 | |
6.6.2 | 685,019 | 9/2/2021 | |
6.6.1 | 3,038 | 8/30/2021 | |
6.6.0 | 580 | 8/30/2021 | |
6.5.0 | 222,781 | 4/15/2021 | |
6.4.1 | 140,826 | 12/2/2020 | |
6.4.0 | 901,840 | 10/1/2020 | |
6.3.1 | 112,040 | 8/17/2020 | |
6.3.0 | 97,036 | 6/30/2020 | |
6.2.1-beta1 | 2,143 | 2/13/2020 | |
6.2.0 | 868,557 | 10/9/2019 | |
6.1.0 | 547,613 | 4/11/2019 | |
6.0.1 | 359,919 | 10/4/2018 | |
6.0.0 | 383,075 | 5/28/2018 | |
5.5.0 | 928,728 | 5/16/2017 | |
5.3.2 | 40,546 | 8/23/2016 | |
5.3.1 | 2,846 | 7/22/2016 |